@realsee/dnalogel 2.21.1 → 2.22.0-dev.0

package/dist/shared-utils/Object3DHelper/Base/BaseHelper.d.ts

@@ -1,15 +1,11 @@
 import type { Create3DElementReturnType } from '../../../CSS3DRenderPlugin';
 import type * as THREE from 'three';
-import { Group, Mesh, Object3D, Vector3 } from 'three';
+import type { Group, Mesh, Object3D } from 'three';
+import { Vector3 } from 'three';
 import type { Direction, Direction4 } from '../typings';
 import type { tipsDom } from '../Helper/HTML/tipsDom';
+import { IObject3D } from '../../three/IObject3D';
 type NonVoid<T> = T extends void ? never : T;
-declare class IObject3D extends Object3D {
-    constructor();
-    add(...objects: Object3D[]): this;
-    remove(...objects: Object3D[]): this;
-    removeFromParent(): this;
-}
 export declare abstract class BaseHelper<OriginObject3D extends Object3D = Object3D> extends IObject3D {
     protected originObject3D: OriginObject3D;
     protected onRender: () => any;

package/{libs/PanoMeasurePlugin/utils → dist/shared-utils}/getIntersectionFromEvent.d.ts

@@ -1,4 +1,4 @@
 import type Hammer from 'hammerjs';
 import type { Five, Intersection } from '@realsee/five';
 /** 通过鼠标事件或者触摸事件，获取当前点击屏幕关联的射线与模型的交点 */
-export declare function getIntersectionFromEvent(five: Five, event: typeof Hammer['Input']): Intersection[];
+export declare function getIntersectionFromEvent(five: Five, event: (typeof Hammer)['Input']): Intersection[];

package/dist/{PanoMeasurePlugin/utils → shared-utils}/getPointFromHammerEvent.d.ts

@@ -4,7 +4,7 @@ import { Vector2 } from 'three';
  * 从 Hammer 事件中获取操作的点在交互 DOM 中的位置
  * @ignore TODO: make a suitable name
  */
-export declare function getPointFromHammerEvent(event: typeof Hammer['Input']): {
+export declare function getPointFromHammerEvent(event: (typeof Hammer)['Input']): {
     point: Vector2;
     ndcPoint: Vector2;
 };

package/dist/shared-utils/isTouchDevice.d.ts

@@ -0,0 +1 @@
+export declare const isTouchDevice: boolean;

package/dist/shared-utils/safeObj.d.ts

@@ -0,0 +1 @@
+export default function safeObj<T = any>(object: T): NonNullable<Extract<T, Record<any, any>>>;

package/dist/shared-utils/three/IObject3D.d.ts

@@ -0,0 +1,7 @@
+import { Object3D } from 'three';
+export declare class IObject3D extends Object3D {
+    constructor();
+    add(...objects: Object3D[]): this;
+    remove(...objects: Object3D[]): this;
+    removeFromParent(): this;
+}

package/dist/shared-utils/three/Magnifier.d.ts

@@ -35,7 +35,12 @@ export declare class Magnifier {
     private hammer?;
     private state;
     constructor(five: Five, options: MagnifierParameter);
+    getCurrentState(): {
+        enabled: boolean;
+    };
     dispose(): void;
+    show(): this;
+    hide(): this;
     enable(): this;
     disable(): this;
     /** 把放大镜放到某一个容器中 */

package/dist/shared-utils/three/PointSelector.d.ts

@@ -0,0 +1,92 @@
+import type { Five, SubscribeEventMap } from '@realsee/five';
+import { Subscribe } from '@realsee/five';
+import { PointSelectorHelper, type PointIntersection } from './PointSelectorHelper';
+import { Vector3 } from 'three';
+interface Config {
+    /**
+     * @description: 选点的两种模式, 'fixed' 为固定选点为屏幕中心点，拖动five画布来更新点，'cursor' 为跟随鼠标移动来更新点, 'auto' 则根据设备类型自动选择
+     * @default: 'auto'
+     */
+    mode: 'fixed' | 'cursor' | 'auto';
+    pointSelectorHelperParams: ConstructorParameters<typeof PointSelectorHelper>[1];
+}
+interface EventMap extends SubscribeEventMap {
+    /**
+     * @description: 与模型交点更新时触发，移出监听范围时为null
+     * @param isAdhered 是否为吸附的点
+     */
+    intersectionUpdate: (intersection: PointIntersection | null, isAdhered?: boolean) => void;
+    /**
+     * @description: 试图打点，返回false则不打点
+     */
+    wantsSelect: (intersection: PointIntersection) => boolean | void;
+    select: (intersection: PointIntersection) => void;
+}
+/**
+ * @description: 在屏幕上选点
+ */
+export declare class PointSelector {
+    hook: Subscribe<EventMap>;
+    get position(): PointIntersection;
+    /**
+     * @description: 不在 five canvas 上时为 true
+     */
+    outOfFive: boolean;
+    private five;
+    private hammer?;
+    private mode;
+    private pointSelectorHelper;
+    private enabled;
+    /** 长按屏幕的动作触发后为true，手指抬起后为false */
+    private pressDown;
+    /** 一组吸附的点，光标靠近这些点时，会将helper以及放大镜的位置设置为这些点 */
+    private adherePoints;
+    /** 吸附点的半径 */
+    private adherePointsRadius;
+    constructor(five: Five, config?: Partial<Config>);
+    enable(): void;
+    disable(): void;
+    dispose(): void;
+    setAdherePoints(points: Vector3[] | Vector3 | null, radius?: number): void;
+    /**
+     * @description: 主动触发一次选点
+     * @return: select 是否成功
+     */
+    select: (intersection?: PointIntersection) => boolean;
+    /**
+     * @description: 鼠标进入five canvas时
+     */
+    private onEnter;
+    /**
+     * @description: 鼠标离开five canvas时
+     */
+    private onLeave;
+    private onTap;
+    /**
+     * 1. 如果之前没有长按行为「即没有长按点时」-> 滑动全景
+     * 2. 如果有长按点，把长按点位置更新为当前位置
+     */
+    private onPan;
+    /**
+     * @description: 长按屏幕后，更新长按点的位置
+     */
+    private onPress;
+    /**
+     * @description: 手指抬起后，重置pressDown状态
+     */
+    private onPanEnd;
+    private intersectionOnModelUpdate;
+    private updateByMousePosition;
+    /**
+     * @description: 根据鼠标位置更新helper位置
+     */
+    private updateByNdcPosition;
+    /**
+     * @description: 更新 pointSelectorHelper 的焦点位置
+     */
+    private updatePointSelectorHelperIntersect;
+    private onFiveWantsPanGesture;
+    private renderScreenCenter;
+    private emitIntersectionUpdate;
+}
+export {};

package/dist/shared-utils/three/PointSelectorHelper.d.ts

@@ -0,0 +1,41 @@
+import type { Five } from '@realsee/five';
+import { Subscribe } from '@realsee/five';
+import { Magnifier, PointHelper, PointDomHelper } from '.';
+import type { Intersection } from '../../typings/typings';
+interface Options {
+    magnifier: Magnifier | null;
+    magnifierParams: ConstructorParameters<typeof Magnifier>[1];
+    pointHelper: PointHelper | null;
+    pointDomHelper: PointDomHelper | null;
+}
+type EventMap = {
+    intersectionUpdate: (intersection: PointIntersection) => void;
+    /** 功能开启 */
+    enabled: () => void;
+    /** 功能关闭 */
+    disabled: () => void;
+};
+export interface PointIntersection extends Intersection {
+    isVirtual?: boolean;
+}
+export declare class PointSelectorHelper {
+    five: Five;
+    hooks: Subscribe<EventMap>;
+    position: PointIntersection | undefined;
+    magnifier: Magnifier | null;
+    private pointHelper;
+    private pointDomHelper;
+    private state;
+    private group;
+    constructor(five: Five, options?: Partial<Options>);
+    show: () => void;
+    hide: () => void;
+    enable(): void;
+    disable(): void;
+    dispose(): void;
+    updateWithIntersect: (intersect: Intersection, config?: {
+        emitEvent: boolean;
+    }) => void;
+    private abortUpdateMagnifier;
+}
+export {};

package/dist/shared-utils/three/index.d.ts

@@ -4,4 +4,4 @@ export * from './getRaycaster';
 export * from './getIntersect';
 export * from './PointHelper';
 export * from './PointDomHelper';
-export * from './FivePointSelector';
+export * from './PointSelectorHelper';

package/dist/typings/typings.d.ts

@@ -1,4 +1,5 @@
 import type * as THREE from 'three';
+import type { PartialDeep } from 'type-fest';
 export interface Intersection {
     /** 焦点坐标 */
     point: THREE.Vector3;
@@ -7,3 +8,6 @@ export interface Intersection {
         normal: THREE.Vector3;
     } | null;
 }
+export type PartialObjectDeep<ObjectType extends object> = {
+    [KeyType in keyof ObjectType]?: PartialDeep<ObjectType[KeyType]>;
+};