@realsee/dnalogel 2.25.0 → 2.26.1

package/libs/PipelinePlugin/Controller.js

@@ -0,0 +1,344 @@
+var j = Object.defineProperty;
+var v = Object.getOwnPropertySymbols;
+var P = Object.prototype.hasOwnProperty, _ = Object.prototype.propertyIsEnumerable;
+var A = (p, n, e) => n in p ? j(p, n, { enumerable: !0, configurable: !0, writable: !0, value: e }) : p[n] = e, m = (p, n) => {
+  for (var e in n || (n = {}))
+    P.call(n, e) && A(p, e, n[e]);
+  if (v)
+    for (var e of v(n))
+      _.call(n, e) && A(p, e, n[e]);
+  return p;
+};
+var u = (p, n, e) => (A(p, typeof n != "symbol" ? n + "" : n, e), e);
+var d = (p, n, e) => new Promise((t, i) => {
+  var s = (a) => {
+    try {
+      h(e.next(a));
+    } catch (c) {
+      i(c);
+    }
+  }, r = (a) => {
+    try {
+      h(e.throw(a));
+    } catch (c) {
+      i(c);
+    }
+  }, h = (a) => a.done ? t(a.value) : Promise.resolve(a.value).then(s, r);
+  h((e = e.apply(p, n)).next());
+});
+import * as F from "three";
+import { Controller as S } from "../base/BasePluginWithData.js";
+import { equal as O } from "../shared-utils/equal.js";
+import { notNil as T } from "../shared-utils/isNil.js";
+import { loadTexture as x } from "../shared-utils/three/loadTexture.js";
+import { format as y, getPipesFromLibrary as C } from "./utils/formatData.js";
+import { ObjectFlowPipe as D } from "./utils/Objects/FlowPipe.js";
+import "../base/BasePlugin.js";
+import "../shared-utils/Subscribe.js";
+import "hammerjs";
+import "@realsee/five";
+import "../vendor/@tweenjs/tween/dist/tween.esm.js.js";
+import "../CSS3DRenderPlugin/utils/three/CSS3DRender.js";
+import "../CSS3DRenderPlugin/utils/three/CSS3DRenderer.js";
+import "three/examples/jsm/renderers/CSS3DRenderer";
+import "../CSS3DRenderPlugin/utils/getAllCSS3DObject.js";
+import "../CSS3DRenderPlugin/utils/createResizeObserver.js";
+import "../CSS3DRenderPlugin/utils/even.js";
+import "../CSS3DRenderPlugin/utils/positionToVector3.js";
+import "../CSS3DRenderPlugin/utils/three/CSS3DObject.js";
+import "../CSS3DRenderPlugin/utils/three/OpacityMesh.js";
+import "../shared-utils/three/centerPoint.js";
+import "../CSS3DRenderPlugin/utils/three/CSS3DScene.js";
+import "../CSS3DRenderPlugin/utils/three/CSS3DGroup.js";
+import "../CSS3DRenderPlugin/utils/generateBehindFiveElement.js";
+import "../shared-utils/absoluteUrl.js";
+import "../shared-utils/isTruelyObject.js";
+import "../shared-utils/animationFrame/index.js";
+import "./utils/Objects/Pipe.js";
+import "../shared-utils/animationFrame/BetterTween.js";
+import "../shared-utils/three/Extras/Curves/BezierCurve3.js";
+import "../shared-utils/three/Extras/Core/Interpolations.js";
+import "../shared-utils/three/Extras/Core/Interpolations2.js";
+const g = { flowSpeed: 0.6, rotateSpeed: 0 };
+class de extends S {
+  constructor(e) {
+    super(e);
+    // ==================== public properties ====================
+    u(this, "data");
+    /** 插件状态
+     * @property `visible` `<boolean>` 是否可见
+     * @property `enabled` `<boolean>` 是否启用
+     * @property `visiblePipeIDs` `<string[]>` 可见的管道 ID
+     * @property `speed` `<Speed>` 水流速度
+     * @property `speed.flowSpeed` `<number>` 横向流动速度，默认是 0.6 m/s
+     * @property `speed.rotateSpeed` `<number>` 纵向旋转速度：默认是 0 deg/s
+     */
+    u(this, "state");
+    /** 当前插件所有新增 THREE 相关副作用都在 group 下 */
+    u(this, "group");
+    /** 用于展示水流的水管 */
+    u(this, "pipeObjects", []);
+    // ==================== private properties ====================
+    /** 水管贴图缓存 */
+    u(this, "texturePromiseCache", /* @__PURE__ */ new Map());
+    /** 销毁插件，移除所有副作用，销毁后将不响应任何 API */
+    u(this, "dispose", () => {
+      this.disable(), this.five.scene.remove(this.group), this.texturePromiseCache.forEach((e) => e.then((t) => t.dispose())), this.texturePromiseCache.clear();
+    });
+    u(this, "onWantsFiveTapGesture", (...e) => {
+      const [t] = e, i = t.intersectObjects(this.pipeObjects, !1);
+      if (i.length === 0 || !this.data)
+        return;
+      const h = i[0].object.customID, a = this.data.pipes.find(({ id: o }) => o === h), c = this.data.pipelines.find((o) => a && o.pipes.includes(a));
+      if (!(!a || !c))
+        return this.hooks.emit("tap", {
+          intersectObjects: i,
+          pipe: a,
+          pipeline: c,
+          wantsFiveTapGestureParams: e
+        }), !1;
+    });
+    this.state = {
+      target: null,
+      visible: !0,
+      enabled: !0,
+      isFlowing: !1,
+      speed: g
+    }, this.five = e, this.group = new F.Group(), this.group.name = "water-pipe-group", this.five.scene.add(this.group), this.five.once("dispose", this.dispose), this.five.on("wantsTapGesture", this.onWantsFiveTapGesture);
+  }
+  /** 加载管道数据，重复调用会使用新数据覆盖旧数据
+   * @param `data` `<Plugin.ServerData>` Open API 接口返回的数据。
+   * @param `initialState` `<Plugin.State> | <undefined>` 数据加载后，要应用的 state，默认是 undefined。
+   * @param `userAction` `<boolean> | <undefined>` 是否是用户操作，默认是 true。
+   * @param `options` `<Plugin.LoadOptions> | <undefined>` 数据加载配置项。
+   * @param `options.getPipeRadius` `<(pipe: ServerData.LinesDataset) => number> | <undefined>` 允许用户通过函数自定义管道半径。
+   * @param `options.getPipeUrl` `<(water: Water) => string> | <undefined>` 允许用户通过函数自定义管道贴图，
+   * 函数返回的 string 就是当前 water 对应的贴图地址。
+   */
+  // eslint-disable-next-line max-params
+  load(e, t, i, s) {
+    return d(this, null, function* () {
+      const r = this.data;
+      this.data = yield this.formatData(e, s), this.removeAllPipes(), this.hooks.emit("dataChange", this.data, r), this.pipeObjects = yield Promise.all(
+        this.data.pipes.filter((h) => !!(h != null && h.texture)).map((b) => d(this, [b], function* ({ id: h, texture: a, path: c, radius: o }) {
+          const l = yield this.loadPipeTexture(a), f = { id: h, path: c, textureURL: a, texture: l, geometryConfig: { radius: o } };
+          return new D(f);
+        }))
+      ), this.data.pipelines.forEach((h) => {
+        h.pipes.reduce((a, c) => {
+          const o = this.findPipeObjectWithID(c.id);
+          return o == null || o.setInitialDisplacement(a), a + ((o == null ? void 0 : o.pathLength) || 0);
+        }, 0);
+      }), this.hooks.emit("dataLoaded", this.data), this.state.visible === !1 && this.pipeObjects.forEach((h) => h.setOpacity(0)), this.state.enabled && (this.group.add(...this.pipeObjects), this.five.needsRender = !0), t && this.setState(t, { userAction: i });
+    });
+  }
+  /** 更改插件 State
+   * @param `state` `<Partial<Plugin.State>>` 插件属性 `state` 的子集。
+   * @param `options` `<Option> | <undefined>`
+   * @param `options.userAction` `<boolean> | <undefined>` 是否是用户操作。默认是 true。
+   */
+  setState(e, t = {}) {
+    const i = this.state;
+    if (O(e, i, { deep: !0 }))
+      return;
+    const s = t.userAction !== void 0 ? t.userAction : !0;
+    if (this.updateState(e, s), e.enabled !== void 0 && i.enabled !== e.enabled && (e.enabled ? this._enable({ userAction: s }) : this._disable({ userAction: s })), e.visible !== void 0 && i.visible !== e.visible) {
+      const r = { userAction: s, anime: { duration: 500 } };
+      e.visible ? this._show(r) : this._hide(r);
+    }
+    if (e.isFlowing !== void 0 && i.isFlowing !== e.isFlowing && (e.isFlowing ? this._flow() : this._stopFlow()), e.speed !== void 0 && !O(i.speed, this.state.speed, { deep: !0 }) && this._setSpeed(e.speed), e.target !== void 0 && !O(i.target, this.state.target, { deep: !0 })) {
+      const r = {
+        target: e.target,
+        showAnime: { duration: 500 },
+        hideAnime: { duration: 500 }
+      };
+      this._switchPipelines(r);
+    }
+  }
+  /** 启用插件
+   * @param `options` `<Option> | <undefined>`
+   * @param `options.userAction` `<boolean> | <undefined>` 是否是用户操作。默认是 true。
+   */
+  enable(e = {}) {
+    var i;
+    if (this.state.enabled)
+      return;
+    const t = (i = e.userAction) != null ? i : !0;
+    this.updateState({ enabled: !0 }, t), this._enable({ userAction: t });
+  }
+  /** 禁用插件
+   * @param `options` `<Option> | <undefined>`
+   * @param `options.userAction` `<boolean> | <undefined>` 是否是用户操作。默认是 true。
+   */
+  disable(e = {}) {
+    var i;
+    if (this.state.enabled === !1)
+      return;
+    const t = (i = e.userAction) != null ? i : !0;
+    this.updateState({ enabled: !1, isFlowing: !1 }, t), this._disable({ userAction: t });
+  }
+  /** 展示管道模型，注意如果通过 `switchPipelines` 更改过 `visibleIDs`，则只会展示这一部分模型。
+   * @param `options` `<Partial<ShowHideOptions>> | <undefined>`
+   * @param `options.userAction` `<boolean> | <undefined>` 是否是用户操作。默认是 true。
+   * @param `options.anime` `<AnimeOptions> | <undefined>` 动画配置。
+   * @param `options.anime.duration` `<number> | <undefined>` 动画时间，默认是 500ms。
+   */
+  show() {
+    return d(this, arguments, function* (e = {}) {
+      if (this.state.visible)
+        return;
+      const t = m({
+        userAction: !0,
+        anime: { duration: 500 }
+      }, e);
+      this.updateState({ visible: !0 }, t.userAction), yield this._show(t);
+    });
+  }
+  /** 插件内容整体隐藏
+   * @param `options` `<Partial<ShowHideOptions>> | <undefined>`
+   * @param `options.userAction` `<boolean> | <undefined>` 是否是用户操作。默认是 true。
+   * @param `options.anime` `<AnimeOptions> | <undefined>` 动画配置。
+   * @param `options.anime.duration` `<number> | <undefined>` 动画时间，默认是 500ms。
+   */
+  hide() {
+    return d(this, arguments, function* (e = {}) {
+      if (this.state.visible === !1)
+        return;
+      const t = m({
+        userAction: !0,
+        anime: { duration: 500 }
+      }, e);
+      this.updateState({ visible: !1 }, t.userAction), yield this._hide(t);
+    });
+  }
+  /** 切换管路
+   * @param `options` `Partial<ShowPipelinesOptions> | <undefined>`
+   * @param `options.target` `<{ startLibraryID: number; endLibraryID: number }[]> | <undefined>`
+   * 目标管路，存在时，展示目标管路包含的管道，同时隐藏其他管道。不存在则展示所有管道。
+   * startLibraryID 和 endLibraryID 是起始和结束的设备 ID。
+   * @param `options.showAnime` `<AnimeOptions> | <undefined>` 展示的动画配置。
+   * @param `options.hideAnime` `<AnimeOptions> | <undefined>` 隐藏的动画配置。
+   * @param `options.anime` `<AnimeOptions> | <undefined>` 兜底的动画配置。
+   * @param `options.userAction` `<boolean> | <undefined>` 是否是否是用户操作。
+   * */
+  switchPipelines(e) {
+    return d(this, null, function* () {
+      var c, o, b, l, f, w;
+      if (!this.data)
+        return;
+      const t = (c = e == null ? void 0 : e.target) != null ? c : null, i = (o = e == null ? void 0 : e.userAction) != null ? o : !0;
+      this.updateState({ target: t }, i);
+      const s = { duration: 500 }, r = (l = (b = e == null ? void 0 : e.hideAnime) != null ? b : e == null ? void 0 : e.anime) != null ? l : s, h = (w = (f = e == null ? void 0 : e.showAnime) != null ? f : e == null ? void 0 : e.anime) != null ? w : s, a = {
+        target: t,
+        showAnime: h,
+        hideAnime: r
+      };
+      this._switchPipelines(a);
+    });
+  }
+  /** 开始流动 */
+  flow(e = {}) {
+    var i;
+    if (this.state.isFlowing)
+      return;
+    const t = (i = e.userAction) != null ? i : !0;
+    this.updateState({ isFlowing: !0 }, t), this._flow();
+  }
+  /** 停止流动 */
+  stopFlow(e = {}) {
+    var i;
+    if (this.state.isFlowing === !1)
+      return;
+    const t = (i = e.userAction) != null ? i : !0;
+    this.updateState({ isFlowing: !1 }, t), this._stopFlow();
+  }
+  /** 更改水管流速
+   * @param `options` `<SetSpeedOptions> | <undefined>`
+   * @param `options.speed` `<Speed> | <undefined>` 参考 `state.speed` 的描述。
+   * @param `options.userAction` `<boolean> | <undefined>` 是否是否是用户操作。
+   */
+  setSpeed(e) {
+    var s, r;
+    const t = (s = e == null ? void 0 : e.speed) != null ? s : g, i = (r = e.userAction) != null ? r : !0;
+    this.updateState({ speed: t }, i), this._setSpeed(t);
+  }
+  formatData(e, t) {
+    return d(this, null, function* () {
+      return y(e, t);
+    });
+  }
+  _enable(e) {
+    this.hooks.emit("enable", { userAction: e.userAction }), this.five.scene.add(this.group), this.five.needsRender = !0, this.five.on("wantsTapGesture", this.onWantsFiveTapGesture);
+  }
+  _disable(e) {
+    this.hooks.emit("disable", { userAction: e.userAction }), this.disposeAnime(), this.five.scene.remove(this.group), this.five.needsRender = !0, this.five.off("wantsTapGesture", this.onWantsFiveTapGesture);
+  }
+  _show(e) {
+    return d(this, null, function* () {
+      var s;
+      this.hooks.emit("show", { userAction: e.userAction });
+      const t = (s = e == null ? void 0 : e.anime) != null ? s : { duration: 500 }, i = this.findPipeObjectWithTarget(this.state.target);
+      yield Promise.all(i.map((r) => r == null ? void 0 : r.show(t))), this.five.needsRender = !0;
+    });
+  }
+  _hide(e) {
+    return d(this, null, function* () {
+      var i;
+      this.hooks.emit("hide", { userAction: e.userAction });
+      const t = (i = e == null ? void 0 : e.anime) != null ? i : { duration: 500 };
+      yield Promise.all(this.pipeObjects.map((s) => s.hide(t))), this.five.needsRender = !0;
+    });
+  }
+  _switchPipelines(e) {
+    return d(this, null, function* () {
+      if (!this.data)
+        return;
+      const t = this.findPipeObjectWithTarget(e.target), i = e.hideAnime;
+      yield Promise.all(this.pipeObjects.map((r) => r.hide(i)));
+      const s = e.showAnime;
+      yield Promise.all(t.map((r) => r.show(s)));
+    });
+  }
+  _flow() {
+    this.pipeObjects.forEach((e) => e.flow());
+  }
+  _stopFlow() {
+    this.pipeObjects.forEach((e) => e.stopFlow());
+  }
+  _setSpeed(e) {
+    this.pipeObjects.forEach((t) => t.setSpeed(e));
+  }
+  updateState(e, t) {
+    const i = this.state;
+    this.state = m(m({}, this.state), e), this.hooks.emit("stateChange", { state: this.state, prevState: i, userAction: t });
+  }
+  /** 加载管道贴图，如果再加载中，复用之前的加载 Promise */
+  loadPipeTexture(e) {
+    return d(this, null, function* () {
+      const t = this.texturePromiseCache.get(e);
+      if (t)
+        return t;
+      const i = x(e);
+      return this.texturePromiseCache.set(e, i), i;
+    });
+  }
+  /** 销毁所有动画 */
+  disposeAnime() {
+    this.pipeObjects.forEach((e) => e.disposeAnime()), this.five.needsRender = !0;
+  }
+  /** 移除所有管道模型 */
+  removeAllPipes() {
+    this.disposeAnime(), this.group.remove(...this.pipeObjects), this.pipeObjects.forEach((e) => e.dispose()), this.pipeObjects = [], this.five.needsRender = !0;
+  }
+  /** 根据 ID 查找管道模型 */
+  findPipeObjectWithID(e) {
+    return this.pipeObjects.find(({ customID: t }) => t === e);
+  }
+  /** 根据 target 查找管道模型 */
+  findPipeObjectWithTarget(e) {
+    return e ? C({ data: this.data, target: e }).map(({ id: i }) => this.findPipeObjectWithID(i)).filter(T) : this.pipeObjects;
+  }
+}
+export {
+  de as Controller
+};

package/libs/PipelinePlugin/index.d.ts

@@ -0,0 +1,6 @@
+import type { FivePlugin } from '@realsee/five';
+import { Controller } from './Controller';
+export declare const PipelinePlugin: FivePlugin<undefined, Controller>;
+export type PipelinePluginParameterType = undefined;
+export type PipelinePluginReturnType = InstanceType<typeof Controller>;
+export default PipelinePlugin;

package/libs/PipelinePlugin/index.js

@@ -0,0 +1,39 @@
+import { Controller as o } from "./Controller.js";
+import "three";
+import "../base/BasePluginWithData.js";
+import "../base/BasePlugin.js";
+import "../shared-utils/Subscribe.js";
+import "hammerjs";
+import "@realsee/five";
+import "../vendor/@tweenjs/tween/dist/tween.esm.js.js";
+import "../CSS3DRenderPlugin/utils/three/CSS3DRender.js";
+import "../CSS3DRenderPlugin/utils/three/CSS3DRenderer.js";
+import "three/examples/jsm/renderers/CSS3DRenderer";
+import "../CSS3DRenderPlugin/utils/getAllCSS3DObject.js";
+import "../CSS3DRenderPlugin/utils/createResizeObserver.js";
+import "../CSS3DRenderPlugin/utils/even.js";
+import "../CSS3DRenderPlugin/utils/positionToVector3.js";
+import "../CSS3DRenderPlugin/utils/three/CSS3DObject.js";
+import "../CSS3DRenderPlugin/utils/three/OpacityMesh.js";
+import "../shared-utils/three/centerPoint.js";
+import "../CSS3DRenderPlugin/utils/three/CSS3DScene.js";
+import "../CSS3DRenderPlugin/utils/three/CSS3DGroup.js";
+import "../CSS3DRenderPlugin/utils/generateBehindFiveElement.js";
+import "../shared-utils/absoluteUrl.js";
+import "../shared-utils/equal.js";
+import "../shared-utils/isTruelyObject.js";
+import "../shared-utils/isNil.js";
+import "../shared-utils/three/loadTexture.js";
+import "./utils/formatData.js";
+import "./utils/Objects/FlowPipe.js";
+import "../shared-utils/animationFrame/index.js";
+import "./utils/Objects/Pipe.js";
+import "../shared-utils/animationFrame/BetterTween.js";
+import "../shared-utils/three/Extras/Curves/BezierCurve3.js";
+import "../shared-utils/three/Extras/Core/Interpolations.js";
+import "../shared-utils/three/Extras/Core/Interpolations2.js";
+const J = (r) => new o(r);
+export {
+  J as PipelinePlugin,
+  J as default
+};

package/libs/PipelinePlugin/typing/PluginData/index.js

@@ -0,0 +1,6 @@
+const e = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  e as PluginData
+};

package/libs/PipelinePlugin/typing/PluginData.d.ts

@@ -0,0 +1,20 @@
+export interface Water {
+    isHot: boolean;
+    quality: number;
+}
+export interface Pipe {
+    id: string;
+    path: number[][];
+    texture?: string;
+    radius: number;
+    water: Water;
+}
+export interface Pipeline {
+    startLibraryID: number;
+    endLibraryID: number;
+    pipes: Pipe[];
+}
+export interface RootObject {
+    pipelines: Pipeline[];
+    pipes: Pipe[];
+}

package/libs/PipelinePlugin/typing/PluginData.js

@@ -0,0 +1 @@
+

package/libs/PipelinePlugin/typing/ServerData/index.js

@@ -0,0 +1,6 @@
+const e = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  e as ServerData
+};

package/libs/PipelinePlugin/typing/ServerData.d.ts

@@ -0,0 +1,28 @@
+export interface LinesDataset {
+    id: string;
+    type: string;
+    name: string;
+    data: number[][];
+}
+export interface ConnectsDataset {
+    waterType: number;
+    start: number;
+    end: number;
+    data: string[];
+}
+export interface WaterTypeMap {
+    name: string;
+    type: number;
+}
+export interface ModelMap {
+    library: number;
+    name: string;
+}
+/** LinesDataset 的别名 */
+export type PipeItem = LinesDataset;
+export interface RootObject {
+    LinesDataset: LinesDataset[];
+    ConnectsDataset: ConnectsDataset[];
+    WaterTypeMap: WaterTypeMap[];
+    ModelMap: ModelMap[];
+}

package/libs/PipelinePlugin/typing/ServerData.js

@@ -0,0 +1 @@
+

package/libs/PipelinePlugin/typing/index.d.ts

@@ -0,0 +1,79 @@
+import type * as THREE from 'THREE';
+import type * as PluginData from './PluginData';
+import type * as ServerData from './ServerData';
+import type * as BasePlugin from '../../base/BasePluginWithData';
+import type { EventCallback } from '@realsee/five';
+import type { AnimeOptions } from '../utils/Objects/Pipe';
+export interface PipelineTargetItem {
+    startLibraryID: number;
+    endLibraryID: number;
+}
+export interface State extends BasePlugin.State {
+    enabled: boolean;
+    visible: boolean;
+    isFlowing: boolean;
+    speed: Speed;
+    target: null | PipelineTargetItem[];
+}
+export interface LoadOptions {
+    /** 获取管道半径，单位是 m。默认是 0.016 m */
+    getPipeRadius: (pipe: ServerData.LinesDataset) => number;
+    /** 自定义不同水质的贴图 */
+    getPipeUrl: <T extends PluginData.Water>(water: T) => string;
+}
+export interface EventMap extends BasePlugin.EventMap<State, PluginData.RootObject> {
+    /** visible 从 false 到 true 的回调
+     * @param event.userAction 是否是用户操作
+     */
+    show: (event: {
+        userAction: boolean;
+    }) => void;
+    /** visible 从 true 到 false 的回调
+     * @param event.userAction 是否是用户操作
+     */
+    hide: (event: {
+        userAction: boolean;
+    }) => void;
+    /** enabled 从 false 到 true 的回调
+     * @param event.userAction 是否是用户操作
+     */
+    enable: (event: {
+        userAction: boolean;
+    }) => void;
+    /** enabled 从 true 到 false 的回调
+     * @param event.userAction 是否是用户操作
+     */
+    disable: (event: {
+        userAction: boolean;
+    }) => void;
+    tap: (data: {
+        pipe: PluginData.Pipe;
+        pipeline: PluginData.Pipeline;
+        intersectObjects: THREE.Intersection[];
+        wantsFiveTapGestureParams: Parameters<EventCallback['wantsTapGesture']>;
+    }) => any;
+}
+export interface ShowHideOptions {
+    userAction: boolean;
+    anime: AnimeOptions;
+}
+export interface ShowPipelinesOptions {
+    userAction: boolean;
+    showAnime: AnimeOptions;
+    hideAnime: AnimeOptions;
+    anime: AnimeOptions;
+    target: PipelineTargetItem[];
+}
+/** 流速 */
+export interface Speed {
+    /** 横向流速：m/s */
+    flowSpeed?: number;
+    /** 纵向旋转速度：deg/s */
+    rotateSpeed?: number;
+}
+export interface SetSpeedOptions {
+    speed: Speed;
+    userAction: boolean;
+}
+export * as ServerData from './ServerData';
+export * as PluginData from './PluginData';

package/libs/PipelinePlugin/typing/index.js

@@ -0,0 +1,6 @@
+import { ServerData as e } from "./ServerData/index.js";
+import { PluginData as t } from "./PluginData/index.js";
+export {
+  t as PluginData,
+  e as ServerData
+};

package/libs/PipelinePlugin/utils/Objects/FlowPipe.d.ts

@@ -0,0 +1,34 @@
+import type { PipeParams as BasePipeParams } from './Pipe';
+import { ObjectPipe } from './Pipe';
+export type PipeParams = BasePipeParams;
+export declare class ObjectFlowPipe extends ObjectPipe {
+    /** 初始状态下，当前水管内的水流在整体管道上的位移
+     * @description 因为水管是不连续的，而要达到水流的连续效果，需要用过贴图的 uOffset 控制每根水管的初始状态
+     */
+    private initialDisplacement;
+    private oldTime;
+    /** 横向流动速度：m / s */
+    private flowSpeed;
+    /** 纵向旋转速度：deg / s */
+    private rotateSpeed;
+    constructor(params: PipeParams);
+    setInitialDisplacement(distance: number, direction?: 'forward' | 'backward'): void;
+    /** 水流移动「基于初始位置」
+     * @description 因为贴图的运动与 u 的 uOffset 相反，比较反直觉，所以封装方法易于理解
+     * @param displacement 位移：米 * 方向(向前 -> 正, 向后 -> 负)
+     */
+    moveFromOrigin(displacement: number): boolean;
+    /** 水流移动「基于调整管道差值之后的位置」
+     *
+     * @param distance 位移：米 * 方向
+     */
+    moveForwardFromInitialOffset(distance: number): void;
+    flow(): void;
+    stopFlow(): void;
+    setSpeed(speed?: {
+        flowSpeed?: number;
+        rotateSpeed?: number;
+    }): void;
+    disposeAnime(): void;
+    private flowAnimationDisposer;
+}