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

package/CHANGELOG.md

@@ -1,4 +1,25 @@
 # CHANGELOG
+## 3.71.6
+
+- feat(PanoTagPlugin): 新增标签展开策略ScreenCenter
+
+## 3.71.5
+
+- chore(PanoTagPlugin): mesh 渲染的虚拟标签支持编辑
+
+## 3.71.4
+
+- feat(Object3DHelper): 支持拖拽时自定义位置结果，用来限制拖拽
+
+## 3.71.2
+
+- chore(five): 升级 five 版本
+
+## 3.71.1
+
+- feat(ModelMakerPlugin): 支持传入自定义颜色高亮标签以及扫光动画
+- feat(ModelMakerPlugin): 支持隐藏/显示部分或全部 item，扫光传入的颜色应用到面
+- feat(Utils.lookObject): 支持 minDistance 和 minLatitude
 
 ## 3.71.0
 
@@ -8,6 +29,14 @@
 
 - chore(MarketingTag): 调整商品标签的价格单位文案展示位置到价格后面
 
+## 3.70.9
+
+- fix(Sculpt): 修复 Prism 扫光在沙盘下消失的问题
+
+## 3.70.8
+
+- feat(Sculpt): 支持 Prism 进行扫光
+
 ## 3.70.7
 
 - fix(MapviewFloorplanPlugin, ModelFloorplanPlugin): 修复 Floorplan 插件初始 index 错误的问题

package/dist/ModelMakerPlugin/Controller.d.ts

@@ -2,6 +2,15 @@ import { type Five, type Mode as FiveMode } from '@realsee/five';
 import * as THREE from 'three';
 import * as BasePlugin from '../base/BasePluginWithData';
 import type { MarkerItem, State, ServerData, ItemType, ElementRenderer, EventMap } from './typings';
+/**
+ * 盒子动画配置选项
+ */
+export interface BoxAnimationConfig {
+    /** 动画颜色，默认为 #4DF0FF */
+    color?: string;
+    /** 是否在动画期间隐藏标签并在完成后缓动显示，默认为 false */
+    hideLabels?: boolean;
+}
 export declare class Controller extends BasePlugin.Controller<State, EventMap, ServerData, ServerData> {
     state: State;
     items: MarkerItem[];
@@ -16,6 +25,9 @@ export declare class Controller extends BasePlugin.Controller<State, EventMap, S
     private fiveEveryReadyListenerDisposer?;
     private originalOpacities;
     private originalTagOpacities;
+    private highlightedItem;
+    private originalTagStyles;
+    private originalModelColors;
     constructor(five: Five, config?: {
         tagContainerZIndex?: number;
         /**
@@ -39,14 +51,16 @@ export declare class Controller extends BasePlugin.Controller<State, EventMap, S
     /**
      * Force finish all active box animations immediately
      * @param id Optional box item ID. If not provided, finishes all active box animations.
+     * @param restoreLabels Whether to restore labels immediately. Defaults to true.
      */
-    forceFinishBoxAnimation(id?: string | number): void;
+    forceFinishBoxAnimation(id?: string | number, restoreLabels?: boolean): void;
     /**
      * Play the up-and-down animation for a box mesh
      * @param id Optional box item ID. If not provided, plays animation for all box items.
+     * @param config Animation configuration options
      * @returns Promise that resolves when all animations are complete
      */
-    playBoxAnimation(id?: string | number): Promise<void>;
+    playBoxAnimation(id?: string | number, config?: BoxAnimationConfig): Promise<void>;
     enable(): void;
     disable(): void;
     show(): void;
@@ -73,8 +87,73 @@ export declare class Controller extends BasePlugin.Controller<State, EventMap, S
      * @param itemTypes 模型类型数组
      */
     showItemsByType(itemTypes: ItemType[] | ItemType): void;
+    /**
+     * 根据条件隐藏模型项目
+     * @param condition 判断函数，返回 true 的项目将被隐藏
+     * @example
+     * // 隐藏所有 ID 大于 10 的项目
+     * controller.hideItemsByCondition(item => item.rawData.id > 10)
+     *
+     * // 隐藏所有红色的盒子
+     * controller.hideItemsByCondition(item =>
+     *   item.type === 'box' && item.rawData.object_data.color === '#FF0000'
+     * )
+     */
+    hideItemsByCondition(condition: (item: MarkerItem) => boolean): void;
+    /**
+     * 根据条件显示模型项目
+     * @param condition 判断函数，返回 true 的项目将被显示
+     * @example
+     * // 显示所有棱柱类型的项目
+     * controller.showItemsByCondition(item => item.type === 'prism')
+     *
+     * // 显示所有透明度大于 0.5 的项目
+     * controller.showItemsByCondition(item =>
+     *   (item.rawData.object_data.opacity ?? 0.4) > 0.5
+     * )
+     */
+    showItemsByCondition(condition: (item: MarkerItem) => boolean): void;
+    /**
+     * 根据条件设置模型项目的可见性
+     * @param condition 判断函数，返回 true 的项目将应用指定的可见性状态
+     * @param visible 是否可见，true 为显示，false 为隐藏
+     * @example
+     * // 隐藏所有小于指定面积的项目
+     * controller.setItemsVisibility(item => getItemArea(item) < 100, false)
+     *
+     * // 显示所有包含特定标签的项目
+     * controller.setItemsVisibility(item =>
+     *   item.rawData.label?.includes('important'), true
+     * )
+     */
+    setItemsVisibility(condition: (item: MarkerItem) => boolean, visible: boolean): void;
+    /**
+     * 显示所有模型项目
+     * @example
+     * // 恢复所有项目的可见性
+     * controller.showAllItems()
+     */
+    showAllItems(): void;
+    /**
+     * 隐藏所有模型项目
+     * @example
+     * // 隐藏所有项目
+     * controller.hideAllItems()
+     */
+    hideAllItems(): void;
     dispose(): void;
     protected onWorkCodeChange(): void;
+    /**
+     * 应用高亮样式到指定项目
+     * @param item 要高亮的项目
+     * @param color 高亮颜色
+     */
+    private applyHighlightStyles;
+    /**
+     * 移除指定项目的高亮样式
+     * @param item 要移除高亮的项目
+     */
+    private removeHighlightStyles;
     /**
      * 设置棱柱体模型的透明度
      * @param id 模型id
@@ -96,7 +175,32 @@ export declare class Controller extends BasePlugin.Controller<State, EventMap, S
     private handleDisable;
     private onFiveEveryReady;
     private updateTagRenderer;
+    /**
+     * 高亮指定的模型项目
+     * @param id 模型项目的ID
+     * @param color 高亮颜色，默认为 #FF7700
+     */
+    highlightItem(id: string | number, color?: string): void;
+    /**
+     * 重置所有高亮
+     */
+    resetHighlight(): void;
+    /**
+     * 获取当前高亮的项目ID
+     */
+    getHighlightedItemId(): string | number | null;
     getPrismItems(): MarkerItem[];
     getPolygonItems(): MarkerItem[];
     getBoxItems(): MarkerItem[];
+    /**
+     * 隐藏指定项目的标签
+     * @param items 要隐藏标签的项目数组
+     */
+    private hideItemLabels;
+    /**
+     * 缓动显示指定项目的标签
+     * @param items 要显示标签的项目数组
+     * @param duration 缓动持续时间（毫秒）
+     */
+    private easeInItemLabels;
 }

package/dist/ModelMakerPlugin/index.d.ts

@@ -1,5 +1,6 @@
 import type * as ModelMakerPluginType from './typings';
 import { Controller } from './Controller';
+import type { BoxAnimationConfig } from './Controller';
 export declare const ModelMakerPlugin: (five: import("@realsee/five").Five, config?: {
     tagContainerZIndex?: number;
     occlusionVisibility?: boolean | import("@realsee/five").Mode[];
@@ -7,3 +8,4 @@ export declare const ModelMakerPlugin: (five: import("@realsee/five").Five, conf
 }) => ModelMakerPluginType.ModelMakerController;
 export type { Controller as ModelMakerPluginInstance };
 export type { ModelMakerPluginType };
+export type { BoxAnimationConfig };

package/dist/PanoTagPlugin/controller/Tag/BaseTag.d.ts

@@ -11,6 +11,7 @@ import type TagContentSvelte from '../../Components/Tag/index.svelte';
 import type { PartialObjectDeep } from '../../../typings/typings';
 import type { LiteralUnion } from 'type-fest';
 import type { CSS3DObjectPlus } from '../../../shared-utils/CSS3DRender/CSS3DObject';
+import type { Rectangle } from '../../../Sculpt/Objects/Rectangle';
 /**
  * @description 标签实例
  * @property `id` 标签id
@@ -63,6 +64,7 @@ export declare abstract class BaseTag<C extends TagContentType = TagContentType,
     mediaPlane?: ImagePlane | VideoPlane;
     hooks: Subscribe<TagEvents<C>>;
     zIndex?: number;
+    manuallyOperated: boolean;
     play?: () => void;
     pause?: () => void;
     get five(): import("@realsee/five").Five;
@@ -82,6 +84,7 @@ export declare abstract class BaseTag<C extends TagContentType = TagContentType,
         currentNormal: THREE.Vector3;
         dispose: () => void;
     };
+    rectanglePlane?: Rectangle;
     dom?: HTMLDivElement;
     contentDom?: HTMLDivElement;
     initialConfig: TagData['config'];

package/dist/PanoTagPlugin/controller/Tag/PlaneTag.d.ts

@@ -2,14 +2,21 @@ import type PanoTagPluginController from '..';
 import type { Tag, TagContentType, Tag as TagData, TagInstance } from '../..';
 import { BaseTag } from './BaseTag';
 import type { PartialObjectDeep } from '../../../typings/typings';
+import type { Vector3 } from 'three';
+import { Rectangle } from '../../../Sculpt/Objects/Rectangle';
 export type PlaneTagInterface<C extends TagContentType = TagContentType> = TagInstance<C, 'Plane'>;
 export declare class PlaneTag<C extends TagContentType = TagContentType> extends BaseTag<C, 'Plane'> {
     constructor(plugin: PanoTagPluginController, tagData: TagData);
+    rectanglePlane?: Rectangle;
     applyVisible(): void;
     set(tag: PartialObjectDeep<Tag<C, 'Plane'>>, deepMerge?: boolean): void;
     setData(...data: Parameters<InstanceType<typeof BaseTag<C, 'Plane'>>['setData']>): void;
     private loadModel;
+    private initialSculpt;
+    editorEnable(): void;
+    editorDisable(position?: Vector3[]): void;
     private renderVideoPlane;
     private renderImagePlane;
-    computeNormal(): import("three").Vector3;
+    private renderEmptyPlane;
+    computeNormal(): Vector3;
 }

package/dist/PanoTagPlugin/typings/tag/TagConfig.d.ts

@@ -197,6 +197,14 @@ export interface TagConfig<C extends TagContentType = TagContentType> {
             enable?: boolean;
             /** 移动屏幕自动收起 */
             strategy?: 'FoldWhenMove';
+        } | {
+            enable?: boolean;
+            /** 屏幕中心自动展开 */
+            strategy?: 'ScreenCenter';
+            /** 展开的最大距离 */
+            distance?: MinMax;
+            /** 展开的最大数量 */
+            maxNumber?: number;
         };
     } | ConfigFunction;
     /** 初始状态 */

package/dist/PanoTagPlugin/utils/model/mediaPlane.d.ts

@@ -14,22 +14,30 @@ type ImageTexture = Overwrite<THREE.Texture, {
 declare abstract class MediaPlane extends THREE.Mesh<THREE.BufferGeometry | THREE.Geometry, THREE.MeshBasicMaterial> {
     name: string;
     src?: string;
+    objectFit: ObjectFit;
     removeFromParent(): this;
     dispose(): void;
 }
 declare class ImagePlane extends MediaPlane {
     name: string;
+    originRatio?: number;
     constructor(imageSrc: string, cornerPoints: Vector3[], params?: {
         objectFit?: ObjectFit;
         resolveZFighting?: boolean;
     });
+    changePointsOrParams(props: {
+        cornerPoints: Vector3[];
+        params?: {
+            objectFit?: ObjectFit;
+            resolveZFighting?: boolean;
+        };
+    }): void;
 }
 declare class VideoPlane extends MediaPlane {
     readonly isVideoPlane = true;
     name: string;
     videoInstance?: HTMLVideoElement;
     onVideoReady?: (videoInstance?: HTMLVideoElement) => void;
-    private objectFit;
     private buttonSrc;
     private videoCoverSrc?;
     private domEvents?;
@@ -63,5 +71,15 @@ declare class VideoPlane extends MediaPlane {
     private addButtonMesh;
     private getImageTexture;
     private getVideoTexture;
+    changePointsOrParams(props: {
+        cornerPoints: Vector3[];
+        params?: {
+            objectFit?: ObjectFit;
+        };
+    }): Promise<void>;
+    private updateAllMeshes;
+    private updateVideoMesh;
+    private updateCoverMesh;
+    private updateButtonMesh;
 }
 export { ImagePlane, VideoPlane };

package/dist/Sculpt/Meshes/Prism.d.ts

@@ -18,6 +18,7 @@ export interface PrismData extends AreaData {
 export declare class PrismMesh extends IObject3D {
     name: string;
     private five?;
+    private animatedBoxMesh?;
     private activeAnimations;
     private activeEaseInAnimations;
     get topPosition(): THREE.Vector3;
@@ -75,15 +76,21 @@ export declare class PrismMesh extends IObject3D {
     /**
      * 播放盒子上下动画
      * @param id 盒子项目ID
+     * @param color 动画颜色，默认为浅蓝色 (#4DF0FF)
      * @returns Promise，动画完成时解析
      */
-    playBoxAnimation(id: string | number): Promise<void>;
+    playBoxAnimation(id: string | number, color?: string): Promise<void>;
     /**
      * 强制立即完成所有活动的盒子动画
      * @param id 可选的盒子项目ID。如果未提供，完成所有活动的盒子动画。
      */
     forceFinishBoxAnimation(id?: string | number): void;
     private playEaseInAnimation;
+    /**
+     * 创建或更新动画盒子网格
+     * @param color 动画颜色
+     */
+    private createOrUpdateAnimatedBoxMesh;
     /**
      * 显示盒子模型的最终状态（完全可见且不透明度完整）
      */

package/dist/Sculpt/Objects/Polygon/Editor.d.ts

@@ -1,9 +1,14 @@
 import type { Polygon } from '.';
 import type { FiveDomEvent } from '../../../shared-utils/five/FiveDomEvents';
-import * as THREE from 'three';
 import { LineEditorAbstract } from '../Line/Editor';
 export declare class PolygonEditor extends LineEditorAbstract<Polygon> {
-    get points(): THREE.Vector3[];
+    get points(): import("three").Vector3[];
     constructor(originObject: Polygon);
+    /**
+     * 更新所有 PointMesh 的位置
+     */
+    updatePointMeshes(): void;
+    protected onDragstart: (event: FiveDomEvent) => void;
     protected onDrag: (event: FiveDomEvent) => void;
+    protected onDragend: (event: FiveDomEvent) => void;
 }

package/dist/Sculpt/Objects/Polygon/index.d.ts

@@ -18,6 +18,9 @@ export type PolygonCreateConfig = Partial<PolygonStyle & CreateLimitConfig & Pol
 export declare class Polygon extends BaseObject<PolygonImportData> {
     readonly type = "Polygon";
     areaMesh: AreaMesh;
+    private historyStack;
+    private currentHistoryIndex;
+    private maxHistorySize;
     get editor(): PolygonEditor;
     _editor: PolygonEditor;
     private creatingObject?;
@@ -39,6 +42,14 @@ export declare class Polygon extends BaseObject<PolygonImportData> {
     canRedo(): boolean;
     undo(): void;
     redo(): void;
+    /**
+     * 记录当前状态到历史记录
+     */
+    recordHistory(): void;
+    /**
+     * 恢复快照
+     */
+    private restoreSnapshot;
     create(params?: PolygonCreateConfig): Promise<void>;
 }
 export declare function createPolygon(areaMesh: AreaMesh, pointSelector: PointSelector, config?: PolygonCreateConfig): {

package/dist/Sculpt/Objects/Prism/index.d.ts

@@ -1,12 +1,19 @@
 import { BaseObject, type BaseImportData, type BaseObjectConfig } from '../Base';
+import * as THREE from 'three';
 import { PrismMesh, type PrismData, type PrismStyle } from '../../Meshes/Prism';
 import type { PointSelector } from '../../../shared-utils/three/PointSelector';
 import { PrismMeshEditor } from '../../Editors/PrismMeshEditor';
 import type { LiteralString } from '../../../typings/utils.type';
+import type { CreateLimitConfig, PolygonDrawConfig } from '../../typings/style';
 export interface PrismImportData extends BaseImportData, PrismData {
     type: LiteralString<'Prism'>;
     style?: Partial<PrismStyle>;
 }
+export type PrismCreateConfig = Partial<PrismStyle & CreateLimitConfig & PolygonDrawConfig> & {
+    onPointPlaced?: (points: THREE.Vector3[]) => void;
+    onUndo?: () => void;
+    onRedo?: () => void;
+};
 export declare class Prism extends BaseObject<PrismImportData> {
     readonly type = "Prism";
     prismMesh: PrismMesh;
@@ -27,6 +34,6 @@ export declare class Prism extends BaseObject<PrismImportData> {
     setData(data: Partial<PrismImportData>): void;
     highlight(): void;
     unhighlight(): void;
-    create(params?: Partial<PrismStyle>): Promise<void>;
+    create(params?: PrismCreateConfig): Promise<void>;
 }
-export declare function createPrism(prismMesh: PrismMesh, pointSelector: PointSelector): Promise<void>;
+export declare function createPrism(prismMesh: PrismMesh, pointSelector: PointSelector, config?: PrismCreateConfig): Promise<void>;

package/dist/Sculpt/index.d.ts

@@ -92,7 +92,12 @@ export declare class Sculpt extends Subscribe<Event> {
             style: {
                 color: number;
                 lineColor: number;
-                lineWidth: number;
+                lineWidth: number; /**
+                 * @description: 点击事件
+                 * @param {MouseEvent} e 鼠标事件
+                 * @param {BuiltInItem} item 点击的物体
+                 * 返回 false 来禁用 Five 默认行为
+                 */
             };
             id: string;
             type: string;
@@ -185,8 +190,8 @@ export declare class Sculpt extends Subscribe<Event> {
      * @description: 开始绘制 Box
      */
     createBox(...params: Parameters<Box['create']>): Promise<any>;
-    canUndo(): false | void;
-    canRedo(): false | void;
+    canUndo(): boolean | void;
+    canRedo(): boolean | void;
     /**
      * @description: 撤销
      */