@realsee/dnalogel 2.19.1 → 2.20.0-alpha.0

package/dist/PanoTagPlugin/Archive/deprecated.d.ts

@@ -1,3 +1,4 @@
+import type { StickType, TagContentType, TagInstance } from '../typings';
 /**  @deprecated 改用具体的string */
 export declare enum PointType {
     PointTag = "PointTag",
@@ -16,7 +17,9 @@ export type DeprecatedTagProperty = {
 export type DeprecatedMediaPlaneProperty = {
     /**
      * @description stretch: 拉伸适配, proportional: 等比适配，默认值 'proportional'
-     * @deprecated replaced by objectFit
+     * @deprecated Use {@link ObjectFit} instead
      */
     adaptationMode?: 'stretch' | 'proportional';
 };
+/**  @deprecated Use {@link TagInstance} instead */
+export type TagElement<C extends TagContentType = TagContentType, S extends StickType = StickType> = TagInstance<C, S>;

package/dist/PanoTagPlugin/controller/TagComputer.d.ts

@@ -1,6 +1,6 @@
 import type { Five, Mode } from '@realsee/five';
 import * as THREE from 'three';
-import type { Tag, TagElement } from '../typings';
+import type { TagInstance } from '../typings';
 import type { Raycaster } from 'three';
 import { TagUtil } from './TagUtil';
 export declare abstract class TagComputer extends TagUtil {
@@ -9,25 +9,25 @@ export declare abstract class TagComputer extends TagUtil {
     /**
      * @description: 获取是否可见
      */
-    getVisibleByPanoIndex(tag: Tag<any, any>, panoIndex?: number): boolean;
-    getVisibleByFiveMode(tag: TagElement<any, any>, mode?: Mode): boolean;
+    getVisibleByPanoIndex(tag: TagInstance, panoIndex?: number): boolean;
+    getVisibleByFiveMode(tag: TagInstance, mode?: Mode): boolean;
     /**
      * @description 获取标签当前状态
      * @return (this.state.visible && tag.state.visible) ?? true
      */
-    getCurrentVisibleState(tag: TagElement<any, any>): boolean;
-    getVisible(tag: TagElement<any, any>): boolean;
+    getCurrentVisibleState(tag: TagInstance): boolean;
+    getVisible(tag: TagInstance): boolean;
     /** 获取当前点位上模型中的多媒体是否应该展示 */
-    getModelMedialVisibleByPanoIndex(tag: TagElement<any, any>): boolean;
+    getModelMedialVisibleByPanoIndex(tag: TagInstance): boolean;
     /**
      * @description: 获取是否展开
      */
-    getUnfoldedByPanoIndex(tag: TagElement<any>, panoIndex?: number): boolean;
+    getUnfoldedByPanoIndex(tag: TagInstance, panoIndex?: number): boolean;
     /**
      * @description: 获取是否展开
      */
-    getUnfoldedByCamera(tag: TagElement<any, any>): boolean;
-    protected sort<T extends Tag<any, any>>(tags: T[]): T[];
+    getUnfoldedByCamera(tag: TagInstance): boolean;
+    protected sort<T extends TagInstance>(tags: T[]): T[];
     /**
      * @description: 一个点的标签
      */
@@ -39,18 +39,18 @@ export declare abstract class TagComputer extends TagUtil {
     /**
      * @description: 一个点的标签
      */
-    protected getTagProject(tag: TagElement<any, any>): {
+    protected getTagProject(tag: TagInstance): {
         x: number;
         y: number;
         z: number;
     };
     /** 通过射线检测标签可用性 */
-    protected getTagEnableByIntersect(tag: Tag<any, any>, raycaster: Raycaster): {
+    protected getTagEnableByIntersect(tag: TagInstance, raycaster: Raycaster): {
         value: boolean;
         reason: string;
     };
     /** 获取点位看向标签的射线 */
-    protected getRaycasterFromPanoIndex(tag: Tag, panoIndex: number): THREE.Raycaster;
+    protected getRaycasterFromPanoIndex(tag: TagInstance, panoIndex: number): THREE.Raycaster;
     /** 检测是否匹配当前楼层 */
     private getVisibleByFloorIndex;
 }

package/dist/PanoTagPlugin/controller/TagRender.d.ts

@@ -1,9 +1,9 @@
 import { TagComputer } from './TagComputer';
-import type { Tag, TagElement, TagGLTFObject, TagObjectGroup, TagGLTFObjectGroup, ImagePlaneGroup } from '../typings';
+import type { Tag, TagInstance, TagGLTFObject, TagObjectGroup, TagGLTFObjectGroup, ImagePlaneGroup, TagContentType } from '../typings';
 import type { TemporaryState } from '../typings';
-import { Object3D } from 'three';
+import { type Object3D } from 'three';
 import TagContainerSvelte from '../Components/TagContainer.svelte';
-import { Five } from '@realsee/five';
+import type { Five } from '@realsee/five';
 export declare abstract class TagRender extends TagComputer {
     protected group: TagObjectGroup;
     protected imagePlaneGroup: ImagePlaneGroup;
@@ -41,7 +41,7 @@ export declare abstract class TagRender extends TagComputer {
      * @param tag 标签
      * @param model 模型
      */
-    protected updateTagCss3DObjectMatrix<S extends 'Model' | 'Plane' = 'Model'>(tag: TagElement<any, S>, model: Object3D): void;
+    protected updateTagCss3DObjectMatrix<S extends 'Model' | 'Plane' = 'Model'>(tag: TagInstance<TagContentType, S>, model: Object3D): void;
     /** 添加模型标签 */
     protected addMediaModelTag(tags: Tag[]): Promise<void>;
     /**
@@ -55,5 +55,5 @@ export declare abstract class TagRender extends TagComputer {
      */
     protected clearUnusedPanelTag(): void;
     /** 加载外部模型 */
-    protected loadModel: (tag: TagElement<'Model', 'Model'> | TagElement<'MediaModel', 'Model'>) => Promise<TagGLTFObject>;
+    protected loadModel: (tag: TagInstance<'Model', 'Model'> | TagInstance<'MediaModel', 'Model'>) => Promise<TagGLTFObject>;
 }

package/dist/PanoTagPlugin/controller/TagUtil.d.ts

@@ -1,21 +1,21 @@
-import type { TagElement, TagContentType, StickType, TagId, TagConfig, PlaneTag, MediaStore } from '../typings';
+import type { TagInstance, TagContentType, StickType, TagId, TagConfig, PlaneTag, MediaStore } from '../typings';
 import * as THREE from 'three';
-import type { Tag, Tags, Point2DElement, Point3DElement, PlaneTagElement, PointTagElement, Point3DTag, ModelElement } from '../typings';
+import type { Tag, Tags, PointTagInstance, Point3DTag } from '../typings';
 import { TagCache } from './TagCache';
 import type { CSS3DRenderPluginExportType } from '../../CSS3DRenderPlugin';
 import type { Five } from '@realsee/five';
 import { FiveDomEvents } from '../../shared-utils/five/FiveDomEvents';
 export declare abstract class TagUtil extends TagCache {
-    tags: TagElement[];
+    tags: TagInstance[];
     config: Pick<Tags, 'globalConfig' | 'contentTypeConfig'>;
     protected mediaStore: MediaStore;
     /** css3DRenderPlugin */
     protected css3DRenderPlugin?: CSS3DRenderPluginExportType;
     protected store: {
         /** 清理函数数组 */
-        disposers: (() => any)[];
+        disposers: (() => void)[];
         visibleWithAnimation?: boolean;
-        css3DRenderDisposer: Map<TagId, (() => any)[]>;
+        css3DRenderDisposer: Map<TagId, (() => void)[]>;
         eventListenerDisposer?: () => void;
         resizeObserverDisposer?: () => void;
         resizeObserverDisposerAdding: boolean;
@@ -25,20 +25,20 @@ export declare abstract class TagUtil extends TagCache {
     protected domEvents: FiveDomEvents;
     private mouseInfo?;
     protected constructor(five: Five);
-    getTagById<C extends TagContentType = any, S extends StickType = any>(id: TagId): TagElement<C, S> | undefined;
+    getTagById<C extends TagContentType = TagContentType, S extends StickType = StickType>(id: TagId): TagInstance<C, S> | undefined;
     /** 暂停当前标签内进行的所有多媒体 */
     pauseCurrentMedia(): void;
     /**
      * @description: 获取merge后的配置
      * TODO: 缓存
      */
-    getTagConfig(tag: Tag<any, any>): TagConfig<"Model" | "Custom" | "Audio" | "Text" | "ImageText" | "Image" | "Video" | "Link" | "Sticker" | "VRLink" | "PanoLink" | "Marketing" | "MediaPlane" | "MediaModel" | "Unknown", StickType>;
+    getTagConfig(tag: Tag): TagConfig<"Model" | "Custom" | "Audio" | "Text" | "ImageText" | "Image" | "Video" | "Link" | "Sticker" | "VRLink" | "PanoLink" | "Marketing" | "MediaPlane" | "MediaModel" | "Unknown">;
     protected loadVideoFirstFrame(): void;
     protected updateTagConfig(params?: {
         force?: boolean;
     }): void;
-    protected can<T extends TagElement<any, any>>(action: 'show' | 'hide' | 'fold' | 'unfold', paramsTag: T): boolean;
-    protected getRenderType(tag: TagElement<any, any>): 'Dom' | 'Mesh' | 'BehindDom';
+    protected can<T extends Tag>(action: 'show' | 'hide' | 'fold' | 'unfold', paramsTag: T): boolean;
+    protected getRenderType(tag: TagInstance): 'Dom' | 'Mesh' | 'BehindDom';
     /**
      * @description: 获取角度
      */
@@ -46,18 +46,18 @@ export declare abstract class TagUtil extends TagCache {
     /**
      * @description: 获取距离
      */
-    protected getDistance(tag: Tag<any, any>, panoIndex?: number): number;
-    protected getPositions(tag: TagElement<any, any>): any;
+    protected getDistance(tag: TagInstance, panoIndex?: number): number;
+    protected getPositions(tag: TagInstance): [THREE.Vector3, THREE.Vector3, THREE.Vector3, THREE.Vector3] | [import("../typings").ArrayPosition, import("../typings").ArrayPosition, import("../typings").ArrayPosition, import("../typings").ArrayPosition];
     protected preventWhenMouseDown: () => false | void;
-    protected addObjectClickHandler(tag: TagElement<any, any>, object: THREE.Object3D | undefined, handler: (event: Event) => any): () => void;
-    protected getTagNormal(tag: TagElement<any, 'Plane'> | TagElement<any, 'Model'> | TagElement<any, '3DPoint'>): THREE.Vector3;
-    protected get filterPointTag(): PointTagElement[];
-    protected get filter2DPointTag(): Point2DElement[];
-    protected get filter3DPointTag(): Point3DElement[];
-    protected get filterImagePlane(): PlaneTagElement<"MediaPlane">[];
-    protected get filterMediaModel(): ModelElement<"MediaModel">[];
-    protected get filterModelTag(): ModelElement[];
-    protected get filterCSS3DTag(): (TagElement<any, "Plane"> | TagElement<any, "Model"> | TagElement<any, "3DPoint">)[];
+    protected addObjectClickHandler(tag: TagInstance, object: THREE.Object3D | undefined, handler: (event: Event) => any): () => void;
+    protected getTagNormal(tag: TagInstance): THREE.Vector3 | undefined;
+    protected get filterPointTag(): PointTagInstance[];
+    protected get filter2DPointTag(): TagInstance<"Model" | "Custom" | "Audio" | "Text" | "ImageText" | "Image" | "Video" | "Link" | "Sticker" | "VRLink" | "PanoLink" | "Marketing" | "MediaPlane" | "MediaModel" | "Unknown", "2DPoint">[];
+    protected get filter3DPointTag(): TagInstance<"Model" | "Custom" | "Audio" | "Text" | "ImageText" | "Image" | "Video" | "Link" | "Sticker" | "VRLink" | "PanoLink" | "Marketing" | "MediaPlane" | "MediaModel" | "Unknown", "3DPoint">[];
+    protected get filterImagePlane(): TagInstance<"MediaPlane", "Plane">[];
+    protected get filterMediaModel(): TagInstance<"MediaModel", "Model">[];
+    protected get filterModelTag(): TagInstance<"Model" | "Custom" | "Audio" | "Text" | "ImageText" | "Image" | "Video" | "Link" | "Sticker" | "VRLink" | "PanoLink" | "Marketing" | "MediaPlane" | "MediaModel" | "Unknown", "Model">[];
+    protected get filterCSS3DTag(): (TagInstance<"Model" | "Custom" | "Audio" | "Text" | "ImageText" | "Image" | "Video" | "Link" | "Sticker" | "VRLink" | "PanoLink" | "Marketing" | "MediaPlane" | "MediaModel" | "Unknown", "Plane"> | TagInstance<"Model" | "Custom" | "Audio" | "Text" | "ImageText" | "Image" | "Video" | "Link" | "Sticker" | "VRLink" | "PanoLink" | "Marketing" | "MediaPlane" | "MediaModel" | "Unknown", "Model"> | TagInstance<"Model" | "Custom" | "Audio" | "Text" | "ImageText" | "Image" | "Video" | "Link" | "Sticker" | "VRLink" | "PanoLink" | "Marketing" | "MediaPlane" | "MediaModel" | "Unknown", "3DPoint">)[];
     /**
      * @description 检查是否已经销毁
      * @returns isDisposed; 已经销毁返回 true，否则返回 false

package/dist/PanoTagPlugin/controller/index.d.ts

@@ -1,7 +1,7 @@
-import type { Tag, PartialDeep, TagId, Tags, TagElement, State, AddTagConfig, LoadTagConfig, ContentTypeConfigKey, TagConfig } from '../typings';
+import type { Tag, TagId, Tags, TagInstance, State, AddTagConfig, LoadTagConfig, ContentTypeConfigKey, TagConfig, PartialObjectDeep } from '../typings';
 import type { PickTagContentTypeInContentTypeConfigKey, TagContentType } from '..';
 import type { ArrayPosition } from '../typings';
-import { Five } from '@realsee/five';
+import { type Five } from '@realsee/five';
 import { TagRender } from './TagRender';
 export declare const pluginFlag: (name: string) => string;
 declare class PanoTagPluginController extends TagRender {
@@ -25,7 +25,7 @@ declare class PanoTagPluginController extends TagRender {
     /**
      * @description: 添加标签
      */
-    addTag(tag: Tag<any, any> | Tag<any, any>[], paramsConfig?: AddTagConfig): Promise<void>;
+    addTag(tag: Tag | Tag[], paramsConfig?: AddTagConfig): Promise<void>;
     /**
      * @description: 改变配置
      */
@@ -69,23 +69,23 @@ declare class PanoTagPluginController extends TagRender {
     /**
      * @description: 改变data
      */
-    changeDataById<C extends TagContentType = any>(id: TagId, data: PartialDeep<Tag<C>['data']>, deepMerge?: boolean): void;
+    changeDataById<C extends TagContentType = TagContentType>(id: TagId, data: PartialObjectDeep<Tag<C>['data']>, deepMerge?: boolean): void;
     /**
      * @description: 改变tag的stickType
      */
-    changeStickTypeById<C extends TagContentType = any>(id: TagId, data: PartialDeep<{
+    changeStickTypeById<C extends TagContentType = TagContentType>(id: TagId, data: PartialObjectDeep<{
         [P in keyof Pick<Tag<C>, 'stickType' | 'position' | 'normal' | 'data'>]: Tag[P];
     }>, deepMerge?: boolean): void;
     /**
      * @description: 改变tag任意属性
      */
-    changeTagById<C extends TagContentType = any>(id: TagId, tag: PartialDeep<Tag<C>>, deepMerge?: boolean): void;
+    changeTagById<C extends TagContentType = TagContentType>(id: TagId, tag: PartialObjectDeep<Tag<C>>, deepMerge?: boolean): void;
     /**
      * @description: 销毁tag
      */
     destroyTagById(id: TagId | TagId[]): void;
     /** 更改 tag 模型 */
-    changeTagModel: (tag: TagElement<any, 'Model'>, data: PartialDeep<Tag<'MediaModel'>['data']>) => Promise<void>;
+    changeTagModel: (tag: TagInstance<'Model', 'Model'> | TagInstance<'MediaModel', 'Model'>, data: PartialObjectDeep<Tag<'MediaModel'>['data']>) => Promise<void>;
     /**
      * @description: 设置 visible 和 unfolded
      */

package/dist/PanoTagPlugin/typings/controller.d.ts

@@ -25,22 +25,22 @@ export interface EventMap extends BasePlugin.EventMap<State> {
         event: Event;
     } & ({
         target: 'TagPoint';
-        tag: PointTagElement<any>;
+        tag: PointTagInstance;
     } | {
         target: 'TagContent';
-        tag: TagElement<any, any>;
+        tag: TagInstance;
     } | {
         target: 'AudioTagPlayIcon';
-        tag: TagElement;
+        tag: TagInstance;
         audioInstance: HTMLAudioElement;
     } | {
         target: 'TagModel';
-        tag: TagElement<'Model', 'Model'> | TagElement<'MediaModel', 'Model'>;
+        tag: TagInstance<'Model', 'Model'> | TagInstance<'MediaModel', 'Model'>;
     })) => void;
     playStateChange: (params: {
         event: Event;
         state: 'playing' | 'paused';
-        tag: TagElement;
+        tag: TagInstance;
         mediaInstance: HTMLMediaElement;
     }) => void;
     exposure: (params: {
@@ -82,8 +82,8 @@ export interface TagCacheInterface {
         reason?: string;
     };
 }
-export type TagElement<C extends TagContentType = TagContentType, S extends StickType = StickType> = Tag<C, S> & Partial<{
-    pointTagStyle: {
+export type TagInstance<C extends TagContentType = TagContentType, S extends StickType = StickType> = Tag<C, S> & Partial<{
+    screenPosition: {
         leftPercent: number;
         topPercent: number;
     } | null;
@@ -113,7 +113,7 @@ export type TagElement<C extends TagContentType = TagContentType, S extends Stic
         unfolded: boolean;
     };
     hooks: Subscribe<TagEvents>;
-    mergedConfig: TagConfig<C, S>;
+    mergedConfig: TagConfig<C>;
     unfold: () => void;
     fold: () => void;
     enable: () => void;
@@ -123,9 +123,5 @@ export type TagElement<C extends TagContentType = TagContentType, S extends Stic
 export type MediaStore = Writable<{
     currentMediaElement: HTMLMediaElement | null;
 }>;
-export type PointTagElement<C extends TagContentType = TagContentType> = TagElement<C, '3DPoint' | '2DPoint'>;
-export type PlaneTagElement<C extends TagContentType = TagContentType> = TagElement<C, 'Plane'>;
-export type Point2DElement<C extends TagContentType = TagContentType> = TagElement<C, '2DPoint'>;
-export type Point3DElement<C extends TagContentType = TagContentType> = TagElement<C, '3DPoint'>;
-export type ModelElement<C extends TagContentType = TagContentType> = TagElement<C, 'Model'>;
+export type PointTagInstance<C extends TagContentType = TagContentType> = TagInstance<C, '3DPoint' | '2DPoint'>;
 export {};

package/dist/PanoTagPlugin/typings/index.d.ts

@@ -3,4 +3,5 @@ export * from './tag/Tag';
 export * from './tag/Utils';
 export * from './tag/TagData';
 export * from './tag/TagConfig';
-export type { PartialDeep } from 'type-fest';
+export * from '../Archive/deprecated';
+export type { ContentTypeMap, TagContentType } from './tag/TagData';

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

@@ -1,10 +1,8 @@
 import type { State as FiveState } from '@realsee/five';
 import type { TagConfig } from './TagConfig';
-import { type ContentTypeMap, ContentType, type TagContentType } from './TagData';
+import type { ContentTypeMap, TagContentType } from './TagData';
 import type { Position, TagId, StickType, TagStyle, ElementRenderer, PickTagContentTypeInContentTypeConfigKey, ContentTypeConfigKey } from './Utils';
-import { type DeprecatedTagProperty } from '../../Archive/deprecated';
-export type { ContentTypeMap, TagContentType };
-export { ContentType };
+import type { DeprecatedTagProperty } from '../../Archive/deprecated';
 export interface Tags {
     version?: string;
     /** tag配置 > 按type配置 > 全局配置 */
@@ -15,13 +13,13 @@ export interface Tags {
         [key in ContentTypeConfigKey]?: PickTagContentTypeInContentTypeConfigKey<key> extends TagContentType ? TagConfig<PickTagContentTypeInContentTypeConfigKey<key>> : unknown;
     };
     /** 标签列表配置 */
-    tagList: Tag<any, any>[];
+    tagList: Tag[];
 }
 export type Tag<C extends TagContentType = TagContentType, S extends StickType = StickType> = DeprecatedTagProperty & {
     /** 开启/禁用 */
     enabled?: boolean;
     /** 唯一标识 */
-    id: TagId;
+    id?: TagId;
     /** @type {StickType} 附着方式 */
     stickType: S;
     /** @type {TagContentType} 内容类型，根据内容类型展示对应UI */
@@ -35,9 +33,9 @@ export type Tag<C extends TagContentType = TagContentType, S extends StickType =
     /** 标签 wrapper 的 classname */
     className?: string;
     /** 标签数据 */
-    data: C extends TagContentType ? ContentTypeMap[C] : ContentTypeMap[keyof ContentTypeMap];
+    data?: C extends TagContentType ? ContentTypeMap[C] : ContentTypeMap[keyof ContentTypeMap];
     /** 「展开/收起」 「可见/不可见」 的策略配置 */
-    config?: TagConfig<C, S>;
+    config?: TagConfig<C>;
     /** 打标签时的 five state */
     fiveState?: FiveState;
     /** 样式 */

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

@@ -1,10 +1,20 @@
 import type { Create3DDomContainerParamsType } from '../../../CSS3DRenderPlugin/Controller';
 import type { Five, Mode } from '@realsee/five';
 import type { ContentTypeMap, TagContentType } from './TagData';
-import type { Tag } from './Tag';
-import type { MinMax, StickType } from './Utils';
+import type { MinMax } from './Utils';
 import type { PartialDeep } from 'type-fest';
-export interface TagConfig<C extends TagContentType = TagContentType, S extends StickType = StickType> {
+import type { TagInstance } from '../controller';
+type PartialObjectDeep<ObjectType extends object> = {
+    [KeyType in keyof ObjectType]?: PartialDeep<ObjectType[KeyType]>;
+};
+type ConfigFunction<C extends TagContentType = TagContentType> = (five: Five, tagState: {
+    tag: TagInstance<C>;
+    /** 标签点或中心点的到摄像机的距离 */
+    distance: number;
+    /** 3D标签中 「标签所在平面或垂直于标签法线的平面」 与 「摄像机到标签点或中心点的向量」 的夹角 */
+    angleRange?: number;
+}) => boolean;
+export interface TagConfig<C extends TagContentType = TagContentType> {
     /** 显示/隐藏配置 */
     visibleConfig?: {
         /**
@@ -61,13 +71,7 @@ export interface TagConfig<C extends TagContentType = TagContentType, S extends
          * @default undefined
          */
         angleRange?: MinMax;
-    } | ((five: Five, tagState: {
-        tag: Tag<C, S>;
-        /** 标签点或中心点的到摄像机的距离 */
-        distance: number;
-        /** 3D标签中 「标签所在平面或垂直于标签法线的平面」 与 「摄像机到标签点或中心点的向量」 的夹角 */
-        angleRange?: number;
-    }) => boolean);
+    } | ConfigFunction<C>;
     /** 展开/收起配置 */
     unfoldedConfig?: {
         /** 保持展开/收起，设置后unfoldedConfig下所有其他配置都不生效 */
@@ -108,13 +112,7 @@ export interface TagConfig<C extends TagContentType = TagContentType, S extends
             /** 展开的最大距离, 默认为无限制 */
             distance?: MinMax;
         };
-    } | ((five: Five, tagState: {
-        tag: Tag<C, S>;
-        /** 标签点或中心点的到摄像机的距离 */
-        distance: number;
-        /** 3D标签中 「标签所在平面或垂直于标签法线的平面」 与 「摄像机到标签点或中心点的向量」 的夹角 */
-        angleRange?: number;
-    }) => boolean);
+    } | ConfigFunction<C>;
     /** 初始状态 */
     initialState?: {
         /** 显示/隐藏 */
@@ -122,7 +120,7 @@ export interface TagConfig<C extends TagContentType = TagContentType, S extends
         /** 展开/收起 */
         unfolded?: boolean;
     };
-    initialData?: PartialDeep<ContentTypeMap[C]>;
+    initialData?: PartialObjectDeep<ContentTypeMap[C]>;
     tag3DConfig?: Create3DDomContainerParamsType['config'];
     modelConfig?: {
         autoLookAtEnabled?: boolean;
@@ -131,3 +129,4 @@ export interface TagConfig<C extends TagContentType = TagContentType, S extends
     renderType?: 'Mesh' | 'Dom';
     clickable?: false;
 }
+export {};

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

@@ -1,4 +1,4 @@
-import { type DeprecatedMediaPlaneProperty } from '../../Archive/deprecated';
+import type { DeprecatedMediaPlaneProperty } from '../../Archive/deprecated';
 import type { Position, TagIconUrl } from './Utils';
 export type MediaData = {
     type: 'Image';
@@ -10,6 +10,7 @@ export type MediaData = {
 };
 export type ObjectFit = 'fill' | 'contain' | 'cover' | 'none' | 'scale-down';
 type Object = Record<string | number | symbol, any>;
+/** @deprecated Use {@link TagContentType} instead */
 export declare enum ContentType {
     /** 音频标签 */
     Audio = "Audio",

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

@@ -1,13 +1,17 @@
 import type { GLTFObject } from '@realsee/five/gltf-loader';
 import type { Group } from 'three';
-import type { Tag } from './Tag';
 import type { TagContentType } from './TagData';
 import type { ImagePlane } from '../../utils/model/mediaPlane';
+import type { TagInstance } from '../controller';
+import type { PartialDeep } from 'type-fest';
 export type TagId = string | number;
 export type ArrayPosition = number[];
 export type Position = ArrayPosition;
 export type PanoIndex = number;
 export type WorkCode = string;
+export type PartialObjectDeep<ObjectType extends object> = {
+    [KeyType in keyof ObjectType]?: PartialDeep<ObjectType[KeyType]>;
+};
 export interface MinMax {
     min?: number;
     max?: number;
@@ -62,21 +66,21 @@ export interface ImagePlaneGroup extends Group {
  * @description S: 18; M: 20; L: 24; XL: 28
  */
 export type TagIconSize = 'S' | 'M' | 'L' | 'XL' | number;
-export type AudioAppearance = Tag<'Audio'>['data']['appearance'];
+export type AudioAppearance = TagInstance<'Audio'>['data']['appearance'];
 export type AudioTagTypeConfigKey = `${StickType | 'Any'}-Audio-${AudioAppearance}`;
 export type ContentTypeConfigKey = `${StickType | 'Any'}-${TagContentType | 'Any'}` | TagContentType | AudioTagTypeConfigKey;
 /**
- * @description: 从 ContentTypeConfigKey 中提取 ContentTypeConfigKey 对应的 ContentType 是啥，没找到就是 never
+ * @description: 从 ContentTypeConfigKey 中提取 ContentTypeConfigKey 对应的 TagContentType 是啥，没找到就是 never
  */
 export type PickTagContentTypeInContentTypeConfigKey<T extends ContentTypeConfigKey> = T extends `${any}-Audio-${any}` ? 'Audio' : T extends `${any}-${infer C}` ? C : T extends TagContentType ? T : never;
 export type ContentTypeConfigKeySplit = [StickType | 'Any', TagContentType | 'Any'] | [TagContentType] | [StickType | 'Any', 'Audio', AudioAppearance];
-export type PointTag<C extends TagContentType = TagContentType> = Tag<C, '2DPoint' | '3DPoint'>;
+export type PointTag<C extends TagContentType = TagContentType> = TagInstance<C, '2DPoint' | '3DPoint'>;
 /** 二维标签 */
-export type Point2DTag<C extends TagContentType = TagContentType> = Tag<C, '2DPoint'>;
+export type Point2DTag<C extends TagContentType = TagContentType> = TagInstance<C, '2DPoint'>;
 /** 三维标签 */
-export type Point3DTag<C extends TagContentType = TagContentType> = Tag<C, '3DPoint'>;
+export type Point3DTag<C extends TagContentType = TagContentType> = TagInstance<C, '3DPoint'>;
 /** 三维贴片 */
-export type PlaneTag<C extends TagContentType = TagContentType> = Tag<C, 'Plane'>;
+export type PlaneTag<C extends TagContentType = TagContentType> = TagInstance<C, 'Plane'>;
 /** @deprecated 'Tag2D' replaced by pointType: 'Point2DTag' */
 export type Tag2D<C extends TagContentType = TagContentType> = Point2DTag<C>;
 /** @deprecated 'Tag3D' replaced by pointType: 'Point3DTag' */

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

@@ -1,8 +1,8 @@
 import * as THREE from 'three';
 import { Vector3 } from 'three';
-import { type ObjectFit } from '../../typings';
-import DomEvents from '../../../shared-utils/threex/domevents';
-import { type Overwrite } from '../../../typings/utils.type';
+import type { ObjectFit } from '../../typings';
+import type DomEvents from '../../../shared-utils/threex/domevents';
+import type { Overwrite } from '../../../typings/utils.type';
 type Src = string;
 type VideoTexture = Overwrite<THREE.VideoTexture, {
     image: HTMLVideoElement;
@@ -50,7 +50,7 @@ declare class VideoPlane extends MediaPlane {
     play(muted?: boolean): Promise<void>;
     pause(): void;
     initialDomEvents(domEvents: DomEvents): void;
-    initialRenderHooks(func: (render: () => void) => () => any): void;
+    initialRenderHooks(func: (render: () => void) => () => void): void;
     private showPlayUI;
     private showPauseUI;
     private render;

package/dist/PanoTagPlugin/utils/resizeObserver.d.ts

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

package/dist/PanoTagPlugin/utils/tag/tagCheck.d.ts

@@ -1,11 +1,11 @@
-import type { PlaneTagElement, Tag, TagElement } from '../../typings';
-export declare function isPointTag(tag: Tag<any, any>): boolean;
-export declare function isPlaneTag(tag: Tag<any, any>): tag is PlaneTagElement;
-export declare function isPoint2DTag(tag: Tag<any, any>): boolean;
-export declare function isPoint3DTag(tag: Tag<any, any>): boolean;
-export declare function is2DTag(tag: Tag<any, any>): boolean;
-export declare function is3DTag(tag: Tag<any, any>): tag is Tag<any, '3DPoint'> | Tag<any, 'Plane'>;
-export declare function isMediaModelTag(tag: Tag<any, any>): tag is Tag<'MediaModel', 'Model'>;
-export declare function isModelTag(tag: Tag<any, any>): tag is Tag<'Model', 'Model'>;
-export declare function isStickModelTag(tag: Tag<any, any>): tag is TagElement<'Model', 'Model'> | TagElement<'MediaModel', 'Model'>;
-export declare function isMediaPlaneTag(tag: Tag<any, any>): tag is Tag<'MediaModel', 'Model'>;
+import type { TagContentType, TagInstance } from '../../typings';
+export declare function isPointTag(tag: TagInstance): boolean;
+export declare function isPlaneTag<T extends TagContentType>(tag: TagInstance<T>): tag is TagInstance<T, 'Plane'>;
+export declare function isPoint2DTag(tag: TagInstance): boolean;
+export declare function isPoint3DTag<T extends TagContentType>(tag: TagInstance<T>): tag is TagInstance<T, '3DPoint'>;
+export declare function is2DTag(tag: TagInstance): boolean;
+export declare function is3DTag<T extends TagContentType>(tag: TagInstance): tag is TagInstance<T, '3DPoint'> | TagInstance<T, 'Plane'>;
+export declare function isMediaModelTag(tag: TagInstance): tag is TagInstance<'MediaModel', 'Model'>;
+export declare function isModelTag(tag: TagInstance): tag is TagInstance<'Model', 'Model'>;
+export declare function isStickModelTag(tag: TagInstance): tag is TagInstance<'Model', 'Model'> | TagInstance<'MediaModel', 'Model'>;
+export declare function isMediaPlaneTag(tag: TagInstance): tag is TagInstance<'MediaModel', 'Model'>;

package/dist/PanoTagPlugin/utils/tagPosition.d.ts

@@ -1,5 +1,5 @@
 import { Vector3 } from 'three';
 import { type AnyPosition } from '.';
-import type { Tag } from '../typings';
+import type { TagInstance } from '../typings';
 export declare function tagPosition(position: AnyPosition | [AnyPosition, AnyPosition, AnyPosition, AnyPosition]): Vector3;
-export declare function getTagPosition(tag: Tag): Vector3;
+export declare function getTagPosition(tag: TagInstance): Vector3;