@realsee/dnalogel 0.1.7 → 2.0.0-alpha.1

package/libs/floorplan/TopviewFloorplanPlugin/style.js

@@ -0,0 +1,8 @@
+export const pluginStyle = {
+    position: 'absolute',
+    left: '50%',
+    top: '50%',
+    transform: 'translate(-50%, -50%)',
+    pointerEvents: 'none',
+    zIndex: '10',
+};

package/{plugins → libs}/floorplan/typings/floorplanData.d.ts

@@ -3,6 +3,7 @@
  * 1. 数据的下划线到驼峰的转换
  * 2. svg url 到 svg content 的处理
  */
+import type { RecordKeys, RecordValue } from './utility';
 /** 户型图坐标，坐标原点时户型图中心点，单位是户型图单位 */
 export interface FloorplanPosition {
     x: number;
@@ -77,11 +78,16 @@ export interface FloorplanRoomItem {
     /** 当前房间里的 observer 索引 */
     observerIndexs: number[];
 }
+/** 户型图标尺 */
+export declare type FloorplanRuleLabels = Record<'top' | 'right' | 'bottom' | 'left', FloorplanPosition[][]>;
+export declare type RuleLabelsKey = RecordKeys<FloorplanRuleLabels>;
+export declare type RuleLabelsValue = RecordValue<FloorplanRuleLabels>;
 /** 当前楼层的数据 */
 export interface FloorplanFloorData {
     floorName: string;
     floorIndex: number;
     rooms: FloorplanRoomItem[];
+    rules: FloorplanRuleLabels;
 }
 /** 对 observer 做一些样式上的计算
  * @description 每一个 floorplanObserver 对应一个 observer

package/libs/floorplan/typings/floorplanData.js

@@ -0,0 +1,6 @@
+/**
+ * @file 对输入到户型图相关插件内的数据做 format 之后的数据
+ * 1. 数据的下划线到驼峰的转换
+ * 2. svg url 到 svg content 的处理
+ */
+export {};

package/{plugins → libs}/floorplan/typings/floorplanServerData.d.ts

@@ -1,5 +1,5 @@
 /** 房屋数据映射表 */
-export declare const ROOM_DETILE_TYPE_MAP: ({
+export declare const ROOM_FETILE_TYPE_MAP: ({
     type: number;
     floorType: number;
     roomType: string;
@@ -36,7 +36,7 @@ export interface FloorplanServerImagePosition {
 export interface FloorplanServerOutlineItem {
     url: string;
     index: number;
-    checksum: string;
+    checksum?: string;
     svg_url?: string;
 }
 /** 户型图入户门 */
@@ -96,11 +96,13 @@ export interface FloorplanServerRoomItem {
     /** 当前房间里的 observer 索引 */
     observer_indexs: number[];
 }
+export declare type FloorplanServerRuleLabels = Record<'top' | 'right' | 'bottom' | 'left', FloorplanServerPosition[][]>;
 /** 当前楼层的数据 */
 export interface FloorplanServerFloorData {
     floor_name: string;
     floor_index: number;
     rooms: FloorplanServerRoomItem[];
+    rules: FloorplanServerRuleLabels;
 }
 /** 对 observer 做一些样式上的计算
  * @description 每一个 FloorplanServer_observer 对应一个 observer

package/libs/floorplan/typings/floorplanServerData.js

@@ -0,0 +1,101 @@
+/** 房屋数据映射表 */
+export const ROOM_FETILE_TYPE_MAP = [
+    { type: 0, floorType: 1, roomType: '100900000012', name: '其他' },
+    { type: 1, floorType: 1, roomType: '100900000002', name: '客厅' },
+    { type: 2, floorType: 1, roomType: '100900000002', name: '餐厅' },
+    { type: 3, floorType: 0, roomType: '100900000001', name: '卧室' },
+    { type: 4, floorType: 0, roomType: '100900000001', name: '书房' },
+    { type: 5, floorType: 3, roomType: '100900000004', name: '卫生间' },
+    { type: 6, floorType: 3, roomType: '100900000004', name: '淋浴间' },
+    { type: 7, floorType: 3, roomType: '100900000004', name: '洗手间' },
+    { type: 8, floorType: 3, roomType: '100900000003', name: '厨房' },
+    {
+        type: 9,
+        floorType: 1,
+        roomType: '100900000003',
+        name: '开放厨房',
+        onlySubArea: true,
+    },
+    { type: 10, floorType: 0, roomType: '100900000001', name: '多功能间' },
+    { type: 11, floorType: 0, roomType: '100900000009', name: '保姆间' },
+    { type: 12, floorType: 4, roomType: '100900000005', name: '阳台' },
+    { type: 13, floorType: 4, roomType: '100900000006', name: '露台' },
+    { type: 14, floorType: 0, roomType: '100900000008', name: '储物间' },
+    { type: 15, floorType: 0, roomType: '100900000013', name: '衣帽间' },
+    { type: 16, floorType: 0, roomType: '100900000011', name: '阁楼' },
+    { type: 17, floorType: 2, roomType: '100900000007', name: '花园' },
+    { type: 18, floorType: 5, roomType: '100900000010', name: '车库' },
+    { type: 19, floorType: 1, roomType: '100900000012', name: '电梯' },
+    { type: 20, floorType: 1, roomType: '100900000012', name: '地下室' },
+    { type: 21, floorType: 1, roomType: '100900000012', name: '天井' },
+    { type: 22, floorType: 1, roomType: '100900000012', name: '阳光房' },
+    { type: 23, floorType: 1, roomType: '100900000012', name: '过道' },
+    { type: 24, floorType: 1, roomType: '100900000012', name: '楼梯间' },
+    { type: 25, floorType: 1, roomType: '100900000012', name: '门厅' },
+    { type: 26, floorType: 2, roomType: '100900000012', name: '入户花园' },
+    { type: 27, floorType: 1, roomType: '100900000012', name: '玄关' },
+    { type: 28, floorType: 1, roomType: '100900000012', name: '挑空' },
+    { type: 29, floorType: 4, roomType: '100900000012', name: '晾晒区' },
+    { type: 30, floorType: 4, roomType: '100900000012', name: '洗衣房' },
+    { type: 31, floorType: 0, roomType: '100900000012', name: '娱乐区' },
+    { type: 32, floorType: 0, roomType: '100900000012', name: '健身区' },
+    { type: 33, floorType: 0, roomType: '100900000012', name: '接待区' },
+    { type: 34, floorType: 0, roomType: '100900000012', name: '影音区' },
+    { type: 35, floorType: 1, roomType: '100900000012', name: '餐饮区' },
+    {
+        type: 36,
+        floorType: 1,
+        roomType: '100900000012',
+        name: '其他',
+        onlySubArea: true,
+    },
+    { type: 37, floorType: 1, roomType: '100900000002', name: '起居室' },
+    { type: 38, floorType: 0, roomType: '100900000001', name: '主卧' },
+    { type: 39, floorType: 0, roomType: '100900000001', name: '次卧' },
+    { type: 40, floorType: 0, roomType: '100900000001', name: '优化间' },
+    { type: 41, floorType: 0, roomType: '100900000001', name: '办公室' },
+    { type: 42, floorType: 0, roomType: '100900000001', name: '会议室' },
+    { type: 43, floorType: 0, roomType: '100900000001', name: '洽谈间' },
+    { type: 44, floorType: 1, roomType: '100900000002', name: '共享大厅' },
+    { type: 45, floorType: 1, roomType: '100900000012', name: '水吧' },
+    { type: 46, floorType: 0, roomType: '100900000015', name: '出入口' },
+    { type: 47, floorType: 0, roomType: '100900000015', name: '大厅' },
+    { type: 48, floorType: 0, roomType: '100900000015', name: '包厢' },
+    { type: 49, floorType: 0, roomType: '100900000015', name: '其他' },
+    { type: 50, floorType: 0, roomType: '100900000016', name: '出入口' },
+    { type: 51, floorType: 0, roomType: '100900000016', name: '办公区' },
+    { type: 52, floorType: 0, roomType: '100900000016', name: '老板间' },
+    { type: 53, floorType: 0, roomType: '100900000016', name: '会议室' },
+    { type: 54, floorType: 0, roomType: '100900000016', name: '休息区/水吧' },
+    { type: 55, floorType: 0, roomType: '100900000016', name: '其他' },
+    { type: 56, floorType: 2, roomType: '100900000012', name: '空中花园' },
+    { type: 57, floorType: 0, roomType: '100900000001', name: '洋室' },
+    { type: 58, floorType: 0, roomType: '100900000001', name: '和室' },
+];
+/** 地板信息映射表 */
+export const FLOOR_TYPE_MAP = [
+    { type: 0, description: '木质地板' },
+    { type: 1, description: '瓷砖地面' },
+    { type: 2, description: '户外地面' },
+    { type: 3, description: '卫生间地面' },
+    { type: 4, description: '阳台地面' },
+    { type: 5, description: '车库地面' },
+];
+/** 房屋类型映射表 */
+export const ROOM_TYPE_MAP = [
+    { roomType: '100900000001', description: '室' },
+    { roomType: '100900000002', description: '厅' },
+    { roomType: '100900000003', description: '厨' },
+    { roomType: '100900000004', description: '卫' },
+    { roomType: '100900000005', description: '阳台' },
+    { roomType: '100900000006', description: '露台' },
+    { roomType: '100900000007', description: '花园' },
+    { roomType: '100900000008', description: '储' },
+    { roomType: '100900000009', description: '保姆间' },
+    { roomType: '100900000010', description: '车库' },
+    { roomType: '100900000011', description: '阁楼' },
+    { roomType: '100900000012', description: '其他' },
+    { roomType: '100900000013', description: '衣' },
+    { roomType: '100900000015', description: '商铺' },
+    { roomType: '100900000016', description: '写字楼' },
+];

package/libs/floorplan/typings/utility.d.ts

@@ -0,0 +1,2 @@
+export declare type RecordKeys<T> = T extends Record<infer P, any> ? P : any;
+export declare type RecordValue<T> = T extends Record<any, infer P> ? P : any;

package/libs/floorplan/typings/utility.js

@@ -0,0 +1 @@
+export {};

package/{plugins → libs}/floorplan/utils/formatData.d.ts

@@ -1,5 +1,5 @@
-import { Five } from '@realsee/five';
-import { FloorplanData, FloorplanExtraObject, FloorplanExtraObject3D } from '../typings/floorplanData';
-import { FloorplanServerData } from '../typings/floorplanServerData';
+import type { Five } from '@realsee/five';
+import type { FloorplanData, FloorplanExtraObject, FloorplanExtraObject3D } from '../typings/floorplanData';
+import type { FloorplanServerData } from '../typings/floorplanServerData';
 export default function formatData(data: FloorplanServerData): Promise<FloorplanData>;
 export declare function formatExtraObjects(data: FloorplanExtraObject3D[], five: Five, floorplanData: FloorplanData): FloorplanExtraObject[];

package/libs/floorplan/utils/formatData.js

@@ -0,0 +1,94 @@
+import { FLOORPLAN_EXTRA_OBJECT_IMAGE } from '../Assets/floorplanExtraObject';
+import { floorplanPosition2ImagePosition, getFloorIndexFromModelPosition, modelPosition2FloorplanPosition, } from './formatPosition';
+async function formatOutlines(outlines) {
+    const headers = new Headers({ 'Content-Type': 'text/plain' });
+    const getOutlineItem = async function (item) {
+        const outlineItem = {
+            index: item.index,
+            url: item.url,
+            svgUrl: item.svg_url,
+        };
+        if (item.svg_url) {
+            const svgContent = await fetch(item.svg_url, { headers }).then((res) => res.text());
+            outlineItem.svgContent = svgContent;
+        }
+        return outlineItem;
+    };
+    const svgOutlineItems = await Promise.all(outlines.map(getOutlineItem));
+    return svgOutlineItems;
+}
+function formatRoom(data) {
+    const floorplanRoomItem = {
+        id: data.id,
+        size: data.size,
+        name: data.name,
+        path: data.path,
+        roomType: data.room_type,
+        floorType: data.floor_type,
+        roomLabel: {
+            position: data.room_label.position,
+            positionInImage: data.room_label.position_in_image,
+        },
+        observerIndexs: data.observer_indexs,
+    };
+    return floorplanRoomItem;
+}
+function formatFloorData(_data) {
+    return {
+        floorName: _data.floor_name,
+        floorIndex: _data.floor_index,
+        rooms: _data.rooms.map(formatRoom),
+        rules: _data.rules,
+    };
+}
+function formateFloorplanObserver(data) {
+    const floorplanObserver = {
+        index: data.index,
+        floorIndex: data.floor_index,
+        position: data.position,
+        positionInImage: data.position_in_image,
+    };
+    return floorplanObserver;
+}
+function formatFloorplanEntrance(data) {
+    const floorplanEntrance = {
+        rad: data.rad,
+        position: data.position,
+        positionInImage: data.position_in_image,
+        northRad: data.north_rad,
+        roomId: data.room_id,
+        floorIndex: data.floor_index,
+    };
+    return floorplanEntrance;
+}
+export default async function formatData(data) {
+    const outlines = await formatOutlines(data.outlines);
+    const bounding = data.computed_data.bounding;
+    const floorDatas = data.computed_data.floor_datas.map(formatFloorData);
+    const entrance = data.computed_data.entrance ? formatFloorplanEntrance(data.computed_data.entrance) : null;
+    const floorplanData = {
+        outlines,
+        entrance,
+        bounding,
+        floorDatas,
+        observers: data.computed_data.observers.map(formateFloorplanObserver),
+    };
+    return floorplanData;
+}
+export function formatExtraObjects(data, five, floorplanData) {
+    const extraObjects = data.map((object) => {
+        const position = object.position;
+        const icon = object.icon
+            ? object.icon
+            : {
+                url: FLOORPLAN_EXTRA_OBJECT_IMAGE,
+                width: 45,
+                height: 48,
+            };
+        const floorIndex = getFloorIndexFromModelPosition(position, five);
+        const floorplanPosition = modelPosition2FloorplanPosition(position, floorplanData);
+        const floorplanImagePosition = floorplanPosition2ImagePosition(floorplanPosition, floorplanData);
+        return { floorIndex, icon, id: object.id, position: floorplanPosition, positionInImage: floorplanImagePosition };
+    });
+    return extraObjects;
+}

package/{plugins → libs}/floorplan/utils/formatPosition.d.ts

@@ -1,7 +1,6 @@
-import { Five } from '@realsee/five';
-import { Vector2Position } from '../../../typings/math.type';
-import { FloorplanData } from '../typings/floorplanData';
-import { FloorplanBounding } from '../typings/floorplanData';
+import type { Five } from '@realsee/five';
+import type { Vector2Position } from '../../typings/math.type';
+import type { FloorplanData, FloorplanBounding } from '../typings/floorplanData';
 export declare function pathD(points: Vector2Position[], options?: {
     needZ?: boolean;
     needA?: Record<number, string>;

package/libs/floorplan/utils/formatPosition.js

@@ -0,0 +1,50 @@
+export function pathD(points, options = {}) {
+    let d = '';
+    const { needZ, needA } = options;
+    const _points = needZ ? points.slice().concat(points[0]) : points.slice();
+    _points.forEach((_point, index) => {
+        const { x, y } = options.format ? options.format(_point) : _point;
+        const point = x + ',' + y;
+        if (index === 0) {
+            d += 'M' + point;
+            return d;
+        }
+        if (needA?.[index]) {
+            d += 'A' + needA[index] + ',' + point;
+            return d;
+        }
+        d += 'L' + point;
+        return d;
+    });
+    return d + (needZ ? 'Z' : '');
+}
+/** 把户型图上点点位转换到 SVG 上的点位 */
+export default function formatFloorplanPoint({ x, y }, pxmm, bounding) {
+    const { max, min } = bounding;
+    return { x: (x - min.x) * pxmm, y: (max.y - y) * pxmm };
+}
+/** 模型坐标转户型图坐标 */
+export function modelPosition2FloorplanPosition(position, floorplanData) {
+    const x = position.x * 1000 + floorplanData.bounding.origin.x;
+    const y = -position.z * 1000 + floorplanData.bounding.origin.y;
+    return { x, y };
+}
+/** 户型图点位转在图片上的相对坐标 */
+export function floorplanPosition2ImagePosition(position, floorplanData) {
+    const bounding = floorplanData.bounding;
+    const boundingWidth = bounding.max.x - bounding.min.x;
+    const boundingHeight = bounding.max.y - bounding.min.y;
+    return {
+        x: (position.x - bounding.min.x) / boundingWidth,
+        y: (bounding.max.y - position.y) / boundingHeight,
+    };
+}
+/** 求三维坐标点所在的楼层 */
+export function getFloorIndexFromModelPosition(position, five) {
+    const floorIndex = Math.max(...five.work.observers.map((observer) => {
+        if (position.z >= observer.standingPosition.z)
+            return observer.floorIndex;
+        return 0;
+    }));
+    return floorIndex;
+}

package/libs/index.d.ts

@@ -0,0 +1,17 @@
+export { default as ModelViewPlugin } from "./ModelViewPlugin";
+export { default as CSS3DRenderPlugin } from "./CSS3DRenderPlugin";
+export type { PanoCursorRaycasterPluginExportType } from './PanoCursorRaycasterPlugin';
+export { default as PanoCursorRaycasterPlugin } from "./PanoCursorRaycasterPlugin";
+export type { ModelRoomLabelController, ModelRoomLabelPluginData, RoomLabel, ModelRoomLabelPluginReturnType, ModelRoomLabelPluginParameters } from './ModelRoomLabelPlugin';
+export { default as ModelRoomLabelPlugin } from './ModelRoomLabelPlugin';
+export type { TopviewFloorplanPluginReturnType, TopviewFloorplanPluginParameterType } from './floorplan/TopviewFloorplanPlugin';
+export { default as TopviewFloorplanPlugin } from './floorplan/TopviewFloorplanPlugin';
+export type { PanoFloorplanRadarPluginReturnType, PanoFloorplanRadarPluginParameterType } from './floorplan/PanoFloorplanRadarPlugin';
+export { default as PanoFloorplanRadarPlugin } from './floorplan/PanoFloorplanRadarPlugin';
+export type { ModelFloorplanParameterType, ModelFloorplanPluginReturnType, ModelFloorplanErrorType, ModelFloorplanPluginsConfigs, ModelFloorplanEventHandlers, ModelFloorplanViewEvent } from './floorplan/ModelFloorplanPlugin';
+export { default as ModelFloorplanPlugin } from './floorplan/ModelFloorplanPlugin';
+export type { ModelChassisCompassPluginParameterType, ModelChassisCompassPluginData, ModelChassisCompassPluginExportType } from './ModelChassisCompassPlugin';
+export { default as ModelChassisCompassPlugin } from './ModelChassisCompassPlugin';
+export type { ModelEntryDoorGuidePluginParameterType, ModelEntryDoorGuidePluginData, ModelEntryDoorGuidePluginExportType } from './ModelEntryDoorGuidePlugin';
+export { default as ModelEntryDoorGuidePlugin } from './ModelEntryDoorGuidePlugin';
+export { default as CameraMovementPlugin } from './CameraMovementPlugin';

package/libs/index.js

@@ -0,0 +1,10 @@
+export { default as ModelViewPlugin } from "./ModelViewPlugin";
+export { default as CSS3DRenderPlugin } from "./CSS3DRenderPlugin";
+export { default as PanoCursorRaycasterPlugin } from "./PanoCursorRaycasterPlugin";
+export { default as ModelRoomLabelPlugin } from './ModelRoomLabelPlugin';
+export { default as TopviewFloorplanPlugin } from './floorplan/TopviewFloorplanPlugin';
+export { default as PanoFloorplanRadarPlugin } from './floorplan/PanoFloorplanRadarPlugin';
+export { default as ModelFloorplanPlugin } from './floorplan/ModelFloorplanPlugin';
+export { default as ModelChassisCompassPlugin } from './ModelChassisCompassPlugin';
+export { default as ModelEntryDoorGuidePlugin } from './ModelEntryDoorGuidePlugin';
+export { default as CameraMovementPlugin } from './CameraMovementPlugin';

package/libs/shared-utils/Preloader.js

@@ -0,0 +1,38 @@
+/**
+ * 预载器
+ */
+export const Preloader = {
+    blob: (url) => {
+        const noop = () => null;
+        return new Promise((resolve, reject) => {
+            const xhr = new XMLHttpRequest();
+            const clear = () => {
+                xhr.ontimeout = noop;
+                xhr.onreadystatechange = noop;
+                xhr.onprogress = noop;
+                xhr.onabort = noop;
+            };
+            xhr.ontimeout = () => {
+                reject(new Error('timeout'));
+                clear();
+            };
+            xhr.onreadystatechange = () => {
+                if (xhr.readyState !== 4)
+                    return;
+                if (xhr.status === 0 && !xhr.response)
+                    return;
+                if (xhr.status === 200 || xhr.status === 0) {
+                    resolve(xhr.response);
+                    clear();
+                }
+                else {
+                    reject(new Error('status:' + xhr.status));
+                    clear();
+                }
+            };
+            xhr.open('GET', url, true);
+            xhr.responseType = 'blob';
+            xhr.send(null);
+        });
+    },
+};

package/{shared-utils → libs/shared-utils}/Subscribe.d.ts

@@ -18,14 +18,14 @@ export default class Subscribe {
      * @param  {any}              context  事件回调函数调用的上下文
      * @param  {boolean}          once     是否只执行一次
      */
-    on(names: string | string[], callback: (...args: any[]) => void, context?: any, once?: boolean): () => this | undefined;
+    on(names: string | string[], callback: (...args: any[]) => void, context?: any, once?: boolean): () => this;
     /**
      * 注册事件(是否只执行一次)
      * @param  {string|[string]}  names    事件类型
      * @param  {function}         callback 事件回调函数
      * @param  {any}              context  事件回调函数调用的上下文
      */
-    once(names: string | string[], callback: (...args: any[]) => void, context?: any): () => this | undefined;
+    once(names: string | string[], callback: (...args: any[]) => void, context?: any): () => this;
     /**
      * 解除事件
      * @param  {string|[string]}  names    事件类型
@@ -34,7 +34,7 @@ export default class Subscribe {
      * 如果 name 不传的话解除对应所有事件
      * 如果 name, callback 不传的话解除所有name的所有事件
      */
-    off(names?: string | string[], callback?: (...args: any[]) => void): this | undefined;
+    off(names?: string | string[], callback?: (...args: any[]) => void): this;
     /**
      * 触发事件
      * @param  {string|[string]}    name      事件类型

package/libs/shared-utils/Subscribe.js

@@ -0,0 +1,101 @@
+/* eslint-disable  @typescript-eslint/no-explicit-any */
+const __EVENT__ = '__events__';
+/**
+ * 订阅类。
+ * 观察者模式（供前端使用），Node端推荐<a href="https://nodejs.org/api/events.html#events_class_eventemitter">EventEmitter</a>。
+ */
+export default class Subscribe {
+    [__EVENT__];
+    constructor() {
+        this[__EVENT__] = {};
+    }
+    /**
+     * 判断是否注册时事件
+     * @param  {string|[string]}  name     事件类型
+     */
+    hasListener(name) {
+        const events = this[__EVENT__];
+        return events && events[name] && events[name].length;
+    }
+    /**
+     * 注册事件
+     * @param  {string|[string]}  names    事件类型
+     * @param  {function}         callback 事件回调函数
+     * @param  {any}              context  事件回调函数调用的上下文
+     * @param  {boolean}          once     是否只执行一次
+     */
+    on(names, callback, context, once = false) {
+        for (const name of [].concat(names)) {
+            if (!this[__EVENT__][name])
+                this[__EVENT__][name] = [];
+            this[__EVENT__][name].push([callback, context, once]);
+        }
+        return () => this.off(names, callback);
+    }
+    /**
+     * 注册事件(是否只执行一次)
+     * @param  {string|[string]}  names    事件类型
+     * @param  {function}         callback 事件回调函数
+     * @param  {any}              context  事件回调函数调用的上下文
+     */
+    once(names, callback, context) {
+        return this.on(names, callback, context, true);
+    }
+    /**
+     * 解除事件
+     * @param  {string|[string]}  names    事件类型
+     * @param  {function}         callback 事件回调函数
+     *
+     * 如果 name 不传的话解除对应所有事件
+     * 如果 name, callback 不传的话解除所有name的所有事件
+     */
+    off(names, callback) {
+        if (arguments.length === 0) {
+            this[__EVENT__] = {};
+            return;
+        }
+        const hasNames = (names) => names;
+        if (hasNames(names)) {
+            const events = this[__EVENT__];
+            for (const name of [].concat(names)) {
+                if (events[name] === undefined)
+                    continue;
+                if (callback === undefined) {
+                    events[name].length = 0;
+                    continue;
+                }
+                events[name] = events[name].filter((one) => one[0] !== callback);
+            }
+        }
+        return this;
+    }
+    /**
+     * 触发事件
+     * @param  {string|[string]}    name      事件类型
+     * @param  {...any}             data      触发事件的数据
+     */
+    emit(name, ...data) {
+        let canceled = false;
+        const event = this[__EVENT__][name] || [];
+        if (event.length === 0) {
+            console.warn(` 💀 "${name}" ⟶ Unregistered event. `);
+        }
+        for (const one of event) {
+            try {
+                const [callback, context = this, once = false] = one;
+                const result = callback.apply(context, data);
+                if (once)
+                    this.off(name, callback);
+                if (result === false) {
+                    // 如果回调的返回结果是false，则中断后续的调用链
+                    canceled = true;
+                    return canceled;
+                }
+            }
+            catch (error) {
+                console.warn(error);
+            }
+        }
+        return canceled;
+    }
+}

package/libs/shared-utils/animationFrame/BetterTween.js

@@ -0,0 +1,30 @@
+import TWEEN from '@tweenjs/tween.js';
+import { requestAnimationFrameInterval } from './index';
+export class BetterTween extends TWEEN.Tween {
+    disposeMethods = [];
+    animationFrameDisposer;
+    onDispose = (callback) => {
+        this.disposeMethods.push(callback);
+        return this;
+    };
+    play = () => {
+        this.start(0);
+        this.animationFrameDisposer = requestAnimationFrameInterval((time) => this.update(time));
+        return this;
+    };
+    dispose = () => {
+        this.stop();
+        this.animationFrameDisposer?.();
+        this.disposeMethods.forEach((fn) => fn());
+        this.disposeMethods = [];
+        TWEEN.remove(this);
+    };
+}
+export function tweenProgress(duration, easing = TWEEN.Easing.Linear.None) {
+    const tween = new BetterTween({ progress: 0 }).to({ progress: 1 });
+    if (duration !== undefined)
+        tween.duration(duration);
+    if (easing !== undefined)
+        tween.easing(easing);
+    return tween;
+}

package/libs/shared-utils/animationFrame/calculateProgress.js

@@ -0,0 +1,23 @@
+import { formatRad } from './formatRad';
+const PI = Math.PI;
+const PI_2 = PI * 2;
+/**
+ * 线性过程插值
+ */
+export function progressNumber(from, to, pst) {
+    return from + (to - from) * pst;
+}
+/**
+ * 弧度过程插值值,会取锐角进行插值
+ */
+export function progressRad(from, to, pst) {
+    from = formatRad(from);
+    to = formatRad(to);
+    if (to - from > PI) {
+        return formatRad(progressNumber(from + PI_2, to, pst));
+    }
+    if (from - to > PI) {
+        return formatRad(progressNumber(from - PI_2, to, pst));
+    }
+    return progressNumber(from, to, pst);
+}

package/libs/shared-utils/animationFrame/formatRad.js

@@ -0,0 +1,20 @@
+const PI_2 = Math.PI * 2;
+/**
+ * 把一个任意角度的弧度值转换为一个 [0, 2PI] 的弧度值
+ * @param rad 弧度值
+ */
+export function formatLongitude(rad) {
+    return ((rad % PI_2) + PI_2) % PI_2;
+}
+/**
+ * 把一个任意角度的弧度值转换为一个 [-2PI, 2PI] 的弧度值
+ * @param rad 弧度值
+ */
+export function formatLatitude(rad) {
+    return rad % PI_2;
+}
+/**
+ * 把一个任意角度的弧度值转换为一个 [0, 2PI] 的弧度值
+ * @param rad 弧度值
+ */
+export const formatRad = formatLongitude;