@realsee/dnalogel 3.69.7 → 3.69.10

package/libs/shared-utils/exports.js

@@ -6,99 +6,103 @@ import { inside as o } from "./math/inside.js";
 import { LightTag as m, tag as n } from "./tag.js";
 import { checkFiveModelLoaded as p } from "./five/index.js";
 import { Magnifier as _ } from "./three/Magnifier.js";
-import { getCoordsFromClient as f, getCoordsFromElement as E } from "./three/getCoords.js";
+import { getCoordsFromClient as E, getCoordsFromElement as f } from "./three/getCoords.js";
 import { PointSelector as l } from "./three/PointSelector/index.js";
 import { PointHelper as A } from "./three/PointSelector/utils/PointHelper.js";
 import { PointSelectorHelper as a } from "./three/PointSelector/utils/PointSelectorHelper.js";
 import { Object3D as L } from "./three/core/Object3D.js";
 import { LineSegments as T } from "./three/core/LineSegments.js";
-import { bounding as d, boundingBox as F, boundingSphere as D, boxVertex as I, boxVertexes as O, worldBounding as P, worldBoundingBox as g, worldBoundingSphere as S } from "./three/boundingBox.js";
-import { animeMap as s, blink as M, reblink as R } from "./three/blink.js";
-import { getIntersectFromRelativePosition as U } from "./three/getIntersect.js";
-import { getRaycasterFromFivePointer as c } from "./three/getRaycaster.js";
-import { PointDomHelper as N } from "./three/PointDomHelper.js";
-import { LegacyPointHelper as u } from "./three/LegacyPointHelper.js";
-import { isNil as x, notNil as G } from "./isNil.js";
-import { uuid as b } from "./uuid.js";
-import { CURRENT_PANO_IMAGE_DEFAULT_IMAGE as v, DEFAULT_STATIC_PREFIX as C, DNALOGEL_DEFAULT_ASSETS as k, ENTRY_DOOR_DEFAULT_IMAGE as w, FLOORPLAN_DEFAULT_IMAGE as B, GUIDELINE_DEFAULT_ARROW_TEXTURE as H, GUIDELINE_WHITE_ARROW_TEXTURE as y, MODEL_CHASSIS_COMPASS_DEFAULT_MODEL as h, MODEL_ENTRY_DOOR_GUIDE_PLUGIN_DEFAULT_MODEL as j, PANO_COMPASS_DEFAULT_IMAGE as W, PANO_SPATIAL_TAG_BLUR_IMAGE as X, PANO_TAG_DEFAULT_LINK_ICON as q } from "./url/defaultUrls.js";
-import { replaceStaticPrefix as V } from "./url/replace-static-prefix.js";
-import { awaitNextFrame as Y, getFrameTime as z, nextFrame as K, requestAnimationFrameInterval as J } from "./animationFrame/index.js";
-import { equal as Q } from "./equal.js";
-import { FivePuppet as Z } from "./five/FivePuppet.js";
-import { isModelLike as $, isPanoramaLike as oo } from "./five/mode.js";
-import { lookObject as ro } from "./five/lookObject.js";
-import { lookPoint as eo } from "./five/lookPoint.js";
-import { fiveModelIsLoaded as to, waitFiveModelLoaded as io } from "./five/fiveModelLoad.js";
-import { FiveDomEvents as mo } from "./five/FiveDomEvents.js";
-import { initialCSS3DRender as no } from "./CSS3DRender/index.js";
-import { BetterTween as po, tweenProgress as _o } from "./animationFrame/BetterTween.js";
-const Xo = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+import { bounding as F, boundingBox as I, boundingSphere as d, boxVertex as P, boxVertexes as D, worldBounding as O, worldBoundingBox as S, worldBoundingSphere as g } from "./three/boundingBox.js";
+import { ANIME_PRESETS as M, DEFAULT_ANIME_CONFIG as s, animeMap as N, blink as R, blinkWithPreset as U, cleanup as c, reblink as u } from "./three/blink.js";
+import { getIntersectFromRelativePosition as G } from "./three/getIntersect.js";
+import { getRaycasterFromFivePointer as b } from "./three/getRaycaster.js";
+import { PointDomHelper as x } from "./three/PointDomHelper.js";
+import { LegacyPointHelper as v } from "./three/LegacyPointHelper.js";
+import { isNil as C, notNil as k } from "./isNil.js";
+import { uuid as w } from "./uuid.js";
+import { CURRENT_PANO_IMAGE_DEFAULT_IMAGE as B, DEFAULT_STATIC_PREFIX as H, DNALOGEL_DEFAULT_ASSETS as h, ENTRY_DOOR_DEFAULT_IMAGE as y, FLOORPLAN_DEFAULT_IMAGE as j, GUIDELINE_DEFAULT_ARROW_TEXTURE as W, GUIDELINE_WHITE_ARROW_TEXTURE as X, MODEL_CHASSIS_COMPASS_DEFAULT_MODEL as q, MODEL_ENTRY_DOOR_GUIDE_PLUGIN_DEFAULT_MODEL as V, PANO_COMPASS_DEFAULT_IMAGE as Y, PANO_SPATIAL_TAG_BLUR_IMAGE as z, PANO_TAG_DEFAULT_LINK_ICON as K } from "./url/defaultUrls.js";
+import { replaceStaticPrefix as J } from "./url/replace-static-prefix.js";
+import { awaitNextFrame as Q, getFrameTime as Z, nextFrame as $, requestAnimationFrameInterval as oo } from "./animationFrame/index.js";
+import { equal as ro } from "./equal.js";
+import { FivePuppet as eo } from "./five/FivePuppet.js";
+import { isModelLike as to, isPanoramaLike as io } from "./five/mode.js";
+import { lookObject as mo } from "./five/lookObject.js";
+import { lookPoint as no } from "./five/lookPoint.js";
+import { fiveModelIsLoaded as po, waitFiveModelLoaded as _o } from "./five/fiveModelLoad.js";
+import { FiveDomEvents as Eo } from "./five/FiveDomEvents.js";
+import { initialCSS3DRender as fo } from "./CSS3DRender/index.js";
+import { BetterTween as lo, tweenProgress as Ao } from "./animationFrame/BetterTween.js";
+const zo = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
-  BetterTween: po,
-  CURRENT_PANO_IMAGE_DEFAULT_IMAGE: v,
-  DEFAULT_STATIC_PREFIX: C,
-  DNALOGEL_DEFAULT_ASSETS: k,
-  ENTRY_DOOR_DEFAULT_IMAGE: w,
-  FLOORPLAN_DEFAULT_IMAGE: B,
-  FiveDomEvents: mo,
-  FivePuppet: Z,
-  GUIDELINE_DEFAULT_ARROW_TEXTURE: H,
-  GUIDELINE_WHITE_ARROW_TEXTURE: y,
+  ANIME_PRESETS: M,
+  BetterTween: lo,
+  CURRENT_PANO_IMAGE_DEFAULT_IMAGE: B,
+  DEFAULT_ANIME_CONFIG: s,
+  DEFAULT_STATIC_PREFIX: H,
+  DNALOGEL_DEFAULT_ASSETS: h,
+  ENTRY_DOOR_DEFAULT_IMAGE: y,
+  FLOORPLAN_DEFAULT_IMAGE: j,
+  FiveDomEvents: Eo,
+  FivePuppet: eo,
+  GUIDELINE_DEFAULT_ARROW_TEXTURE: W,
+  GUIDELINE_WHITE_ARROW_TEXTURE: X,
   Interval: e,
-  LegacyPointHelper: u,
+  LegacyPointHelper: v,
   LightTag: m,
   LineSegments: T,
-  MODEL_CHASSIS_COMPASS_DEFAULT_MODEL: h,
-  MODEL_ENTRY_DOOR_GUIDE_PLUGIN_DEFAULT_MODEL: j,
+  MODEL_CHASSIS_COMPASS_DEFAULT_MODEL: q,
+  MODEL_ENTRY_DOOR_GUIDE_PLUGIN_DEFAULT_MODEL: V,
   Magnifier: _,
   Object3D: L,
-  PANO_COMPASS_DEFAULT_IMAGE: W,
-  PANO_SPATIAL_TAG_BLUR_IMAGE: X,
-  PANO_TAG_DEFAULT_LINK_ICON: q,
-  PointDomHelper: N,
+  PANO_COMPASS_DEFAULT_IMAGE: Y,
+  PANO_SPATIAL_TAG_BLUR_IMAGE: z,
+  PANO_TAG_DEFAULT_LINK_ICON: K,
+  PointDomHelper: x,
   PointHelper: A,
   PointSelector: l,
   PointSelectorHelper: a,
   Rectangle: t,
-  animeMap: s,
-  awaitNextFrame: Y,
-  blink: M,
-  bounding: d,
-  boundingBox: F,
-  boundingSphere: D,
-  boxVertex: I,
-  boxVertexes: O,
+  animeMap: N,
+  awaitNextFrame: Q,
+  blink: R,
+  blinkWithPreset: U,
+  bounding: F,
+  boundingBox: I,
+  boundingSphere: d,
+  boxVertex: P,
+  boxVertexes: D,
   checkFiveModelLoaded: p,
+  cleanup: c,
   convexHull: i,
-  equal: Q,
-  fiveModelIsLoaded: to,
-  getCoordsFromClient: f,
-  getCoordsFromElement: E,
-  getFrameTime: z,
-  getIntersectFromRelativePosition: U,
-  getRaycasterFromFivePointer: c,
-  initialCSS3DRender: no,
+  equal: ro,
+  fiveModelIsLoaded: po,
+  getCoordsFromClient: E,
+  getCoordsFromElement: f,
+  getFrameTime: Z,
+  getIntersectFromRelativePosition: G,
+  getRaycasterFromFivePointer: b,
+  initialCSS3DRender: fo,
   inside: o,
-  isModelLike: $,
-  isNil: x,
-  isPanoramaLike: oo,
-  lookObject: ro,
-  lookPoint: eo,
-  nextFrame: K,
-  notNil: G,
+  isModelLike: to,
+  isNil: C,
+  isPanoramaLike: io,
+  lookObject: mo,
+  lookPoint: no,
+  nextFrame: $,
+  notNil: k,
   pointInPolygon: o,
-  reblink: R,
-  replaceStaticPrefix: V,
-  requestAnimationFrameInterval: J,
+  reblink: u,
+  replaceStaticPrefix: J,
+  requestAnimationFrameInterval: oo,
   sculpt: r,
   tag: n,
-  tweenProgress: _o,
-  uuid: b,
-  waitFiveModelLoaded: io,
-  worldBounding: P,
-  worldBoundingBox: g,
-  worldBoundingSphere: S
+  tweenProgress: Ao,
+  uuid: w,
+  waitFiveModelLoaded: _o,
+  worldBounding: O,
+  worldBoundingBox: S,
+  worldBoundingSphere: g
 }, Symbol.toStringTag, { value: "Module" }));
 export {
-  Xo as exports
+  zo as exports
 };

package/libs/shared-utils/five/index.js

@@ -9,7 +9,7 @@ import "./FivePuppet.js";
 import "@realsee/five/line";
 import "../three/core/Five_LineMaterial2.js";
 import "../three/core/Sphere.js";
-import "../../vendor/animejs/lib/anime.es.js";
+import "../three/blink.js";
 import "../../CSS3DRenderPlugin/utils/three/CSS3DRender.js";
 function g(e) {
   return e.model ? e.work ? e.model.loaded ? e.model.name !== e.work.model.file ? { result: !1, msg: "five.model.name 与 five.work.model.file 不一致" } : { result: !0, msg: "" } : { result: !1, msg: "five.model 未加载完成" } : { result: !1, msg: "five 数据未加载" } : { result: !1, msg: "five.model 不存在" };

package/libs/shared-utils/five/lookObject.js

@@ -39,7 +39,7 @@ import "./FivePuppet.js";
 import "@realsee/five/line";
 import "../three/core/Five_LineMaterial2.js";
 import { worldBoundingSphere as j } from "../three/boundingBox.js";
-import "../../vendor/animejs/lib/anime.es.js";
+import "../three/blink.js";
 import "../../CSS3DRenderPlugin/utils/three/CSS3DRender.js";
 function rt(o, e, t) {
   return g(this, null, function* () {

package/libs/shared-utils/index.js

@@ -9,5 +9,5 @@ import "../CSS3DRenderPlugin/utils/generateBehindFiveElement.js";
 import "@realsee/five/line";
 import "./three/core/Five_LineMaterial2.js";
 import "./three/core/Sphere.js";
-import "../vendor/animejs/lib/anime.es.js";
+import "./three/blink.js";
 import "../CSS3DRenderPlugin/utils/three/CSS3DRender.js";

package/libs/shared-utils/logger.js

@@ -1,6 +1,6 @@
 function A() {
   console.debug(
-    "%c %c@realsee/dnalogel %cv3.69.7",
+    "%c %c@realsee/dnalogel %cv3.69.10",
     [
       "background: url('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAkAAAAMCAMAAACHgmeRAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAABLFBMVEUAAAAapPoap/oaqvkbrfkbr/gZnfwZoPsaqfnD4v/E4/8Ylv0clPm93/+/4P/B4f8Yj/683/8Wif+33P8Uhv+x2f8ShP+s1v8Pgf+n0/8Nf/+h0f8Lff8Lff8Nf/9dl/+czv8KfP8KfP+Lxf+Uyv+Xy/+Hwv+Jw/+Mxf+Oxv+RyP8aovsapfoap/oZmfwZm/wZnvsYnPsYkf4YlP0NePsDYfgYcfi43f+63v8Xiv8Xjf4EWfwCV/sWZ/qz2v+02/8Vh/8WiP8EUf8CTf4WXv2u1/+v2P8Thf8Thv8ETf8CR/8VV/+o1f+q1f8Qgv8Rg/8DSv8BRf8UVP+j0v+k0v8OgP8Pgf8DR/8DQv9Nhf+dzv+fz/+Kv/+Vyv+Xy/+azf+Oxv+Qx/+SyP////8MUhLdAAAAK3RSTlMACEWQ2bd98uQECPXxqO7c+Pb49vj2+Pb49vj23Oul8fMHA+TwerXXjEIG2P+bHgAAAAFiS0dEY1y+LaoAAAB+SURBVAjXY2BgZGJmYWVgYGBgY9fW0eVg4ORi4NbTNzDk4eXjZxAwMjYxNTO3EGQQsrSytrG1sxdmEHFwdHJ2cXUTZRBz9/D08vbxFWeQ8PMPCAwKDpFkkAoNC4+IjIqWZpCRlZOPiY2LV2BQVGJQTkhMUlEFWaOmrqGpxQAAyg0S9Dq+VPYAAAAASUVORK5CYII=')",
       "background-repeat: no-repeat",

package/libs/shared-utils/tag.js

@@ -33,7 +33,7 @@ import "../CSS3DRenderPlugin/utils/generateBehindFiveElement.js";
 import "@realsee/five/line";
 import "./three/core/Five_LineMaterial2.js";
 import "./three/core/Sphere.js";
-import "../vendor/animejs/lib/anime.es.js";
+import "./three/blink.js";
 import "../vendor/@tweenjs/tween/dist/tween.esm.js.js";
 import "../CSS3DRenderPlugin/utils/three/CSS3DRender.js";
 import "./five/FivePuppet.js";

package/libs/shared-utils/three/PointDomHelper.js

@@ -11,7 +11,7 @@ import "../../CSS3DRenderPlugin/utils/generateBehindFiveElement.js";
 import "@realsee/five/line";
 import "./core/Five_LineMaterial2.js";
 import "./core/Sphere.js";
-import "../../vendor/animejs/lib/anime.es.js";
+import "./blink.js";
 import { rangePieceImg as h } from "../../PanoMeasurePlugin/Modules/rangePiece/html.js";
 import { CSS3DRenderPlugin as b } from "../../CSS3DRenderPlugin/index.js";
 import { BetterTween as u } from "../animationFrame/BetterTween.js";

package/libs/shared-utils/three/PointSelector/utils/PointSelectorHelper.js

@@ -18,7 +18,7 @@ import { PointHelper as w } from "./PointHelper.js";
 import { Subscribe as E } from "../../../Subscribe.js";
 import { PointHelper2 as P } from "./PointHelper2.js";
 import "../../core/Sphere.js";
-import "../../../../vendor/animejs/lib/anime.es.js";
+import "../../blink.js";
 import "../../../../vendor/@tweenjs/tween/dist/tween.esm.js.js";
 import "../../../tag.js";
 import "../../CSS3DRenderer/index.js";

package/libs/shared-utils/three/blink.d.ts

@@ -1,41 +1,278 @@
+/**
+ * @fileoverview 闪烁动画工具模块
+ *
+ * 这个模块提供了用于创建闪烁动画效果的工具函数，支持 js 对象和 DOM 元素。
+ * 主要功能包括：
+ * - 为 js Object3D 和 DOM 元素创建闪烁动画
+ * - 自动保存和恢复物体的初始状态
+ * - 支持递归处理 js 对象的子元素
+ * - 兼容不同类型的材质（ShaderMaterial、普通 Material）
+ *
+ * @module blink
+ * @author DNAlogel Team
+ * @since 1.0.0
+ */
 import anime from 'animejs';
-import * as THREE from 'three';
+import { ShaderMaterial, type Material, type Object3D } from 'three';
+/**
+ * 默认动画配置
+ * @constant
+ */
+declare const DEFAULT_ANIME_CONFIG: {
+    readonly duration: 300;
+    readonly easing: "linear";
+    readonly direction: "alternate";
+    readonly loop: 4;
+    readonly autoplay: false;
+};
+/**
+ * 动画预设配置
+ * @constant
+ */
+declare const ANIME_PRESETS: {
+    readonly quick: {
+        readonly duration: 200;
+        readonly loop: 2;
+    };
+    readonly normal: {
+        readonly duration: 300;
+        readonly loop: 4;
+    };
+    readonly slow: {
+        readonly duration: 500;
+        readonly loop: 6;
+    };
+    readonly attention: {
+        readonly duration: 400;
+        readonly loop: 8;
+        readonly easing: "easeInOutQuad";
+    };
+};
+/**
+ * 物体初始状态接口
+ * @interface ObjectInitialState
+ */
+interface ObjectInitialState {
+    /** 初始透明度值 */
+    opacity?: number | string;
+    /** 初始透明属性 */
+    transparent?: boolean;
+    /** 初始可见性状态 */
+    visible?: boolean | {
+        display: string;
+        visibility: string;
+    };
+}
+/**
+ * 闪烁动画选项接口
+ * @interface BlinkAnimeOptions
+ * @extends {anime.AnimeParams}
+ */
 interface BlinkAnimeOptions extends anime.AnimeParams {
-    updateRender?: () => any;
     /**
-     * @description 递归修改所有子元素透明度
+     * 渲染更新回调函数
+     * @description 在动画更新时调用的函数，通常用于触发渲染更新
+     */
+    updateRender?: () => void;
+    /**
+     * 动画进度回调函数
+     * @description 在动画进度更新时调用的函数
+     */
+    onProgress?: (progress: number) => void;
+    /**
+     * 动画开始回调函数
+     * @description 在动画开始时调用的函数
+     */
+    onStart?: () => void;
+    /**
+     * 动画完成回调函数
+     * @description 在动画完成时调用的函数
+     */
+    onComplete?: () => void;
+    /**
+     * 是否递归修改所有子元素透明度
+     * @description 当为 true 时，会遍历 js 对象的所有子元素并应用闪烁效果
      * @default true
      */
     traverseTHREEObject?: boolean;
 }
+/**
+ * 重新闪烁动画选项接口
+ * @interface ReBlinkAnimeOptions
+ * @extends {BlinkAnimeOptions}
+ */
 interface ReBlinkAnimeOptions extends BlinkAnimeOptions {
+    /**
+     * 最大透明度值
+     * @description 重新闪烁时的最大透明度，范围 0-1
+     * @default 1
+     */
     maxOpacity?: number;
 }
-interface AnimeInstance extends anime.AnimeInstance {
+/**
+ * 扩展的动画实例接口
+ * @interface ExtendedAnimeInstance
+ * @extends {anime.AnimeInstance}
+ */
+interface ExtendedAnimeInstance extends anime.AnimeInstance {
     /**
-     * @description 提前结束动画
+     * 提前结束动画
+     * @description 手动结束动画并恢复初始状态
      */
     preComplete: () => void;
+    /**
+     * 暂停动画
+     */
+    pause: () => void;
+    /**
+     * 播放动画
+     */
+    play: () => void;
+    /**
+     * 跳转到指定时间
+     */
+    seek: (time: number) => void;
+    /**
+     * 动画完成 Promise
+     */
+    finished: Promise<void>;
 }
-type Target = HTMLElement | THREE.Object3D;
-declare const animeMap: Map<Target | Target[], AnimeInstance>;
 /**
- * @description 闪烁一个物体/Dom
- * @param animeOptions https://animejs.com/documentation/
+ * 支持的目标类型
+ * @typedef {HTMLElement | Object3D} Target
+ */
+type Target = HTMLElement | Object3D;
+/**
+ * 材质对象类型
+ * @typedef {Material | ShaderMaterial} MaterialObject
+ */
+type MaterialObject = Material | ShaderMaterial;
+/**
+ * 带材质的 js 对象类型
+ * @interface Object3DWithMaterial
+ * @extends {Object3D}
+ */
+interface Object3DWithMaterial extends Object3D {
+    material: MaterialObject;
+    visible: boolean;
+    name: string;
+    traverse: (callback: (child: Object3D) => void) => void;
+    isObject3D: true;
+}
+/**
+ * 无材质的 js 对象类型
+ * @interface Object3DWithoutMaterial
+ * @extends {Object3D}
+ */
+interface Object3DWithoutMaterial extends Object3D {
+    material?: undefined;
+    visible: boolean;
+    name: string;
+    traverse: (callback: (child: Object3D) => void) => void;
+    isObject3D: true;
+}
+/**
+ * 所有可能的 js 对象类型
+ * @typedef {Object3DWithMaterial | Object3DWithoutMaterial} ThreeObject
+ */
+type ThreeObject = Object3DWithMaterial | Object3DWithoutMaterial;
+/**
+ * 所有支持的目标类型
+ * @typedef {HTMLElement | ThreeObject} SupportedTarget
+ */
+type SupportedTarget = HTMLElement | ThreeObject;
+/**
+ * 存储动画实例的 WeakMap
+ * @description 用于管理正在进行的动画实例，避免重复动画
+ * @private
+ */
+declare const animeMap: WeakMap<Target | Target[], ExtendedAnimeInstance>;
+/**
+ * 闪烁一个物体或DOM元素
+ * @description 为指定的 js 对象或 DOM 元素创建闪烁动画效果。
+ * 动画会自动保存物体的初始状态，并在动画结束后恢复到初始状态。
+ *
+ * @param {Target | Target[]} objects - 要闪烁的目标对象或对象数组
+ * @param {BlinkAnimeOptions} [animeOptions] - 动画选项配置
+ * @returns {ExtendedAnimeInstance} 动画实例，可以用于控制动画
+ *
  * @example
- * ```ts
- * // 闪烁 three 物体
- * blink(object3D, { updateRender: () => { five.needsRender = true } })
- * // 闪烁 dom 5 次
- * blink(document.getElementById('id'), { loop: 5 * 2 })
+ * ```typescript
+ * // 闪烁 js 对象
+ * const animeInstance = blink(object3D, {
+ *   updateRender: () => { five.needsRender = true }
+ * })
+ *
+ * // 闪烁 DOM 元素 5 次
+ * blink(document.getElementById('id'), {
+ *   loop: 5 * 2
+ * })
+ *
+ * // 自定义动画参数
+ * blink(object3D, {
+ *   duration: 500,
+ *   easing: 'easeInOutQuad',
+ *   loop: 6,
+ *   updateRender: () => renderer.render(scene, camera)
+ * })
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // 提前结束动画
+ * const anime = blink(object3D)
+ * setTimeout(() => {
+ *   anime.preComplete() // 立即结束动画并恢复状态
+ * }, 1000)
  * ```
  */
-declare function blink(objects: Target | Target[], animeOptions?: BlinkAnimeOptions): AnimeInstance;
+declare function blink(objects: Target | Target[], animeOptions?: BlinkAnimeOptions): ExtendedAnimeInstance;
 /**
- * @description 闪烁一个不可见的物体/Dom
+ * 闪烁一个不可见的物体或DOM元素
+ * @description 适用于物体或DOM元素在初始状态不可见的情况。
+ * 闪烁完成后的状态为初始不可见的状态。
+ *
+ * @param {Target | Target[]} objects - 要闪烁的目标对象或对象数组
+ * @param {ReBlinkAnimeOptions} [animeOptions] - 动画选项配置
+ * @returns {ExtendedAnimeInstance} 动画实例，可以用于控制动画
+ *
+ * @example
+ * ```typescript
+ * // 闪烁不可见的 js 对象
+ * reblink(invisibleObject3D, {
+ *   maxOpacity: 0.8,
+ *   updateRender: () => { five.needsRender = true }
+ * })
  *
- * 适用于物体/Dom在初始状态不可见的情况，闪烁完成后的状态为初始不可见的状态
- * @param animeOptions https://animejs.com/documentation/
+ * // 闪烁隐藏的 DOM 元素
+ * reblink(hiddenElement, {
+ *   duration: 1000,
+ *   loop: 3
+ * })
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // 自定义最大透明度
+ * reblink(object3D, {
+ *   maxOpacity: 0.5, // 最大透明度为 0.5
+ *   duration: 500,
+ *   easing: 'easeInOutQuad'
+ * })
+ * ```
+ */
+declare function reblink(objects: Target | Target[], animeOptions?: ReBlinkAnimeOptions): ExtendedAnimeInstance;
+/**
+ * 使用预设配置的闪烁函数
+ * @param objects 目标对象
+ * @param preset 预设名称
+ * @param options 额外选项
+ * @returns 动画实例
+ */
+declare function blinkWithPreset(objects: Target | Target[], preset: keyof typeof ANIME_PRESETS, options?: BlinkAnimeOptions): ExtendedAnimeInstance;
+/**
+ * 清理所有动画和状态
+ * @description 清理所有正在进行的动画和存储的状态
  */
-declare function reblink(objects: Target | Target[], animeOptions?: BlinkAnimeOptions): AnimeInstance;
-export { blink, reblink, animeMap, type BlinkAnimeOptions, type ReBlinkAnimeOptions, type AnimeInstance };
+declare function cleanup(): void;
+export { blink, reblink, blinkWithPreset, cleanup, animeMap, type BlinkAnimeOptions, type ReBlinkAnimeOptions, type ExtendedAnimeInstance as AnimeInstance, type Target, type SupportedTarget, type ThreeObject, type ObjectInitialState, DEFAULT_ANIME_CONFIG, ANIME_PRESETS, };