@realsee/dnalogel 3.69.6-alpha.1 → 3.69.6-alpha.2

package/libs/floorplan/FloorplanGuidePlugin/Controller.d.ts

@@ -0,0 +1,52 @@
+import type { Five } from '@realsee/five';
+import type { BaseOptions } from '../../base/BasePlugin';
+import type { FloorplanServerData } from '../typings/floorplanServerData';
+import type { FloorplanExtraObject3D } from '../typings/floorplanData';
+import type { HighlightData } from '../typings';
+import type { State, Config, EventMap, Parameters, PluginData, PluginServerData } from './typing';
+import * as BasePlugin from '../../base/BasePluginWithData';
+export declare class Controller extends BasePlugin.Controller<State, EventMap, PluginServerData, PluginData> {
+    name: string;
+    state: State;
+    protected data?: PluginData;
+    private app?;
+    private wrapperSelector;
+    private wrapper;
+    private disposed;
+    private extraObjects;
+    private highlightData;
+    constructor(five: Five, params?: Parameters);
+    dispose: () => void;
+    load(serverData: PluginServerData | FloorplanServerData, state?: Partial<State>, userAction?: boolean): Promise<void>;
+    show(options?: BaseOptions): Promise<void>;
+    hide(options?: BaseOptions): Promise<void>;
+    enable(options?: BaseOptions): void;
+    disable(options?: BaseOptions): void;
+    highlight: (highlightData: HighlightData) => void;
+    unhighlight: () => void;
+    /** 更改插件 State */
+    setState(state: Partial<State>, options?: BaseOptions): void;
+    /** 把插件的渲染DOM插入到对应的容器中去 */
+    appendTo(wrapper: Element): void;
+    changeConfigs(config: Config, userAction?: boolean): void;
+    setExtraObjectsWith3DPositions(data: FloorplanExtraObject3D[]): void;
+    /**
+     * 更改显示的楼层
+     * @param floorIndex 要显示的楼层索引
+     */
+    changeFloor(floorIndex: number): void;
+    /**
+     * 处理户型图点击事件
+     * 寻找距离点击位置最近的观察点，并移动到该点
+     * @param clickData 点击事件数据
+     */
+    private handleFloorplanClick;
+    protected formatData(serverData: PluginServerData): Promise<PluginData>;
+    private _enable;
+    private _disable;
+    private _show;
+    private _hide;
+    private updateState;
+    private render;
+    private handlePanoArrived;
+}

package/libs/floorplan/FloorplanGuidePlugin/Controller.js

@@ -0,0 +1,331 @@
+var x = Object.defineProperty, I = Object.defineProperties;
+var S = Object.getOwnPropertyDescriptors;
+var g = Object.getOwnPropertySymbols;
+var y = Object.prototype.hasOwnProperty, E = Object.prototype.propertyIsEnumerable;
+var u = (a, o, t) => o in a ? x(a, o, { enumerable: !0, configurable: !0, writable: !0, value: t }) : a[o] = t, d = (a, o) => {
+  for (var t in o || (o = {}))
+    y.call(o, t) && u(a, t, o[t]);
+  if (g)
+    for (var t of g(o))
+      E.call(o, t) && u(a, t, o[t]);
+  return a;
+}, b = (a, o) => I(a, S(o));
+var n = (a, o, t) => (u(a, typeof o != "symbol" ? o + "" : o, t), t);
+var m = (a, o, t) => new Promise((e, i) => {
+  var s = (p) => {
+    try {
+      h(t.next(p));
+    } catch (l) {
+      i(l);
+    }
+  }, r = (p) => {
+    try {
+      h(t.throw(p));
+    } catch (l) {
+      i(l);
+    }
+  }, h = (p) => p.done ? e(p.value) : Promise.resolve(p.value).then(s, r);
+  h((t = t.apply(a, o)).next());
+});
+import _ from "./Components/Main.js";
+import "../../shared-utils/tag.js";
+import "three";
+import "../../vendor/hammerjs/hammer.js";
+import "../../shared-utils/three/PointSelector/index.js";
+import "../../shared-utils/three/CSS3DRenderer/index.js";
+import "../../CSS3DRenderPlugin/utils/generateBehindFiveElement.js";
+import "@realsee/five/line";
+import "../../shared-utils/three/core/Five_LineMaterial2.js";
+import "../../shared-utils/three/core/Sphere.js";
+import "../../vendor/animejs/lib/anime.es.js";
+import "../../vendor/@tweenjs/tween/dist/tween.esm.js.js";
+import "../../CSS3DRenderPlugin/utils/three/CSS3DRender.js";
+import { FLOORPLAN_DEFAULT_IMAGE as D } from "../../shared-utils/url/defaultUrls.js";
+import { replaceStaticPrefix as F } from "../../shared-utils/url/replace-static-prefix.js";
+import { equal as k } from "../../shared-utils/equal.js";
+import "../../shared-utils/five/FivePuppet.js";
+import { CAMERA_IMAGE_BIG_DOT as O } from "../Assets/camera.js";
+import { Controller as C } from "../../base/BasePluginWithData.js";
+import { formatData as v, formatExtraObjects as P } from "../utils/formatData.js";
+import "../../vendor/svelte/internal/index.js";
+import "./Components/Camera.js";
+import "../../shared-utils/throttle.js";
+import "./Components/CurrentFloor/CurrentFloor.js";
+import "./Components/CurrentFloor/ExtraObjects.js";
+import "../Components/BaseImage.js";
+import "../Components/Normalmage.js";
+import "../Components/SvgImage.js";
+import "../Components/RoomHighlight/RoomHighlight.js";
+import "../Components/RoomHighlight/Room.js";
+import "../utils/formatPosition.js";
+import "./Components/ObserverDots.js";
+import "./Components/RoomLabels.js";
+import "../../shared-utils/svelte/resizeObserver.js";
+import "../../vendor/resize-observer-polyfill/dist/ResizeObserver.es.js";
+import "./Components/RoomLabelItem.js";
+import "./Components/FloorplanCompass.js";
+import "../Assets/compass.js";
+import "../../shared-utils/math/rad2Deg.js";
+import "../../shared-utils/positionToVector3.js";
+import "../../shared-utils/five/vector3ToScreen.js";
+import "../../shared-utils/five/getFiveModel.js";
+import "../../shared-utils/Utils/FiveUtil.js";
+import "../../shared-utils/Utils/BaseUtil.js";
+import "../../shared-utils/Subscribe.js";
+import "../../shared-utils/Utils/WorkUtil.js";
+import "../../shared-utils/five/transformPosition.js";
+import "../../shared-utils/three/temp.js";
+import "../../shared-utils/three/core/Raycaster.js";
+import "../../shared-utils/dom/resizeObserver.js";
+import "../../shared-utils/five/fiveEveryReadyListener.js";
+import "../../shared-utils/five/fiveModelLoad.js";
+import "../../shared-utils/three/PointSelector/utils/PointSelectorHelper.js";
+import "../../shared-utils/three/Magnifier.js";
+import "../../shared-utils/three/PointSelector/utils/PointHelper.js";
+import "../../shared-utils/three/Assets/index.js";
+import "../../CSS3DRenderPlugin/utils/three/CSS3DObject.js";
+import "../../shared-utils/even.js";
+import "../../shared-utils/CSS3DRender/OpacityMesh.js";
+import "../../shared-utils/three/centerPoint.js";
+import "../../shared-utils/three/getObjectVisible.js";
+import "../../shared-utils/isNil.js";
+import "../../shared-utils/three/PointSelector/utils/html.js";
+import "../../shared-utils/CSS3DRender/index.js";
+import "../../shared-utils/CSS3DRender/CSS3DRenderer.js";
+import "../../shared-utils/createResizeObserver.js";
+import "../../shared-utils/three/PointSelector/utils/PointHelper2.js";
+import "../../Sculpt/Meshes/Line.js";
+import "../../Sculpt/typings/style.js";
+import "../../shared-utils/three/IObject3D.js";
+import "../../Sculpt/utils/Meshes/getLengthHTML.js";
+import "../../shared-utils/three/applyObjectMatrixWorld.js";
+import "../../shared-utils/util.js";
+import "../../shared-utils/three/core/LineGeometry.js";
+import "../../shared-utils/three/core/LineMaterial.js";
+import "../../shared-utils/three/core/Line2.js";
+import "../../shared-utils/three/core/LineMaterial2.js";
+import "../../Sculpt/utils/unit.js";
+import "../../Sculpt/utils/renderDom.js";
+import "../../CSS3DRenderPlugin/utils/three/CSS3DSprite.js";
+import "../../shared-utils/isTouchDevice.js";
+import "../../shared-utils/five/getPosition.js";
+import "../../shared-utils/five/getRaycasterByNdcPosition.js";
+import "../../shared-utils/three/PointSelector/utils/contents.js";
+import "../../Sculpt/utils/three/rayOnLine.js";
+import "../../CSS3DRenderPlugin/utils/three/CSS3DScene.js";
+import "../../CSS3DRenderPlugin/utils/getAllCSS3DObject.js";
+import "../../CSS3DRenderPlugin/utils/three/CSS3DGroup.js";
+import "@realsee/five";
+import "../../shared-utils/url/absoluteUrl.js";
+import "../../shared-utils/isTruelyObject.js";
+import "../../base/BasePlugin.js";
+import "../Assets/floorplanExtraObject.js";
+class we extends C {
+  constructor(t, e) {
+    super(t);
+    // =============== public properties =================
+    n(this, "name", "floorplanGuidePlugin");
+    n(this, "state");
+    // =============== protected properties =================
+    n(this, "data");
+    // =============== private properties =================
+    n(this, "app");
+    n(this, "wrapperSelector", "");
+    n(this, "wrapper", null);
+    n(this, "disposed", !1);
+    n(this, "extraObjects", []);
+    n(this, "highlightData", {});
+    n(this, "dispose", () => {
+      var t;
+      this.disposed = !0, (t = this.app) == null || t.$destroy(), this.wrapper = null, this.wrapperSelector = "", this.five.off("panoArrived", this.handlePanoArrived), this.hooks.emit("dispose");
+    });
+    n(this, "highlight", (t) => {
+      this.state.config.highlightEnable && (this.highlightData = t, this.render());
+    });
+    n(this, "unhighlight", () => {
+      this.highlightData = {}, this.render();
+    });
+    /**
+     * 处理户型图点击事件
+     * 寻找距离点击位置最近的观察点，并移动到该点
+     * @param clickData 点击事件数据
+     */
+    n(this, "handleFloorplanClick", (t) => {
+      var l;
+      const e = (l = this.data) == null ? void 0 : l.observers;
+      if (!e || e.length === 0) {
+        console.warn("No floorplan observers found");
+        return;
+      }
+      const i = t.imageX, s = t.imageY, r = t.floorIndex;
+      let h = null, p = 1 / 0;
+      e.forEach((c) => {
+        if (c.floorIndex !== r)
+          return;
+        const w = c.positionInImage.x, A = c.positionInImage.y, f = Math.sqrt(
+          Math.pow(i - w, 2) + Math.pow(s - A, 2)
+        );
+        f < p && (p = f, h = {
+          panoIndex: c.index,
+          // 使用observer.index作为panoIndex
+          distance: f,
+          observer: c
+        });
+      }), h ? this.five.emit("wantsToMoveToPano", h.panoIndex, {}, !0) || this.five.moveToPano(h.panoIndex) : console.warn("No suitable observer found on the same floor");
+    });
+    n(this, "_disable", (t) => {
+      var i;
+      const { userAction: e } = t;
+      (i = this.app) == null || i.$destroy(), this.app = void 0, this.hooks.emit("disable", { userAction: e });
+    });
+    n(this, "handlePanoArrived", () => {
+      var e, i;
+      const t = (i = (e = this.five.work.observers[this.five.getCurrentState().panoIndex]) == null ? void 0 : e.floorIndex) != null ? i : 0;
+      this.updateState({ displayedFloorIndex: t }, !0), this.render();
+    });
+    this.five = t;
+    const i = {
+      hoverEnable: !1,
+      highlightEnable: !1,
+      cameraImageUrl: O,
+      missingFloorImageUrl: F(e == null ? void 0 : e.staticPrefix, D),
+      clickEnable: !0,
+      roomLabelsEnable: !1,
+      roomNameEnable: !0,
+      roomNameOtherTypeEnable: !1,
+      roomAreaEnable: !0,
+      adaptiveRoomLabelVisibleEnable: !0,
+      getRoomAreaText: (r) => (r / 1e6).toFixed(1) + "㎡",
+      getLabelElement: void 0,
+      compassEnable: !1,
+      northDesc: "北",
+      compassHeight: 50,
+      observerDotSize: 12
+    }, s = d(d({}, i), e == null ? void 0 : e.configs);
+    this.state = { enabled: !0, visible: !0, config: s }, e != null && e.wrapper && console.warn("不推荐继续使用 params.selector 配置父容器，请使用 appendTo 方法"), typeof (e == null ? void 0 : e.wrapper) == "string" ? this.wrapperSelector = e.wrapper : (e == null ? void 0 : e.wrapper) instanceof Element && (this.wrapper = e.wrapper), t.once("dispose", this.dispose), t.on("panoArrived", this.handlePanoArrived);
+  }
+  load(t, e, i = !0) {
+    return m(this, null, function* () {
+      function s(l) {
+        return Object.prototype.hasOwnProperty.apply(l, ["version"]);
+      }
+      const r = JSON.parse(JSON.stringify(t)), h = s(r) ? r.data : r, p = this.data;
+      this.data = yield v(h), this.hooks.emit("dataLoaded", this.data), this.hooks.emit("dataChange", this.data, p), e && this.updateState(e, i), this.render();
+    });
+  }
+  show() {
+    return m(this, arguments, function* (t = {}) {
+      if (this.state.visible)
+        return;
+      const e = t.userAction !== void 0 ? t.userAction : !0;
+      this.updateState({ visible: !0 }, e), this._show({ userAction: e });
+    });
+  }
+  hide() {
+    return m(this, arguments, function* (t = {}) {
+      if (!this.state.visible)
+        return;
+      const e = t.userAction !== void 0 ? t.userAction : !0;
+      this.updateState({ visible: !1 }, e), this._hide({ userAction: e });
+    });
+  }
+  enable(t = {}) {
+    if (this.state.enabled)
+      return;
+    const e = t.userAction !== void 0 ? t.userAction : !0;
+    this.updateState({ enabled: !0 }, t.userAction || e), this._enable({ userAction: e });
+  }
+  disable(t = {}) {
+    if (!this.state.enabled)
+      return;
+    const e = t.userAction !== void 0 ? t.userAction : !0;
+    this.updateState({ enabled: !1 }, t.userAction || e), this._disable({ userAction: e });
+  }
+  /** 更改插件 State */
+  setState(t, e = {}) {
+    const i = this.state, s = e.userAction !== void 0 ? e.userAction : !0;
+    if (this.updateState(t, s), t.enabled !== void 0 && i.enabled !== t.enabled) {
+      const r = { userAction: s };
+      t.enabled ? this._enable(r) : this._disable(r);
+    }
+    if (t.visible !== void 0 && i.visible !== t.visible) {
+      const r = { userAction: s };
+      t.visible ? this._show(r) : this._hide(r);
+    }
+  }
+  /** 把插件的渲染DOM插入到对应的容器中去 */
+  appendTo(t) {
+    this.wrapper !== t && this.app && (this.app.$destroy(), this.app = void 0), this.wrapper = t, this.render();
+  }
+  changeConfigs(t, e = !0) {
+    this.setState({ config: t }, { userAction: e }), this.render();
+  }
+  setExtraObjectsWith3DPositions(t) {
+    this.data && (this.extraObjects = P(t, this.five, this.data), this.render());
+  }
+  /**
+   * 更改显示的楼层
+   * @param floorIndex 要显示的楼层索引
+   */
+  changeFloor(t) {
+    if (!this.data) {
+      console.warn("No floorplan data loaded");
+      return;
+    }
+    if (t < 0 || t >= this.data.floorDatas.length) {
+      console.warn(`Invalid floor index: ${t}. Available floors: 0-${this.data.floorDatas.length - 1}`);
+      return;
+    }
+    this.updateState({ displayedFloorIndex: t }, !0), this.render();
+  }
+  formatData(t) {
+    return m(this, null, function* () {
+      return yield v(t.data);
+    });
+  }
+  _enable(t) {
+    const { userAction: e } = t;
+    this.hooks.emit("enable", { userAction: e }), this.state.visible && this._show({ userAction: e });
+  }
+  _show(t) {
+    if (this.disposed || !this.state.enabled)
+      return;
+    const { userAction: e } = t;
+    this.hooks.emit("show", { userAction: e }), this.render();
+  }
+  _hide(t) {
+    if (this.disposed || !this.state.enabled)
+      return;
+    const { userAction: e } = t;
+    this.hooks.emit("hide", { userAction: e }), this.render();
+  }
+  updateState(t, e) {
+    const i = this.state, s = t.config ? d(d({}, i.config), t.config) : i.config;
+    this.state = b(d(d({}, this.state), t), { config: s }), !k(this.state, i, { deep: !0 }) && this.hooks.emit("stateChange", { state: this.state, prevState: i, userAction: e });
+  }
+  render() {
+    var r, h;
+    if (this.disposed || !this.state.enabled)
+      return;
+    if (!this.wrapper && this.wrapperSelector) {
+      const p = document.querySelector(this.wrapperSelector);
+      this.wrapper = p;
+    }
+    if (!this.data || !this.wrapper)
+      return;
+    const t = (h = (r = this.five.work.observers[this.five.getCurrentState().panoIndex]) == null ? void 0 : r.floorIndex) != null ? h : 0, e = this.state.displayedFloorIndex !== void 0 ? this.state.displayedFloorIndex : t, i = e === t, s = b(d({}, this.state.config), {
+      five: this.five,
+      floorplanData: this.data,
+      visible: this.state.visible,
+      extraObjects: this.extraObjects,
+      highlightData: this.highlightData,
+      displayedFloorIndex: e,
+      shouldShowRadar: i,
+      onFloorplanClick: this.state.config.clickEnable ? this.handleFloorplanClick : void 0
+    });
+    this.app ? this.app.$set(s) : this.app = new _({ target: this.wrapper, props: s });
+  }
+}
+export {
+  we as Controller
+};

package/libs/floorplan/FloorplanGuidePlugin/index.d.ts

@@ -0,0 +1,7 @@
+import type { Parameters } from './typing';
+import type { FivePlugin } from '@realsee/five';
+import { Controller } from './Controller';
+export declare const FloorplanGuidePlugin: FivePlugin<Parameters | undefined, Controller>;
+export type FloorplanGuidePluginParameterType = Parameters | undefined;
+export type FloorplanGuidePluginReturnType = InstanceType<typeof Controller>;
+export default FloorplanGuidePlugin;

package/libs/floorplan/FloorplanGuidePlugin/index.js

@@ -0,0 +1,99 @@
+import { Controller as t } from "./Controller.js";
+import "./Components/Main.js";
+import "../../vendor/svelte/internal/index.js";
+import "./Components/Camera.js";
+import "../Assets/camera.js";
+import "../../shared-utils/throttle.js";
+import "./Components/CurrentFloor/CurrentFloor.js";
+import "./Components/CurrentFloor/ExtraObjects.js";
+import "../Components/BaseImage.js";
+import "../Components/Normalmage.js";
+import "../Components/SvgImage.js";
+import "../Components/RoomHighlight/RoomHighlight.js";
+import "../Components/RoomHighlight/Room.js";
+import "../utils/formatPosition.js";
+import "./Components/ObserverDots.js";
+import "./Components/RoomLabels.js";
+import "../../shared-utils/svelte/resizeObserver.js";
+import "../../vendor/resize-observer-polyfill/dist/ResizeObserver.es.js";
+import "./Components/RoomLabelItem.js";
+import "./Components/FloorplanCompass.js";
+import "../Assets/compass.js";
+import "../../shared-utils/math/rad2Deg.js";
+import "../../shared-utils/tag.js";
+import "../../shared-utils/positionToVector3.js";
+import "three";
+import "../../shared-utils/five/vector3ToScreen.js";
+import "../../shared-utils/five/getFiveModel.js";
+import "../../shared-utils/Utils/FiveUtil.js";
+import "../../shared-utils/Utils/BaseUtil.js";
+import "../../shared-utils/Subscribe.js";
+import "../../shared-utils/Utils/WorkUtil.js";
+import "../../shared-utils/five/transformPosition.js";
+import "../../shared-utils/three/temp.js";
+import "../../shared-utils/three/core/Raycaster.js";
+import "../../shared-utils/dom/resizeObserver.js";
+import "../../shared-utils/five/fiveEveryReadyListener.js";
+import "../../vendor/hammerjs/hammer.js";
+import "../../shared-utils/three/PointSelector/index.js";
+import "../../shared-utils/three/PointSelector/utils/PointSelectorHelper.js";
+import "../../shared-utils/three/Magnifier.js";
+import "../../shared-utils/three/PointSelector/utils/PointHelper.js";
+import "../../shared-utils/three/Assets/index.js";
+import "../../CSS3DRenderPlugin/utils/three/CSS3DObject.js";
+import "../../shared-utils/even.js";
+import "../../shared-utils/CSS3DRender/OpacityMesh.js";
+import "../../shared-utils/three/centerPoint.js";
+import "../../shared-utils/three/getObjectVisible.js";
+import "../../shared-utils/three/CSS3DRenderer/index.js";
+import "../../CSS3DRenderPlugin/utils/generateBehindFiveElement.js";
+import "@realsee/five/line";
+import "../../shared-utils/isNil.js";
+import "../../shared-utils/three/core/Five_LineMaterial2.js";
+import "../../shared-utils/three/core/Sphere.js";
+import "../../vendor/animejs/lib/anime.es.js";
+import "../../vendor/@tweenjs/tween/dist/tween.esm.js.js";
+import "../../CSS3DRenderPlugin/utils/three/CSS3DRender.js";
+import "../../shared-utils/CSS3DRender/CSS3DRenderer.js";
+import "../../shared-utils/createResizeObserver.js";
+import "../../CSS3DRenderPlugin/utils/three/CSS3DScene.js";
+import "../../CSS3DRenderPlugin/utils/getAllCSS3DObject.js";
+import "../../shared-utils/util.js";
+import "../../CSS3DRenderPlugin/utils/three/CSS3DGroup.js";
+import "../../shared-utils/three/PointSelector/utils/html.js";
+import "../../shared-utils/CSS3DRender/index.js";
+import "../../shared-utils/five/fiveModelLoad.js";
+import "../../shared-utils/three/PointSelector/utils/PointHelper2.js";
+import "../../Sculpt/Meshes/Line.js";
+import "../../Sculpt/typings/style.js";
+import "../../shared-utils/three/IObject3D.js";
+import "../../Sculpt/utils/Meshes/getLengthHTML.js";
+import "../../shared-utils/three/applyObjectMatrixWorld.js";
+import "../../shared-utils/three/core/LineGeometry.js";
+import "../../shared-utils/three/core/LineMaterial.js";
+import "../../shared-utils/three/core/Line2.js";
+import "../../shared-utils/three/core/LineMaterial2.js";
+import "../../Sculpt/utils/unit.js";
+import "../../Sculpt/utils/renderDom.js";
+import "../../shared-utils/five/FivePuppet.js";
+import "@realsee/five";
+import "../../CSS3DRenderPlugin/utils/three/CSS3DSprite.js";
+import "../../shared-utils/isTouchDevice.js";
+import "../../shared-utils/five/getPosition.js";
+import "../../shared-utils/five/getRaycasterByNdcPosition.js";
+import "../../shared-utils/three/PointSelector/utils/contents.js";
+import "../../Sculpt/utils/three/rayOnLine.js";
+import "../../shared-utils/url/defaultUrls.js";
+import "../../shared-utils/url/replace-static-prefix.js";
+import "../../shared-utils/url/absoluteUrl.js";
+import "../../shared-utils/equal.js";
+import "../../shared-utils/isTruelyObject.js";
+import "../../base/BasePluginWithData.js";
+import "../../base/BasePlugin.js";
+import "../utils/formatData.js";
+import "../Assets/floorplanExtraObject.js";
+const So = (o, r) => new t(o, r);
+export {
+  So as FloorplanGuidePlugin,
+  So as default
+};

package/libs/floorplan/FloorplanGuidePlugin/typing.d.ts

@@ -0,0 +1,160 @@
+import type * as BasePlugin from '../../base/BasePluginWithData';
+import type { FloorplanData } from '../typings/floorplanData';
+import type { FloorplanServerData } from '../typings/floorplanServerData';
+import type { FloorplanRoomItem } from '../typings/floorplanData';
+export interface Config {
+    /**
+     * @description 鼠标放置在分间上时，是否要自动高亮分间
+     * @default false
+     */
+    hoverEnable: boolean;
+    /**
+     * @description 支持highlight功能
+     * @default false
+     */
+    highlightEnable: boolean;
+    /** 自定义「雷达」图标 */
+    cameraImageUrl: string;
+    /** 当前楼层图片不存在时，使用的占位图片 */
+    missingFloorImageUrl: string;
+    /**
+     * @description 是否启用点击事件
+     * @default false
+     */
+    clickEnable?: boolean;
+    /**
+     * @description 是否启用房间标签功能
+     * @default false
+     */
+    roomLabelsEnable?: boolean;
+    /**
+     * @description 是否显示房间名称
+     * @default true
+     */
+    roomNameEnable?: boolean;
+    /**
+     * @description 类型为其他分间名称是否展示
+     * @default true
+     */
+    roomNameOtherTypeEnable?: boolean;
+    /**
+     * @description 是否显示房间面积
+     * @default true
+     */
+    roomAreaEnable?: boolean;
+    /**
+     * @description 是否支持房屋标签自适应展示，默认为 true
+     * * 标签边框超过房间边框时，自动隐藏；不超过时自动展示。
+     * * 鼠标 hover 时，自动展示。
+     * @default true
+     */
+    adaptiveRoomLabelVisibleEnable?: boolean;
+    /**
+     * @description 自定义房间面积文本显示函数
+     * @param areaSize 房间面积，单位为平方毫米
+     * @default (size) => (size / 1000000).toFixed(1) + '㎡'
+     */
+    getRoomAreaText?: (areaSize: number) => string;
+    /**
+     * @description 分间标签的自定义函数，通过返回自定义 DOM 替换对应分间的标签
+     */
+    getLabelElement?: undefined | ((room: FloorplanRoomItem) => Element | null);
+    /**
+     * @description 是否启用指北针功能
+     * @default false
+     */
+    compassEnable?: boolean;
+    /**
+     * @description 指北针的显示文案
+     * @default '北'
+     */
+    northDesc?: string;
+    /**
+     * @description 指北针的高度
+     * @default 50
+     */
+    compassHeight?: number;
+    /**
+     * @description 观察点的大小（宽度等于高度）
+     * @default 12
+     */
+    observerDotSize?: number;
+}
+export interface State extends BasePlugin.State {
+    visible: boolean;
+    config: Config;
+    /** 当前显示的楼层索引，可能与 Five 的当前楼层不同 */
+    displayedFloorIndex?: number;
+}
+/** 点击事件数据 */
+export interface ClickEventData {
+    /** 归一化图像坐标 (0-1) */
+    imageX: number;
+    /** 归一化图像坐标 (0-1) */
+    imageY: number;
+    /** 点击的楼层索引 */
+    floorIndex: number;
+    /** 原始点击事件 */
+    originalEvent: MouseEvent;
+    /** 目标观察点索引 (当找到最近观察点时) */
+    targetPanoIndex?: number;
+    /** 到目标观察点的距离 (归一化图像坐标系中的距离, 0-1) */
+    targetDistance?: number;
+}
+export interface EventMap extends BasePlugin.EventMap<State, FloorplanData> {
+    /** 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;
+    /**
+     * 点击户型图的回调
+     * @param clickData 点击位置的详细信息
+     */
+    click: (clickData: ClickEventData) => void;
+}
+/** 插件初始化参数 */
+export interface Parameters extends Partial<Config> {
+    wrapper?: string | Element;
+    configs?: {
+        hoverEnable?: boolean;
+        cameraImageUrl?: string;
+        clickEnable?: boolean;
+        roomNameOtherTypeEnable?: boolean;
+        roomLabelsEnable?: boolean;
+        roomNameEnable?: boolean;
+        roomAreaEnable?: boolean;
+        adaptiveRoomLabelVisibleEnable?: boolean;
+        getRoomAreaText?: (size: number) => string;
+        compassEnable?: boolean;
+        northDesc?: string;
+        compassHeight?: number;
+        observerDotSize?: number;
+    };
+    /** 静态资源前缀，用于替换插件中使用到的固化资源 */
+    staticPrefix?: string;
+}
+export interface PluginServerData {
+    version: number;
+    data: FloorplanServerData;
+}
+export type { FloorplanData as PluginData };

package/libs/floorplan/FloorplanGuidePlugin/typing.js

@@ -0,0 +1 @@
+

package/libs/floorplan/index.d.ts

@@ -3,5 +3,6 @@ export * from './ModelFloorplanPlugin';
 export * from './MapviewFloorplanPlugin';
 export * from './TopviewFloorplanPlugin';
 export * from './PanoFloorplanRadarPlugin';
+export * from './FloorplanGuidePlugin';
 export * from './typings/floorplanServerData';
 export * from './typings/floorplanData';