@realsee/dnalogel 2.1.0-alpha.13 → 2.1.0-alpha.15

package/libs/src/PanoTagPlugin/typings/tag.d.ts

@@ -0,0 +1,237 @@
+import type { Five } from '@realsee/five';
+import type { Create3DDomContainerParamsType } from '../../CSS3DRenderPlugin/Controller';
+export type { PartialDeep } from 'type-fest';
+export declare type TagId = string | number;
+export declare type ArrayPosition = [number, number, number];
+export declare type Position = ArrayPosition;
+declare type Object = Record<string | number | symbol, any>;
+/** 返回一个销毁函数 */
+declare type ElementRenderer = (container: HTMLElement) => () => void;
+interface MinMax {
+    min?: number;
+    max?: number;
+}
+export declare enum DimensionType {
+    Two = "2D",
+    Three = "3D"
+}
+export declare enum PointType {
+    PointTag = "PointTag",
+    PlaneTag = "PlaneTag"
+}
+export declare enum ContentType {
+    /** 音频标签 */
+    Audio = "Audio",
+    /** 文本标签 */
+    Text = "Text",
+    /** 图文标签 */
+    ImageText = "ImageText",
+    /** VR跳转标签 */
+    Link = "Link",
+    /** 营销标签 */
+    Marketing = "Marketing",
+    /** 图片视频贴片 */
+    MediaPlane = "MediaPlane",
+    /** 其他/自定义标签 */
+    Custom = "Custom"
+}
+export interface Tags {
+    version?: string;
+    /** tag配置 > 按type配置 > 全局配置 */
+    /** 全局配置 */
+    globalConfig?: TagConfig;
+    /** 按type配置 */
+    contentTypeConfig?: Partial<Record<ContentTypeConfigKey, TagConfig>>;
+    tagList: Tag[];
+}
+export declare type ContentTypeConfigKeyArray = [DimensionType | 'Any', ContentType | 'Any', PointType | 'Any'];
+export declare type ContentTypeConfigKey = `${ContentTypeConfigKeyArray[0]}-${ContentTypeConfigKeyArray[1]}-${ContentTypeConfigKeyArray[2]}`;
+export declare type Tag<C extends ContentType = any, P extends PointType = any, D extends DimensionType = any, CustomDataType extends Object = {}> = {
+    /** 开启/禁用 */
+    enabled?: boolean;
+    /** 唯一标识 */
+    id: TagId;
+    /** 一个点的标签/4个点的标签 */
+    pointType: P;
+    /** 2维/3维类型 */
+    dimensionType: D;
+    /** 内容类型，根据内容类型展示对应UI */
+    contentType: C;
+    /** 点 */
+    position: P extends PointType.PointTag ? Position : P extends PointType.PlaneTag ? [Position, Position, Position, Position] : any;
+    /** 自定义标签内容 */
+    element?: string | Element | ElementRenderer;
+    /** 标签数据 */
+    data: C extends ContentType.Custom ? CustomDataType : ContentTypeMap[C];
+    /** 「展开/收起」 「可见/不可见」 的策略配置 */
+    config?: TagConfig<C, P, D, CustomDataType>;
+    /** 法向量 */
+    normal?: Position;
+    /** 样式 */
+    style?: {
+        /** 小圆点样式 */
+        point?: {
+            style: 'Default';
+        } | {
+            style: 'CustomIcon';
+            iconUrl: string;
+        } | {
+            style: 'noPoint';
+        };
+        /** 收起的时候的动画延时，单位：ms */
+        foldedPointDelay?: number;
+    };
+} & (D extends DimensionType.Three ? (P extends PointType.PointTag ? {
+    normal: Position;
+} : unknown) : unknown); /** 三维标签需要法向量 */
+export interface TagConfig<C extends ContentType = ContentType, T extends PointType = PointType, D extends DimensionType = DimensionType, CustomDataType extends Object = {}> {
+    /** 显示/隐藏配置 */
+    visibleConfig?: {
+        /** 走点时不隐藏 */
+        alwaysShowWhenMovePano?: true;
+        /** min-max米内显示 | 无距离限制 */
+        visibleDistance?: MinMax | 'unLimited';
+        /** 限制xx点位上可见，不传则不限制 */
+        visiblePanoIndex?: number[];
+        /** 碰撞检测配置 */
+        intersectRaycaster?: {
+            /** 是否开启碰撞检测 */
+            enabled?: false;
+            /** 碰撞检测的允许误差, 默认值建议为0.01 */
+            distanceAccuracy?: number;
+        };
+        /** 3D标签中 「标签所在平面或垂直于标签法线的平面」 与 「摄像机到标签点或中心点的向量」 的夹角，范围内自动展开，范围外自动收起 */
+        angleRange?: MinMax;
+    } | ((five: Five, tagState: {
+        tag: Tag<C, T, D, CustomDataType>;
+        /** 标签点或中心点的到摄像机的距离 */
+        distance: number;
+        /** 3D标签中 「标签所在平面或垂直于标签法线的平面」 与 「摄像机到标签点或中心点的向量」 的夹角 */
+        angleRange?: number;
+    }) => boolean);
+    /** 展开/收起配置 */
+    unfoldedConfig?: {
+        /** 划动到不可见状态时，自动收起，disableFold: true 的标签不受此参数影响 */
+        autoUnfoldWhenHide?: false;
+        /** 部分标签是无法打开的 */
+        disableUnfold?: true;
+        /** 部分标签是无法收起的 */
+        disableFold?: true;
+        /** min-max米内自动展开,否则收起 */
+        unfoldDistance?: MinMax;
+        /** 自动展开策略 */
+        autoUnfold?: {
+            /** 自动展开 策略 */
+            strategy?: 'ScreenPostion';
+            /** 自动展开策略，{min,max}为project(camera)后的x值 */
+            autoUnfoldProjectX?: MinMax;
+        } | {
+            /** 自动展开 策略 */
+            strategy?: 'MinimumDistance';
+            /** 展开的最大数量, 默认为1 */
+            maxNumber?: number;
+        };
+    } | ((five: Five, tagState: {
+        tag: Tag<C, T, D, CustomDataType>;
+        /** 标签点或中心点的到摄像机的距离 */
+        distance: number;
+        /** 3D标签中 「标签所在平面或垂直于标签法线的平面」 与 「摄像机到标签点或中心点的向量」 的夹角 */
+        angleRange?: number;
+    }) => boolean);
+    /** 初始状态 */
+    initialState?: {
+        /** 显示/隐藏 */
+        visible?: boolean;
+        /** 展开/收起 */
+        unfolded?: boolean;
+    };
+    tag3DConfig?: Create3DDomContainerParamsType['config'];
+    clickable?: false;
+}
+export declare enum LinkType {
+    VrLink = "vr",
+    NormalLink = "normal"
+}
+export declare type MediaData = {
+    type: 'Image';
+    url: string;
+} | {
+    type: 'Video';
+    url: string;
+    videoCoverUrl?: string;
+};
+export declare type ObjectFit = 'fill' | 'contain' | 'cover' | 'none' | 'scale-down';
+interface ContentTypeMap {
+    [ContentType.Audio]: {
+        text: string;
+        audioUrl: string;
+        extraData?: Object;
+    };
+    [ContentType.ImageText]: {
+        text?: string;
+        mediaData: (MediaData & {
+            name?: string;
+        })[];
+        extraData?: Object;
+    };
+    [ContentType.Text]: {
+        text: string;
+        extraData?: Object;
+    };
+    [ContentType.Link]: {
+        linkType: LinkType;
+        text: string;
+        extraData?: Object;
+    };
+    [ContentType.Marketing]: {
+        /** 标题 */
+        title: string;
+        /** 高亮的标签 */
+        brandTags?: string[];
+        /** 普通标签 */
+        tags?: string[];
+        /** 头部宣传图 */
+        headerPictureUrl?: string;
+        /** 跳转文字 */
+        highlightText?: string;
+        /** 价格 */
+        price?: {
+            value: string;
+            /** 单位 */
+            unit: string;
+        };
+        extraData?: Object;
+    };
+    [ContentType.MediaPlane]: {
+        enableCarousel?: boolean;
+        /**
+         * @description stretch: 拉伸适配, proportional: 等比适配，默认值 'proportional'
+         * @deprecated replaced by objectFit
+         */
+        adaptationMode?: 'stretch' | 'proportional';
+        /** object-fit doc {@link https://developer.mozilla.org/zh-CN/docs/Web/CSS/object-fit} */
+        objectFit?: ObjectFit;
+        /**
+         * @description 是否开启自动轮播
+         * @param autoplay true: 开启自动轮播, false: 关闭自动播放
+         * @param autoplayVideo 自动轮播时，如果是视频， 则自动播放视频
+         * @default 默认值 { autoplay: true, autoplayVideo: false }
+         */
+        autoplayConfig?: {
+            autoplay: boolean;
+            autoplayVideo: boolean;
+        };
+        mediaData: MediaData[];
+        extraData?: Object;
+    };
+    [ContentType.Custom]: unknown;
+}
+/** 内置一些基础标签 */
+/** 一个点的标签 */
+export declare type PointTag<C extends ContentType = ContentType, D extends DimensionType = DimensionType, CustomDataType extends Object = {}> = Tag<C, PointType.PointTag, D, CustomDataType>;
+/** 二维标签 */
+export declare type Tag2D<C extends ContentType = ContentType, CustomDataType extends Object = {}> = Tag<C, PointType.PointTag, DimensionType.Two, CustomDataType>;
+/** 三维标签 */
+export declare type Tag3D<C extends ContentType = ContentType, CustomDataType extends Object = {}> = Tag<C, PointType.PointTag, DimensionType.Three, CustomDataType>;
+/** 三维贴片 */
+export declare type PlaneTag<C extends ContentType = ContentType, CustomDataType extends Object = {}> = Tag<C, PointType.PlaneTag, DimensionType.Three, CustomDataType>;

package/libs/src/PanoTagPlugin/typings/tag.js

@@ -0,0 +1,32 @@
+export var DimensionType;
+(function (DimensionType) {
+    DimensionType["Two"] = "2D";
+    DimensionType["Three"] = "3D";
+})(DimensionType || (DimensionType = {}));
+export var PointType;
+(function (PointType) {
+    PointType["PointTag"] = "PointTag";
+    PointType["PlaneTag"] = "PlaneTag";
+})(PointType || (PointType = {}));
+export var ContentType;
+(function (ContentType) {
+    /** 音频标签 */
+    ContentType["Audio"] = "Audio";
+    /** 文本标签 */
+    ContentType["Text"] = "Text";
+    /** 图文标签 */
+    ContentType["ImageText"] = "ImageText";
+    /** VR跳转标签 */
+    ContentType["Link"] = "Link";
+    /** 营销标签 */
+    ContentType["Marketing"] = "Marketing";
+    /** 图片视频贴片 */
+    ContentType["MediaPlane"] = "MediaPlane";
+    /** 其他/自定义标签 */
+    ContentType["Custom"] = "Custom";
+})(ContentType || (ContentType = {}));
+export var LinkType;
+(function (LinkType) {
+    LinkType["VrLink"] = "vr";
+    LinkType["NormalLink"] = "normal";
+})(LinkType || (LinkType = {}));

package/libs/src/PanoTagPlugin/utils/actionAfterFiveModelLoad.d.ts

@@ -0,0 +1,2 @@
+import type { Five } from '@realsee/five';
+export declare function actionAfterFiveModelLoad(five: Five, fuc: () => any): void;

package/libs/src/PanoTagPlugin/utils/actionAfterFiveModelLoad.js

@@ -0,0 +1,6 @@
+export function actionAfterFiveModelLoad(five, fuc) {
+    if (five.model.loaded)
+        fuc();
+    else
+        five.once('modelLoaded', () => fuc());
+}

package/libs/src/PanoTagPlugin/utils/addDebugPoints.d.ts

@@ -0,0 +1,3 @@
+import type { Five } from '@realsee/five';
+import type { Tag } from '../typings';
+export declare function addDebugPoints(five: Five, tags: Tag[]): void;

package/libs/src/PanoTagPlugin/utils/addDebugPoints.js

@@ -0,0 +1,32 @@
+import { arrayPositionToVector3 } from '../utils';
+import * as THREE from 'three';
+export function addDebugPoints(five, tags) {
+    tags.forEach((tag) => {
+        const geometry = new THREE.SphereGeometry(0.02, 16, 16);
+        const spheres = [];
+        const materials = [
+            new THREE.MeshBasicMaterial({ color: 0xffff00 }),
+            new THREE.MeshBasicMaterial({ color: 0xff00ff }),
+            new THREE.MeshBasicMaterial({ color: 0xff0000 }),
+            new THREE.MeshBasicMaterial({ color: 0x00ffff }), // 蓝
+        ];
+        if (tag.position.length === 4) {
+            tag.position.forEach((p, index) => {
+                const material = materials[index];
+                const sphere = new THREE.Mesh(geometry, material);
+                sphere.position.copy(arrayPositionToVector3(p));
+                spheres.push(sphere);
+            });
+        }
+        else {
+            const material = materials[0];
+            const sphere = new THREE.Mesh(geometry, material);
+            sphere.position.copy(arrayPositionToVector3(tag.position));
+            spheres.push(sphere);
+        }
+        spheres.forEach((sphere) => {
+            sphere.material.depthTest = false;
+            five.scene.add(sphere);
+        });
+    });
+}

package/libs/src/PanoTagPlugin/utils/checkRange.d.ts

@@ -0,0 +1,4 @@
+export declare function checkRange(value?: number, range?: {
+    min?: number;
+    max?: number;
+}): boolean;

package/libs/src/PanoTagPlugin/utils/checkRange.js

@@ -0,0 +1,12 @@
+export function checkRange(value, range) {
+    if (value === undefined)
+        return;
+    const { min, max } = range !== null && range !== void 0 ? range : {};
+    if (min === undefined && max === undefined)
+        return;
+    if (typeof max === 'number' && max < value)
+        return false;
+    if (typeof min === 'number' && min > value)
+        return false;
+    return true;
+}

package/libs/src/PanoTagPlugin/utils/constants.d.ts

@@ -0,0 +1,3 @@
+export declare function random(): string;
+declare const RANDON_STRING: string;
+export { RANDON_STRING };

package/libs/src/PanoTagPlugin/utils/constants.js

@@ -0,0 +1,5 @@
+export function random() {
+    return Math.random().toString(36).slice(-6);
+}
+const RANDON_STRING = random();
+export { RANDON_STRING };

package/libs/src/PanoTagPlugin/utils/debounce.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 函数防抖：指触发事件后，在 `n` 秒内函数只能执行一次，如果触发事件后在 `n` 秒内又触发了事件，则会重新计算函数延执行时间。
+ * @param callback 回调函数
+ * @param waitFor 等待时间
+ * @returns
+ */
+export declare const debounce: <F extends (...args: any) => any>(callback: F, waitFor?: number) => (...args: Parameters<F>) => ReturnType<F>;

package/libs/src/PanoTagPlugin/utils/debounce.js

@@ -0,0 +1,21 @@
+/**
+ * 函数防抖：指触发事件后，在 `n` 秒内函数只能执行一次，如果触发事件后在 `n` 秒内又触发了事件，则会重新计算函数延执行时间。
+ * @param callback 回调函数
+ * @param waitFor 等待时间
+ * @returns
+ */
+export const debounce = (callback, waitFor = 1000 / 60) => {
+    let timer = null;
+    const savedFunc = callback;
+    const fn = (...args) => {
+        if (timer)
+            clearTimeout(timer);
+        timer = setTimeout(() => {
+            savedFunc === null || savedFunc === void 0 ? void 0 : savedFunc(...args);
+            if (timer)
+                clearTimeout(timer);
+            timer = null;
+        }, waitFor);
+    };
+    return fn;
+};

package/libs/src/PanoTagPlugin/utils/index.d.ts

@@ -0,0 +1,12 @@
+export * from '../../CSS3DRenderPlugin/utils';
+export * from './addDebugPoints';
+export * from './noTypecheck';
+export * from './planeNormal';
+export * from './tagPosition';
+export * from './checkRange';
+export * from './actionAfterFiveModelLoad';
+export * from './normalPositionToPositions';
+export * from './debounce';
+export * from './throttle';
+export * from './search';
+export * from './resizeObserver';

package/libs/src/PanoTagPlugin/utils/index.js

@@ -0,0 +1,12 @@
+export * from '../../CSS3DRenderPlugin/utils';
+export * from './addDebugPoints';
+export * from './noTypecheck';
+export * from './planeNormal';
+export * from './tagPosition';
+export * from './checkRange';
+export * from './actionAfterFiveModelLoad';
+export * from './normalPositionToPositions';
+export * from './debounce';
+export * from './throttle';
+export * from './search';
+export * from './resizeObserver';

package/libs/src/PanoTagPlugin/utils/noTypecheck.d.ts

@@ -0,0 +1 @@
+export declare const noTypecheck: <T = any>(x: T) => any;

package/libs/src/PanoTagPlugin/utils/noTypecheck.js

@@ -0,0 +1 @@
+export const noTypecheck = (x) => x;

package/libs/src/PanoTagPlugin/utils/normalPositionToPositions.d.ts

@@ -0,0 +1,2 @@
+import type { Vector3 } from 'three';
+export declare function normalPositionToPositions(cameraPosition: Vector3, position: Vector3, normal: Vector3): [Vector3, Vector3, Vector3, Vector3];

package/libs/src/PanoTagPlugin/utils/normalPositionToPositions.js

@@ -0,0 +1,35 @@
+import * as THREE from 'three';
+import '.';
+export function normalPositionToPositions(cameraPosition, position, normal) {
+    const squareHalfSize = 0.01;
+    const plane = new THREE.Plane().setFromNormalAndCoplanarPoint(normal, position);
+    const right = position.clone().sub(cameraPosition).cross(new THREE.Vector3(0, 1, 0)).setLength(squareHalfSize);
+    const top = new THREE.Vector3(0, squareHalfSize, 0);
+    const positions = [
+        position.clone().sub(right).sub(top),
+        position.clone().add(right).sub(top),
+        position.clone().add(right).add(top),
+        position.clone().sub(right).add(top), // 左上
+    ].map((v) => plane.projectPoint(v, new THREE.Vector3()));
+    // debug
+    // const geometry = new THREE.SphereGeometry(0.005, 16, 16)
+    // const spheres: THREE.Mesh<THREE.SphereGeometry, THREE.MeshBasicMaterial>[] = []
+    // const materials = [
+    //   new THREE.MeshBasicMaterial({ color: 0xffff00 }), // 黄
+    //   new THREE.MeshBasicMaterial({ color: 0xff00ff }), // 粉
+    //   new THREE.MeshBasicMaterial({ color: 0xff0000 }), // 红
+    //   new THREE.MeshBasicMaterial({ color: 0x00ffff }), // 蓝
+    // ]
+    // positions.forEach((p, index) => {
+    //   const material = materials[index]!
+    //   const sphere = new THREE.Mesh(geometry, material)
+    //   sphere.position.copy(p)
+    //   spheres.push(sphere)
+    // })
+    // spheres.forEach((sphere) => {
+    //   sphere.material.depthTest = false
+    //   this.five.scene.add(sphere)
+    // })
+    // debug end
+    return positions;
+}

package/libs/src/PanoTagPlugin/utils/planeNormal.d.ts

@@ -0,0 +1,4 @@
+import type { Vector3 } from 'three';
+import { AnyPosition } from '.';
+export declare function planeNormal(points: [AnyPosition, AnyPosition, AnyPosition] | [AnyPosition, AnyPosition, AnyPosition, AnyPosition]): Vector3;
+export declare function planeNormal(points: AnyPosition[]): Vector3 | void;

package/libs/src/PanoTagPlugin/utils/planeNormal.js

@@ -0,0 +1,9 @@
+import { anyPositionToVector3 } from '.';
+export function planeNormal(points) {
+    if (points.length < 3)
+        return;
+    const vector3Points = points.map(anyPositionToVector3);
+    const vector01 = vector3Points[1].clone().sub(vector3Points[0]); // 点0 -> 点1 的向量
+    const vector12 = vector3Points[2].clone().sub(vector3Points[1]); // 点1 -> 点2 的向量
+    return vector01.cross(vector12);
+}

package/libs/src/PanoTagPlugin/utils/resizeObserver.d.ts

@@ -0,0 +1,4 @@
+export declare function resizeObserver(func: () => any, element?: HTMLElement): {
+    observe: () => void;
+    unobserve: () => void;
+};

package/libs/src/PanoTagPlugin/utils/resizeObserver.js

@@ -0,0 +1,15 @@
+export function resizeObserver(func, element) {
+    if (!element || typeof ResizeObserver === 'undefined' || !ResizeObserver) {
+        return {
+            observe: () => window.addEventListener('resize', func),
+            unobserve: () => window.removeEventListener('resize', func),
+        };
+    }
+    else {
+        const observer = new ResizeObserver(func);
+        return {
+            observe: () => observer.observe(element),
+            unobserve: () => observer.unobserve(element),
+        };
+    }
+}

package/libs/src/PanoTagPlugin/utils/search.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 二分查找，查找第一个大于等于给定值的元素
+ * 数组必须有序，存在重复
+ * @param {array} arr 待排序数组
+ * @param {number} target 目标数据
+ */
+export declare function binarySearchFirstBig(getValueByIndex: (index: number) => number, indexRange: [number, number], target: number): number;
+/**
+ * @description: 查找第一个小于前一个数字的值
+ */
+export declare function searchFirstValueSmallThanLastValue(getValueByIndex: (index: number) => number, indexRange: [number, number]): number;

package/libs/src/PanoTagPlugin/utils/search.js

@@ -0,0 +1,65 @@
+/**
+ * 二分查找，查找第一个大于等于给定值的元素
+ * 数组必须有序，存在重复
+ * @param {array} arr 待排序数组
+ * @param {number} target 目标数据
+ */
+export function binarySearchFirstBig(getValueByIndex, indexRange, target) {
+    const [min, max] = indexRange;
+    if (min >= max)
+        return -1;
+    if (max <= 1)
+        return -1;
+    // 低位下标
+    let lowIndex = min;
+    // 高位下标
+    let highIndex = max;
+    const cache = {};
+    const getValue = (key) => {
+        if (!cache[key])
+            cache[key] = getValueByIndex(key);
+        return cache[key];
+    };
+    while (lowIndex <= highIndex) {
+        // 中间下标
+        const midIndex = Math.floor((lowIndex + highIndex) / 2);
+        if (getValue(midIndex) > target) {
+            // 如果 midIndex 为0或者前一个数小于 target 那么找到第一个大于等于给定值的元素，直接返回
+            if (midIndex === min || getValue(midIndex - 1) <= target)
+                return midIndex;
+            // 否则高位下标为中位下标减1
+            highIndex = midIndex - 1;
+        }
+        else {
+            // 低位下标为中位下标加1
+            lowIndex = midIndex + 1;
+        }
+    }
+    return -1;
+}
+/**
+ * @description: 查找第一个小于前一个数字的值
+ */
+export function searchFirstValueSmallThanLastValue(getValueByIndex, indexRange) {
+    const [min, max] = indexRange;
+    if (min >= max)
+        return -1;
+    if (max <= 1)
+        return -1;
+    if (min <= 1)
+        return -1;
+    const cache = {};
+    const getValue = (key) => {
+        if (!cache[key])
+            cache[key] = getValueByIndex(key);
+        return cache[key];
+    };
+    for (let index = min; index < max; index++) {
+        const value = getValue(index);
+        const lastValue = getValue(index - 1);
+        if (value < lastValue) {
+            return index;
+        }
+    }
+    return -1;
+}

package/libs/src/PanoTagPlugin/utils/tagPosition.d.ts

@@ -0,0 +1,3 @@
+import type { Vector3 } from 'three';
+import { AnyPosition } from '.';
+export declare function tagPosition(position: AnyPosition | [AnyPosition, AnyPosition, AnyPosition, AnyPosition]): Vector3;

package/libs/src/PanoTagPlugin/utils/tagPosition.js

@@ -0,0 +1,10 @@
+import { anyPositionToVector3, centerPoint } from '.';
+export function tagPosition(position) {
+    if (Array.isArray(position) && position.length === 4) {
+        const vector3Positions = position.map(anyPositionToVector3);
+        return centerPoint(vector3Positions[0], vector3Positions[2]);
+    }
+    else {
+        return anyPositionToVector3(position);
+    }
+}

package/libs/src/PanoTagPlugin/utils/throttle.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 创建一个防抖动函数，该函数在高频调用时会每隔 wait 毫秒后调用 func 方法
+ * `throttle` 会在第一次调用时立刻调用一次
+ * @param func - 要防抖动的函数
+ * @param wait - 需要延迟的毫秒数
+ */
+export declare function throttle<T>(func: (...args: T[]) => void, wait?: number): (this: any, ...args: T[]) => void;

package/libs/src/PanoTagPlugin/utils/throttle.js

@@ -0,0 +1,17 @@
+/**
+ * 创建一个防抖动函数，该函数在高频调用时会每隔 wait 毫秒后调用 func 方法
+ * `throttle` 会在第一次调用时立刻调用一次
+ * @param func - 要防抖动的函数
+ * @param wait - 需要延迟的毫秒数
+ */
+export function throttle(func, wait = 200) {
+    let last;
+    return function (...args) {
+        if (last)
+            return;
+        func.apply(this, args);
+        last = setTimeout(function () {
+            last = null;
+        }, wait);
+    };
+}