@realsee/dnalogel 2.0.2 → 2.1.0-alpha.10

package/dist/CSS3DRenderPlugin/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/dist/CSS3DRenderPlugin/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/dist/CSS3DRenderPlugin/PanoTagPlugin/utils/checkRange.d.ts

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

package/dist/CSS3DRenderPlugin/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/dist/CSS3DRenderPlugin/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/dist/CSS3DRenderPlugin/PanoTagPlugin/utils/noTypecheck.d.ts

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

package/dist/CSS3DRenderPlugin/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/dist/CSS3DRenderPlugin/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/dist/CSS3DRenderPlugin/PanoTagPlugin/utils/resizeObserver.d.ts

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

package/dist/CSS3DRenderPlugin/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/dist/CSS3DRenderPlugin/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/dist/CSS3DRenderPlugin/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/dist/CSS3DRenderPlugin/floorplan/MapviewFloorplanPlugin/Controller.d.ts

@@ -1,9 +1,8 @@
-import type { PartialDeep } from 'type-fest';
 import type { BaseOptions } from '../../base/BasePlugin';
 import type { Five } from '@realsee/five';
 import type { ShowState } from '../utils/correctFiveState';
 import type { FloorplanServerData } from '../typings/floorplanServerData';
-import type { State, Config, EventMap, ShowOptions, HideOptions, Parameters, PluginData, PluginServerData } from './typing';
+import type { State, EventMap, ShowOptions, HideOptions, Parameters, PluginData, PluginServerData } from './typing';
 import * as BasePlugin from '../../base/BasePluginWithData';
 export declare class Controller extends BasePlugin.Controller<State, EventMap, PluginServerData, PluginData> {
     name: string;
@@ -57,8 +56,7 @@ export declare class Controller extends BasePlugin.Controller<State, EventMap, P
     /** 隐藏户型图 */
     hide: (options?: Partial<HideOptions>) => Promise<void>;
     /** 更改插件 State */
-    setState(state: PartialDeep<State>, options?: BaseOptions): void;
-    changeConfigs(config: Partial<Config>, userAction?: boolean): void;
+    setState(state: Partial<State>, options?: BaseOptions): void;
     /** 更新户型图大小 */
     updateSize: () => void;
     /** 更新户型图位置 */

package/dist/CSS3DRenderPlugin/floorplan/MapviewFloorplanPlugin/typing.d.ts

@@ -1 +1,107 @@
-export * from '../typings';
+import type { FLOOR_PLAN_ATTACHED_TO } from '../constant';
+import type * as BasePlugin from '../../base/BasePluginWithData';
+import type { FloorplanServerData } from '../typings/floorplanServerData';
+import type { FloorplanData, FloorplanRoomItem } from '../typings/floorplanData';
+export interface State extends BasePlugin.State {
+    visible: boolean;
+    config: Config;
+}
+export interface Config {
+    /** 指北针的显示文案，默认为 '北' */
+    northDesc: string;
+    /** 户型图展示时，模型的透明度，默认为 1 */
+    modelOpacity: number;
+    /** 鼠标放置在分间上时，是否要自动高亮分间，默认为 true */
+    hoverEnable: boolean;
+    /** 是否要启用指北针功能，默认为 true */
+    compassEnable: boolean;
+    /** Five 切换到 Topview Mode 时，是否自动展示户型图，默认为 true */
+    autoShowEnable: boolean;
+    /** 是否要启用户型图分间标尺功能，默认为 true */
+    ruleLabelsEnable: boolean;
+    /** 是否要启用户型图分间标签功能，默认为 true */
+    roomLabelsEnable: boolean;
+    /** 自定义「雷达」图标 */
+    cameraImageUrl: string;
+    /** 计算户型图大小时，以模型的哪个高度为依据，默认为 BOUNDING_CENTER
+     * - FLOOR_PLAN_ATTACHED_TO.FLOOR: 户型图大小与模型的地板进行贴合
+     * - FLOOR_PLAN_ATTACHED_TO.CEILING: 户型图大小与模型的天花板进行贴合
+     * - FLOOR_PLAN_ATTACHED_TO.BOUNDING_CENTER: 户型图大小与模型的中心进行贴合
+     */
+    attachedTo: FLOOR_PLAN_ATTACHED_TO;
+    /** 分间标签的自定义函数，通过返回自定义 DOM 替换对应分间的标签 */
+    getLabelElement: undefined | ((room: FloorplanRoomItem) => Element | null);
+    /** 是否支持房屋标签自适应展示，默认为 true
+     * @description
+     * * 标签边框超过房间边框时，自动隐藏；不超过时自动展示。
+     * * 鼠标 hover 时，自动展示。
+     * */
+    adaptiveRoomLabelVisibleEnable: boolean;
+}
+export interface Parameters extends Partial<Config> {
+    selector?: string | Element;
+    scale?: number;
+}
+export interface ViewEvent {
+    /** 是否是用户滑动模型导致的户型图自动展示/消失 */
+    auto: boolean;
+    /** 是否是用户操作 */
+    userAction: boolean;
+}
+export interface EventMap extends BasePlugin.EventMap<State, FloorplanData> {
+    /**
+     * 展示结束的回调
+     * @param event.auto 是否是自动操作
+     * @param event.userAction 是否是用户操作
+     */
+    showAnimationEnded: (event: ViewEvent) => void;
+    /** visible 从 false 到 true 的回调
+     * @param event.userAction 是否是用户操作
+     */
+    show: (event: ViewEvent) => void;
+    /** visible 从 true 到 false 的回调
+     * @param event.auto 是否是自动操作
+     * @param event.userAction 是否是用户操作
+     */
+    hide: (event: ViewEvent) => void;
+    /** enabled 从 false 到 true 的回调
+     * @param event.userAction 是否是用户操作
+     */
+    enable: (event: {
+        userAction: boolean;
+    }) => void;
+    /** enabled 从 true 到 false 的回调
+     * @param event.userAction 是否是用户操作
+     */
+    disable: (event: {
+        userAction: boolean;
+    }) => void;
+    /**
+     * 点击户型图的回调
+     * @return 当返回 false 时，会阻止默认行为
+     */
+    click: () => boolean | void;
+}
+export interface PluginServerData extends BasePlugin.ServerData {
+    version: number;
+    data: FloorplanServerData;
+}
+export interface ShowOptions {
+    /** 展示户型图时，希望到达的楼层数 */
+    floorIndex: number;
+    /** 是否自动展示 */
+    isAutoShow: boolean;
+    /** 展示户型图时，模型透明度 */
+    modelOpacity: number;
+    /** 是否需要 opacity 动画 */
+    immediately: boolean;
+    /** 是否是用户操作 */
+    userAction: boolean;
+}
+export interface HideOptions {
+    /** 是否自动隐藏 */
+    isAutoHide: boolean;
+    /** 是否是用户操作 */
+    userAction: boolean;
+}
+export { FloorplanData as PluginData };

package/dist/CSS3DRenderPlugin/floorplan/ModelFloorplanPlugin/Controller.d.ts

@@ -1,4 +1,3 @@
-import type { PartialDeep } from 'type-fest';
 import type { BaseOptions } from '../../base/BasePlugin';
 import type { Five } from '@realsee/five';
 import type { ShowState } from '../utils/correctFiveState';
@@ -57,8 +56,8 @@ export declare class Controller extends BasePlugin.Controller<State, EventMap, P
     /** 隐藏户型图 */
     hide: (options?: Partial<HideOptions>) => Promise<void>;
     /** 更改插件 State */
-    setState(state: PartialDeep<State>, options?: BaseOptions): void;
-    changeConfigs(config: Partial<Config>, userAction?: boolean): void;
+    setState(state: Partial<State>, options?: BaseOptions): void;
+    changeConfigs(_config: Partial<Config>, userAction?: boolean): void;
     /** 更新户型图大小 */
     updateSize: () => void;
     protected formatData(serverData: PluginServerData): Promise<PluginData>;

package/dist/CSS3DRenderPlugin/floorplan/ModelFloorplanPlugin/typing.d.ts

@@ -1 +1,107 @@
-export * from '../typings';
+import type { FLOOR_PLAN_ATTACHED_TO } from '../constant';
+import type * as BasePlugin from '../../base/BasePluginWithData';
+import type { FloorplanServerData } from '../typings/floorplanServerData';
+import type { FloorplanData, FloorplanRoomItem } from '../typings/floorplanData';
+export interface State extends BasePlugin.State {
+    visible: boolean;
+    config: Config;
+}
+export interface Config {
+    /** 指北针的显示文案，默认为 '北' */
+    northDesc: string;
+    /** 户型图展示时，模型的透明度，默认为 1 */
+    modelOpacity: number;
+    /** 鼠标放置在分间上时，是否要自动高亮分间，默认为 true */
+    hoverEnable: boolean;
+    /** 是否要启用指北针功能，默认为 true */
+    compassEnable: boolean;
+    /** Five 切换到 Topview Mode 时，是否自动展示户型图，默认为 true */
+    autoShowEnable: boolean;
+    /** 是否要启用户型图分间标尺功能，默认为 true */
+    ruleLabelsEnable: boolean;
+    /** 是否要启用户型图分间标签功能，默认为 true */
+    roomLabelsEnable: boolean;
+    /** 自定义「雷达」图标 */
+    cameraImageUrl: string;
+    /** 计算户型图大小时，以模型的哪个高度为依据，默认为 BOUNDING_CENTER
+     * - FLOOR_PLAN_ATTACHED_TO.FLOOR: 户型图大小与模型的地板进行贴合
+     * - FLOOR_PLAN_ATTACHED_TO.CEILING: 户型图大小与模型的天花板进行贴合
+     * - FLOOR_PLAN_ATTACHED_TO.BOUNDING_CENTER: 户型图大小与模型的中心进行贴合
+     */
+    attachedTo: FLOOR_PLAN_ATTACHED_TO;
+    /** 分间标签的自定义函数，通过返回自定义 DOM 替换对应分间的标签 */
+    getLabelElement: undefined | ((room: FloorplanRoomItem) => Element | null);
+    /** 是否支持房屋标签自适应展示，默认为 true
+     * @description
+     * * 标签边框超过房间边框时，自动隐藏；不超过时自动展示。
+     * * 鼠标 hover 时，自动展示。
+     * */
+    adaptiveRoomLabelVisibleEnable: boolean;
+}
+export interface Parameters extends Partial<Config> {
+    selector?: string | Element;
+    scale?: number;
+}
+export interface ViewEvent {
+    /** 是否是用户滑动模型导致的户型图自动展示/消失 */
+    auto: boolean;
+    /** 是否是用户操作 */
+    userAction: boolean;
+}
+export interface EventMap extends BasePlugin.EventMap<State, FloorplanData> {
+    /**
+     * 展示结束的回调
+     * @param event.auto 是否是自动操作
+     * @param event.userAction 是否是用户操作
+     */
+    showAnimationEnded: (event: ViewEvent) => void;
+    /** visible 从 false 到 true 的回调
+     * @param event.userAction 是否是用户操作
+     */
+    show: (event: ViewEvent) => void;
+    /** visible 从 true 到 false 的回调
+     * @param event.auto 是否是自动操作
+     * @param event.userAction 是否是用户操作
+     */
+    hide: (event: ViewEvent) => void;
+    /** enabled 从 false 到 true 的回调
+     * @param event.userAction 是否是用户操作
+     */
+    enable: (event: {
+        userAction: boolean;
+    }) => void;
+    /** enabled 从 true 到 false 的回调
+     * @param event.userAction 是否是用户操作
+     */
+    disable: (event: {
+        userAction: boolean;
+    }) => void;
+    /**
+     * 点击户型图的回调
+     * @return 当返回 false 时，会阻止默认行为
+     */
+    click: () => boolean | void;
+}
+export interface PluginServerData extends BasePlugin.ServerData {
+    version: number;
+    data: FloorplanServerData;
+}
+export interface ShowOptions {
+    /** 展示户型图时，希望到达的楼层数 */
+    floorIndex: number;
+    /** 是否自动展示 */
+    isAutoShow: boolean;
+    /** 展示户型图时，模型透明度 */
+    modelOpacity: number;
+    /** 是否需要 opacity 动画 */
+    immediately: boolean;
+    /** 是否是用户操作 */
+    userAction: boolean;
+}
+export interface HideOptions {
+    /** 是否自动隐藏 */
+    isAutoHide: boolean;
+    /** 是否是用户操作 */
+    userAction: boolean;
+}
+export { FloorplanData as PluginData };

package/dist/CSS3DRenderPlugin/floorplan/TopviewFloorplanPlugin/Controller.d.ts

@@ -1,8 +1,7 @@
-import type { PartialDeep } from 'type-fest';
 import type { BaseOptions } from '../../base/BasePlugin';
 import type { Five } from '@realsee/five';
 import type { FloorplanServerData } from '../typings/floorplanServerData';
-import type { State, Config, EventMap, Parameters, PluginData, PluginServerData } from './typing';
+import type { State, 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;
@@ -39,8 +38,7 @@ export declare class Controller extends BasePlugin.Controller<State, EventMap, P
     /** 销毁插件 */
     dispose: () => void;
     /** 更改插件 State */
-    setState(state: PartialDeep<State>, options?: BaseOptions): void;
-    changeConfigs(config: Partial<Config>, userAction?: boolean): void;
+    setState(state: Partial<State>, options?: BaseOptions): void;
     protected formatData(serverData: PluginServerData): Promise<PluginData>;
     private _show;
     private _hide;

package/dist/CSS3DRenderPlugin/floorplan/TopviewFloorplanPlugin/typing.d.ts

@@ -1,11 +1,86 @@
-import type * as FloorplanPlugin from '../typings';
-export * from '../typings';
-export interface Config extends FloorplanPlugin.Config {
+import type { FLOOR_PLAN_ATTACHED_TO } from '../constant';
+import type * as BasePlugin from '../../base/BasePluginWithData';
+import type { FloorplanServerData } from '../typings/floorplanServerData';
+import type { FloorplanData, FloorplanRoomItem } from '../typings/floorplanData';
+export interface Config {
+    /** 指北针的显示文案，默认为 '北' */
+    northDesc: string;
+    /** 户型图展示时，模型的透明度，默认为 1 */
+    modelOpacity: number;
+    /** 鼠标放置在分间上时，是否要自动高亮分间，默认为 true */
+    hoverEnable: boolean;
     /** 是否开启放大缩小和拖动功能，默认为 false */
     gestureEnable: boolean;
-    /** 点击房间时，是否阻止跳转到被点房间的全景态点位上，默认为 false */
+    /** 是否要启用指北针功能，默认为 true */
+    compassEnable: boolean;
+    /** Five 切换到 Topview Mode 时，是否自动展示户型图，默认为 true */
+    autoShowEnable: boolean;
+    /** 是否要启用户型图分间标尺功能，默认为 true */
+    ruleLabelsEnable: boolean;
+    /** 是否要启用户型图分间标签功能，默认为 true */
+    roomLabelsEnable: boolean;
+    /** 自定义「雷达」图标 */
+    cameraImageUrl: string;
+    /** 点击房间时，是否需要跳转到被点房间的全景态点位上，默认为 true */
     preventRoomClick?: boolean;
+    /** 计算户型图大小时，以模型的哪个高度为依据，默认为 BOUNDING_CENTER
+     * - FLOOR_PLAN_ATTACHED_TO.FLOOR: 户型图大小与模型的地板进行贴合
+     * - FLOOR_PLAN_ATTACHED_TO.CEILING: 户型图大小与模型的天花板进行贴合
+     * - FLOOR_PLAN_ATTACHED_TO.BOUNDING_CENTER: 户型图大小与模型的中心进行贴合
+     */
+    attachedTo: FLOOR_PLAN_ATTACHED_TO;
+    /** 分间标签的自定义函数，通过返回自定义 DOM 替换对应分间的标签 */
+    getLabelElement: undefined | ((room: FloorplanRoomItem) => Element | null);
+    /** 是否支持房屋标签自适应展示，默认为 true
+     * @description
+     * * 标签边框超过房间边框时，自动隐藏；不超过时自动展示。
+     * * 鼠标 hover 时，自动展示。
+     * */
+    adaptiveRoomLabelVisibleEnable: boolean;
 }
-export interface State extends FloorplanPlugin.State {
+export interface State extends BasePlugin.State {
+    visible: boolean;
     config: Config;
 }
+export interface EventMap extends BasePlugin.EventMap<State, FloorplanData> {
+    /** 展示结束的回调
+     * @param event.userAction 是否是用户操作
+     */
+    showAnimationEnded: (event: {
+        userAction: boolean;
+    }) => void;
+    /** 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;
+}
+/** 插件初始化参数 */
+export interface Parameters extends Partial<Config> {
+    selector?: string | Element;
+    scale?: number;
+}
+export interface PluginServerData extends BasePlugin.ServerData {
+    version: number;
+    data: FloorplanServerData;
+}
+export { FloorplanData as PluginData };

package/dist/CSS3DRenderPlugin/index.d.ts

@@ -1,4 +1,5 @@
-import CSS3DRenderPlugin from './Plugin';
-export { CSS3DRenderPlugin };
+import type { FivePlugin } from '@realsee/five';
+import Controller from './Controller';
+export * from './typing';
+export declare const CSS3DRenderPlugin: FivePlugin<void, InstanceType<typeof Controller>>;
 export default CSS3DRenderPlugin;
-export type { CSS3DRenderPluginExportType } from './Plugin';