@realsee/dnalogel 3.81.13 → 4.0.0-webgpu.4

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

@@ -0,0 +1,165 @@
+import { Position, TagIconUrl } from './Utils.js';
+export type MediaData = {
+    type: 'Image';
+    url: string;
+    /**
+     * @description 缩略图
+     */
+    thumbnail?: string;
+} | {
+    type: 'Video';
+    url: string;
+    videoCoverUrl?: string;
+};
+export type ObjectFit = 'fill' | 'contain' | 'cover' | 'none' | 'scale-down';
+type Object = Record<string | number | symbol, any>;
+export type TagContentType = keyof ContentTypeMapInterface;
+/**
+ * @description 标签数据
+ */
+export interface ContentTypeMapInterface {
+    /** 文字标签 */
+    Text: {
+        appearance?: 'line' | 'plane';
+        title?: string;
+        description?: string;
+        /**
+         * @description description 最大行数, null不限制
+         * @default: null
+         */
+        descriptionMaxRows?: number | null;
+        /**
+         * @description title 最大行数, null不限制
+         * @default: null
+         */
+        titleMaxRows?: number | null;
+        edit?: {
+            title?: {
+                inputting?: boolean;
+                placeholder?: string;
+            };
+            description?: {
+                inputting?: boolean;
+                placeholder?: string;
+            };
+        };
+    };
+    /** 音频标签 */
+    Audio: {
+        title?: string;
+        /** @description 'line' 是旧的那种有一条线的，默认为'line', 'plane' 是新的那种圆形的 */
+        appearance?: 'line' | 'plane';
+        theme?: 'dark' | 'light';
+        audioUrl: string;
+    };
+    /** 图文标签 */
+    ImageText: {
+        title?: string;
+        mediaData: (MediaData & {
+            name?: string;
+        })[];
+    };
+    /** 图片标签 */
+    Image: ContentTypeMapInterface['ImageText'];
+    /** 视频标签 */
+    Video: ContentTypeMapInterface['ImageText'];
+    /** 全景标签 */
+    Panorama: ContentTypeMapInterface['ImageText'];
+    /** 跳转外链标签 */
+    Link: {
+        title?: string;
+        icon?: TagIconUrl;
+    };
+    /** VR跳转标签 */
+    VRLink: ContentTypeMapInterface['Link'];
+    /** 贴纸标签 */
+    Sticker: ContentTypeMapInterface['Link'];
+    /** 全景跳转标签 */
+    PanoLink: ContentTypeMapInterface['Link'];
+    /** 营销标签 */
+    Marketing: {
+        /** 标题 */
+        title: string;
+        /** 高亮的标签 */
+        brandTags?: string[];
+        /** 普通标签 */
+        tags?: string[];
+        /** 头部宣传图 */
+        headerPictureUrl?: string;
+        /** 跳转文字 */
+        highlightText?: string;
+        /** 主题 */
+        theme?: 'dark' | 'light';
+        /** 限制营销标签大小 */
+        limitWidth?: boolean | number;
+        /** 价格 */
+        price?: {
+            value: string | number;
+            /** 单位 */
+            unit: string;
+        };
+        /** 卡片内媒体（需 config.popoverConfig.showMedia 为 true 时展示） */
+        mediaData?: (MediaData & {
+            name?: string;
+        })[];
+    };
+    /** 营销贴片 */
+    MediaPlane: {
+        enableCarousel?: boolean;
+        /** 多媒体在容器中的适配规则 {@link https://developer.mozilla.org/zh-CN/docs/Web/CSS/object-fit} */
+        objectFit?: ObjectFit;
+        autoplayConfig?: {
+            /**
+             * @description 是否自动播放视频
+             * @default autoplayVideo: false
+             */
+            autoplayVideo?: boolean;
+            /**
+             * @description 是否自动轮播
+             * @default autoplayCarousel: true
+             */
+            autoplayCarousel?: boolean;
+            /**
+             * @description 轮播中遇到视频是否要自动播放
+             * @default autoplayVideoInCarousel: false
+             */
+            autoplayVideoInCarousel?: boolean;
+            /**
+             * @description 因不可见（超出可见距离或被遮挡）停播后，重新可见时是否从头重播。
+             * 开启后会重置播放进度并抢占音频焦点尝试有声播放，
+             * 有声被浏览器自动播放策略拒绝时回退静音播放。
+             * 仅对停播前处于播放态的标签生效。
+             * @default false
+             */
+            replayWhenRevisible?: boolean;
+        };
+        mediaData: MediaData[];
+        /** @description 暂停时的播放按钮url */
+        playIcon?: 'withText' | 'withoutText' | string;
+    };
+    MediaModel: {
+        modelUrl: string;
+        mediaData: MediaData[];
+        mediaPosition: [Position, Position, Position, Position];
+        /** 多媒体在容器中的适配规则 {@link https://developer.mozilla.org/zh-CN/docs/Web/CSS/object-fit} */
+        objectFit?: ObjectFit;
+    };
+    Model: {
+        modelUrl: string;
+    };
+    /** 虚拟模型：空间三维对象，渲染同 Model（裸模型），支持自动转向用户 */
+    VirtualObject: {
+        modelUrl: string;
+    };
+    Custom: Object;
+    Unknown: Object;
+}
+type ContentTypeMapInterfaceWithExtraData = {
+    [key in keyof ContentTypeMapInterface]: ContentTypeMapInterface[key] & {
+        extraData?: Object;
+    } & {
+        [key: string]: any;
+    };
+};
+export type ContentTypeMap = Pick<ContentTypeMapInterfaceWithExtraData, TagContentType>;
+export {};

package/dist/types/PanoTagPlugin/typings/tag/TagInstance.d.ts

@@ -0,0 +1,8 @@
+import { TagContentType } from './TagData.js';
+import { StickType } from './Utils.js';
+import { BaseTag } from '../../controller/Tag/BaseTag.js';
+import { Tag } from '../../index.js';
+import { Overwrite } from '../../../typings/utils.type.js';
+export type TagInstance<C extends TagContentType = TagContentType, S extends StickType = StickType> = Overwrite<Tag<C, S>, BaseTag<C, S>> & {
+    [key: string]: any;
+};

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

@@ -0,0 +1,156 @@
+import { GLTFObject } from '@realsee/five-webgpu/gltf-loader';
+import { Group } from 'three/webgpu';
+import { TagContentType } from './TagData.js';
+import { ImagePlane } from '../../utils/model/mediaPlane.js';
+import { TagInstance, TagConfig } from '../../index.js';
+import { Mode } from '@realsee/five-webgpu';
+import { LiteralUnion } 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 ModelId = string;
+export interface MinMax {
+    min?: number;
+    max?: number;
+}
+export type StickType = '2DPoint' | '3DPoint' | 'Plane' | 'Model' | '3DBox' | 'Polygon' | 'Mask' | 'Fusion';
+/**
+ * 3DBox 位置定义
+ */
+export interface BoxPosition {
+    /** 起始点坐标 [x, y, z] */
+    start: ArrayPosition;
+    /** 结束点坐标 [x, y, z] */
+    end: ArrayPosition;
+    /** 旋转角度 [x, y, z]（欧拉角） */
+    rotation: ArrayPosition;
+}
+/** 3DBox 标签 */
+export type BoxTag<C extends TagContentType = TagContentType> = TagInstance<C, '3DBox'>;
+/**
+ * Polygon 位置定义
+ * 多边形由多个点组成，至少需要 3 个点
+ */
+export type PolygonPosition = ArrayPosition[];
+/** Polygon 标签 */
+export type PolygonTag<C extends TagContentType = TagContentType> = TagInstance<C, 'Polygon'>;
+/**
+ * Mask 位置定义
+ * Mask 标签的 position 由 mask 图和 color 计算得出，类型为普通的 Position
+ */
+export type MaskPosition = Position;
+/** Mask 标签 */
+export type MaskTag<C extends TagContentType = TagContentType> = TagInstance<C, 'Mask'>;
+/**
+ * @description 标签 icon 动画配置
+ */
+export interface TagIconAnimationConfig {
+    duration: number;
+    elements: {
+        selector?: string;
+        properties: {
+            translateX?: number[];
+            translateY?: number[];
+            rotate?: number[];
+            scale?: number[];
+            opacity?: number[];
+        };
+    }[];
+    loop: boolean;
+    loopInterval?: number;
+    timing?: 'linear' | 'ease' | 'ease-in' | 'ease-out' | 'ease-in-out';
+}
+export interface TagIconUrl {
+    url?: string;
+    /** 背景色 */
+    bgcolor?: string;
+    /** 背景透明度 */
+    bgopacity?: number;
+    /** 是否使用默认 tag point，默认为 true */
+    enabled?: boolean;
+    /** 指切图是几倍图，如 2倍图, 3倍图，默认值为 3 */
+    ratio?: number;
+    /** 期望渲染在屏幕上的宽度，如果指定了scale，则最终渲染在屏幕上的宽度 = width * scale */
+    width?: number;
+    /** 缩放值。默认为1，如果指定了scale，则最终渲染在屏幕上的宽度 = width * scale */
+    scale?: number;
+    /** 横向精灵图的帧数；大于 1 时播放，animation 优先。 */
+    steps?: number;
+    /** 精灵图播放帧率，默认 24。 */
+    fps?: number;
+    /** 帧动画配置 */
+    animation?: TagIconAnimationConfig;
+    /** 标签法线长度 */
+    normalLen?: number;
+}
+export interface TagStyle {
+    /** 小圆点样式 */
+    point?: {} & TagIconUrl;
+    /** 3D Box 和Polygon样式 */
+    boxOrpolygon?: {
+        /** 填充颜色（十六进制） */
+        color?: number;
+        /** 填充透明度 0-1 */
+        opacity?: number;
+        /** 线条颜色（十六进制） */
+        lineColor?: number;
+        /** 线条宽度 */
+        lineWidth?: number;
+    };
+    /** Mask 标签样式 */
+    mask?: {
+        /** 高亮颜色（支持 RGB 数组、十六进制数字、#FFFFFF 格式字符串） */
+        color?: [number, number, number] | number | string;
+        /** 透明度 0-1，用于填充区域；描边区域始终完全不透明 */
+        opacity?: number;
+        /** 颜色匹配容差（归一化值 0-1，默认 0.001） */
+        tolerance?: number;
+    };
+}
+export type TagGLTFObject = GLTFObject & {
+    customID: number | string;
+    isTagModel: boolean;
+    removeEventListener: () => void;
+};
+/** 返回一个销毁函数 */
+export type ElementRenderer = (container: HTMLElement, tag: TagInstance<any, any>) => () => void;
+export type TagRendererMap = Map<string, {
+    renderer: ElementRenderer;
+    usePoint: boolean;
+}>;
+export type TagContentTypeMapping = Map<string, string>;
+export interface TagObjectGroup extends Group {
+    children: Array<TagGLTFObjectGroup>;
+}
+export interface TagGLTFObjectGroup extends Group {
+    children: TagGLTFObject[];
+}
+export interface ImagePlaneGroup extends Group {
+    children: ImagePlane[];
+}
+export type AudioAppearance = TagInstance<'Audio'>['data']['appearance'];
+type _ContentTypeConfigKey = `${StickType | 'Any'}-${TagContentType | 'Any'}` | TagContentType | `Any-Audio-${AudioAppearance}` | 'Any';
+export type ContentTypeConfigKeySplit = [StickType | 'Any', TagContentType | 'Any'] | [TagContentType] | [StickType | 'Any', 'Audio', AudioAppearance] | ['Any'] | [];
+type FiveModeType = `[${Mode | 'PanoramaLike' | 'ModelLike'}]`;
+export type ContentTypeConfigKey = FiveModeType | `${FiveModeType}-${_ContentTypeConfigKey}` | _ContentTypeConfigKey;
+/**
+ * @description 从 ContentTypeConfigKey 中提取 ContentTypeConfigKey 对应的 TagContentType 是啥
+ */
+export type PickTagContentTypeInContentTypeConfigKey<T extends string> = T extends FiveModeType ? any : T extends `${FiveModeType}-${infer P extends _ContentTypeConfigKey}` ? PickTagContentTypeInContentTypeConfigKey<P> : T extends `${any}-${infer C}` ? C : T extends TagContentType ? T : any;
+type TagConfigTypeByKeyCache = {
+    [Key in LiteralUnion<ContentTypeConfigKey, string>]: PickTagContentTypeInContentTypeConfigKey<Key>;
+};
+export type TagConfigByKey<T extends string> = PickTagContentTypeInContentTypeConfigKey<T> extends TagContentType ? TagConfig<TagConfigTypeByKeyCache[T]> : TagConfig<any>;
+/** 二维标签 */
+export type Point2DTag<C extends TagContentType = TagContentType> = TagInstance<C, '2DPoint'>;
+/** 三维标签 */
+export type Point3DTag<C extends TagContentType = TagContentType> = TagInstance<C, '3DPoint'>;
+/** 三维贴片 */
+export type PlaneTag<C extends TagContentType = TagContentType> = TagInstance<C, 'Plane'>;
+export interface TagState {
+    visible: boolean;
+    unfolded: boolean;
+}
+export {};

package/dist/types/PanoTagPlugin/utils/Cache.d.ts

@@ -0,0 +1,17 @@
+import { State as FiveState } from '@realsee/five-webgpu';
+import { TagInstance } from '../typings/index.js';
+export declare class Cache {
+    /**
+     * @description 射线碰撞检测的距离缓存
+     */
+    cache_raycasterDistance: Map<string, number>;
+    /**
+     * @description 标签是否可见缓存
+     */
+    cache_visible: Map<string, boolean>;
+    constructor();
+    clear(): void;
+    static generateCameraTagKey(fiveState: Partial<FiveState>, tag: TagInstance, accurate?: number): string;
+    getVisible(tag: TagInstance, fiveState: Partial<FiveState>, accurate?: number): boolean;
+    setVisible(tag: TagInstance, fiveState: Partial<FiveState>, visible: boolean, accurate?: number): void;
+}

package/dist/types/PanoTagPlugin/utils/DebugUtil.d.ts

@@ -0,0 +1,12 @@
+import { default as PanoTagPluginController } from '../controller/index.js';
+export declare class DebugUtil {
+    plugin: PanoTagPluginController;
+    get debug(): boolean;
+    private logBound;
+    constructor(plugin: PanoTagPluginController);
+    addDebugPoints(): void;
+    bindLog(): void;
+    private log;
+    private bindLogByObject;
+    private closeIntersectRaycaster;
+}

package/dist/types/PanoTagPlugin/utils/addDebugPoints.d.ts

@@ -0,0 +1,3 @@
+import { Five } from '@realsee/five-webgpu';
+import { Tag } from '../typings/index.js';
+export declare function addDebugPoints(five: Five, tags: Tag[]): void;

package/dist/types/PanoTagPlugin/utils/audio/SharedAudio.d.ts

@@ -0,0 +1,32 @@
+import { PlaybackManager } from '../../../shared-utils/playback.js';
+import { AudioDiagnostics } from './AudioDiagnostics.js';
+export { AudioDiagnostics };
+declare const AudioElement: new (src?: string) => HTMLAudioElement;
+export declare class SharedAudio extends AudioElement {
+    get paused(): boolean;
+    get currentTime(): number;
+    get duration(): number;
+    private sharedAudioSrc?;
+    private sharedAudioPaused;
+    private sharedAudioCurrentTime;
+    private tryplaying;
+    private audioInstance?;
+    private eventListenerDisposer?;
+    private mediaManager?;
+    private controller?;
+    private session?;
+    private playGeneration;
+    private disposed;
+    private poolGeneration;
+    constructor(src?: string, mediaManager?: PlaybackManager);
+    play(userAction?: boolean): Promise<void>;
+    setMediaManager(manager?: PlaybackManager): void;
+    pause(e?: Event): void;
+    private stopOutput;
+    dispose(): void;
+    private handlePlayError;
+    private validateAudioSource;
+    private checkBrowserSupport;
+    private endedHandler;
+    private addEventListeners;
+}

package/dist/types/PanoTagPlugin/utils/debounce.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 函数防抖：指触发事件后，在 `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>);
+export declare const debounceByKey: <F extends (...args: any) => any>(key: string, callback: F, waitFor?: number) => ((...args: Parameters<F>) => ReturnType<F>);

package/dist/types/PanoTagPlugin/utils/getImageInfo.d.ts

@@ -0,0 +1,14 @@
+import { TagIconUrl } from '../index.js';
+export declare function getImageSize(url: string): Promise<{
+    width: number;
+    height: number;
+}>;
+export declare function getImageInfo<T extends Pick<TagIconUrl, 'url' | 'ratio'>>(params: T): Promise<T & {
+    width: number;
+    height: number;
+}>;
+export declare function getKeyframeInfo<T extends Pick<TagIconUrl, 'fps' | 'ratio' | 'steps' | 'url'>>(params: T): Promise<T & {
+    width: number;
+    height: number;
+    duration: string;
+}>;

package/dist/types/PanoTagPlugin/utils/index.d.ts

@@ -0,0 +1,10 @@
+export { addDebugPoints } from './addDebugPoints.js';
+export { noTypecheck } from './noTypecheck.js';
+export { planeNormal } from './planeNormal.js';
+export { getBoxCorners, applyMatrixToPoints, getTagPosition, getTagCenterPosition } from './tagPosition.js';
+export { checkRange } from './checkRange.js';
+export { normalPositionToPositions } from './normalPositionToPositions.js';
+export { debounce, debounceByKey } from './debounce.js';
+export { throttle } from './throttle.js';
+export { binarySearchFirstBig, searchFirstValueSmallThanLastValue } from './search.js';
+export { getYouTubeId, getVimeoId, isYouTube, isVimeo, formatVideo, getVideoThumbnail } from './videoHelper.js';

package/dist/types/PanoTagPlugin/utils/model/MaskNodeMaterial.d.ts

@@ -0,0 +1,19 @@
+import * as THREE from 'three/webgpu';
+export type MaskMaterialStyle = {
+    color: number[];
+    tolerance: number;
+    highlightColor: number[];
+    opacity: number;
+};
+export declare class MaskNodeMaterial extends THREE.MeshBasicNodeMaterial {
+    private readonly maskTextureNode;
+    private readonly maskTexelSize;
+    private readonly slots;
+    private styles;
+    constructor(texture: THREE.Texture);
+    updateMaskTexture(texture: THREE.Texture): void;
+    appendStyle(style: MaskMaterialStyle): void;
+    updateStyle(index: number, style: MaskMaterialStyle): void;
+    replaceStyles(styles: MaskMaterialStyle[]): void;
+    private writeSlot;
+}

package/dist/types/PanoTagPlugin/utils/model/TagMediaTextureCache.d.ts

@@ -0,0 +1,20 @@
+import { ReadyVideoTexture } from '../../../shared-utils/three/loadVideoTexture.js';
+import { loadPicture } from '../../../shared-utils/three/loadTexture.js';
+type Picture = Awaited<ReturnType<typeof loadPicture>>;
+/** Tags retain cache leases across temporary hiding; their controller owns the cache. */
+export declare class TagMediaTextureCache {
+    readonly videoTextures: Map<string, ReadyVideoTexture>;
+    readonly imageTextures: Map<string, {
+        texture: import('three').Texture<HTMLImageElement>;
+        transparent: boolean;
+    }>;
+    private videoOwners;
+    private imageOwners;
+    private pendingImages;
+    constructor(videos?: Map<string, ReadyVideoTexture>);
+    getVideo(owner: object, src: string, scope?: string): ReadyVideoTexture;
+    getImage(owner: object, src: string): Promise<Picture>;
+    release(owner: object): void;
+    clear(): void;
+}
+export {};

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

@@ -0,0 +1,117 @@
+import { PlaybackManager } from '../../../shared-utils/playback.js';
+import { Vector3 } from 'three/webgpu';
+import { FiveDomEvents } from '../../../shared-utils/five/FiveDomEvents.js';
+import { ObjectFit } from '../../typings/index.js';
+import { TagMediaTextureCache } from './TagMediaTextureCache.js';
+import * as THREE from 'three/webgpu';
+declare abstract class MediaPlane extends THREE.Mesh<THREE.BufferGeometry, THREE.MeshBasicMaterial> {
+    name: string;
+    src?: string;
+    objectFit: ObjectFit;
+    protected constructor();
+    /** 获取透明度 */
+    get opacity(): number;
+    /** 设置透明度 (0-1) */
+    set opacity(value: number);
+    removeFromParent(): this;
+    dispose(): void;
+}
+type ImagePlaneUpdate = {
+    cornerPoints: Vector3[];
+    params?: {
+        objectFit?: ObjectFit;
+        resolveZFighting?: boolean;
+    };
+};
+declare class ImagePlane extends MediaPlane {
+    name: string;
+    private disposed;
+    private pendingChange?;
+    originRatio?: number;
+    constructor(imageSrc: string, cornerPoints: Vector3[], params?: {
+        objectFit?: ObjectFit;
+        resolveZFighting?: boolean;
+        opacity?: number;
+    });
+    changePointsOrParams(props: ImagePlaneUpdate): void;
+    dispose(): void;
+}
+declare class VideoPlane extends MediaPlane {
+    readonly isVideoPlane = true;
+    name: string;
+    videoInstance?: HTMLVideoElement;
+    onVideoReady?: (videoInstance?: HTMLVideoElement) => void;
+    private buttonSrc;
+    private videoCoverSrc?;
+    private domEvents?;
+    private disposers;
+    private cornerPoints;
+    private videoMesh?;
+    private coverMesh?;
+    private buttonMesh?;
+    private mediaTextures;
+    private textureOwner;
+    private ownsTextureLease;
+    private initialOpacity;
+    private playbackController?;
+    private session?;
+    private nativeErrorDisposer?;
+    private cancelMetadataWait?;
+    private loadGeneration;
+    private playbackDisposed;
+    private resourcesDisposed;
+    private cacheScope?;
+    constructor(videoSrc: string, cornerPoints: Vector3[], params?: {
+        mediaManager?: PlaybackManager;
+        paused?: boolean;
+        playButton?: 'withText' | 'withoutText' | string;
+        videoCoverSrc?: string;
+        objectFit?: ObjectFit;
+        mediaTextures?: TagMediaTextureCache;
+        textureOwner?: object;
+        domEvents?: FiveDomEvents;
+        opacity?: number;
+        /** video 元素的归属标识（一般是标签 id）。传入后同 src 的多个屏幕不再共享 video 元素 */
+        cacheScope?: string;
+    });
+    dispose(): void;
+    setMediaManager(manager?: PlaybackManager): void;
+    /**
+     * @returns 播放结果。`'no-session'` 表示没拿到音频焦点（并非异常），
+     * 调用方可据此降级为静音播放；`'disposed'`/`'stale'` 表示这次调用已失效。
+     */
+    play(muted?: boolean, userAction?: boolean): Promise<"disposed" | "played" | "no-session" | "stale">;
+    private startPlayback;
+    /**
+     * @description 从头播放。用于「离开可见范围后走回来」的场景：
+     * 先重置进度，再尝试有声播放；有声不可用时回退静音，避免出现「既没声音也不播放」。
+     * @param userAction 是否按用户操作申请音频焦点（true 会抢占当前音源）
+     */
+    replayFromStart(userAction?: boolean): Promise<'audible' | 'muted' | 'failed'>;
+    /** 复用的 video 元素不会自动回到起点，需显式重置 */
+    private resetProgress;
+    pause(): void;
+    private stopOutput;
+    onDispose(dispose: () => void): void;
+    initialRenderHooks(func: (render: () => void) => () => void): void;
+    private showPlayUI;
+    private showPauseUI;
+    private render;
+    private addCoverMesh;
+    private addVideoMesh;
+    private addButtonMesh;
+    private getImageTexture;
+    private getVideoTexture;
+    private waitForVideoMetadata;
+    changePointsOrParams(props: {
+        cornerPoints: Vector3[];
+        params?: {
+            objectFit?: ObjectFit;
+        };
+    }): Promise<void>;
+    private updateAllMeshes;
+    private updateVideoMesh;
+    private updateCoverMesh;
+    private updateButtonMesh;
+}
+export { ImagePlane, VideoPlane };

package/dist/types/PanoTagPlugin/utils/normalPositionToPositions.d.ts

@@ -0,0 +1,2 @@
+import { Vector3 } from 'three/webgpu';
+export declare function normalPositionToPositions(cameraPosition: Vector3, position: Vector3, normal: Vector3): [Vector3, Vector3, Vector3, Vector3];

package/dist/types/PanoTagPlugin/utils/planeNormal.d.ts

@@ -0,0 +1,4 @@
+import { Vector3 } from 'three/webgpu';
+import { AnyPosition } from '../../shared-utils/positionToVector3.js';
+export declare function planeNormal(points: [AnyPosition, AnyPosition, AnyPosition] | [AnyPosition, AnyPosition, AnyPosition, AnyPosition]): Vector3;
+export declare function planeNormal(points: AnyPosition[]): Vector3 | void;

package/dist/types/PanoTagPlugin/utils/sculptDataToBoxPosition.d.ts

@@ -0,0 +1,6 @@
+import { BoxPosition } from '../typings/index.js';
+import * as THREE from 'three/webgpu';
+/**
+ * 将 Sculpt 数据转换为 BoxPosition
+ */
+export declare function sculptDataToBoxPosition(bottomPoints: THREE.Vector3[], heightPoint: THREE.Vector3): BoxPosition;

package/dist/types/PanoTagPlugin/utils/tag/adaptConfig.d.ts

@@ -0,0 +1,2 @@
+import { TagConfig } from '../../index.js';
+export default function adaptConfig(config: TagConfig): TagConfig<keyof import('../../index.js').ContentTypeMapInterface>;

package/dist/types/PanoTagPlugin/utils/tag/calculateTagConfig.d.ts

@@ -0,0 +1,7 @@
+import { Tag, Tags, TagInstance } from '../../typings/index.js';
+/**
+ * @description 获取merge后的配置
+ */
+export declare function calculateTagConfig(tag: Tag, baseConfig: Pick<Tags, 'globalConfig' | 'contentTypeConfig'>, params?: {
+    useCache?: boolean;
+}): TagInstance['computedConfig'];

package/dist/types/PanoTagPlugin/utils/tag/canAutoPlayByOcclusion.d.ts

@@ -0,0 +1,17 @@
+import type * as THREE from 'three/webgpu';
+export interface AutoPlayIntersectConfig {
+    checkPoints?: 'center' | 'corner' | THREE.Vector3[];
+    needPassed?: number;
+    hideWhenModelNotLoaded?: boolean;
+    startPointMode?: 'observer' | 'horizontal';
+}
+export declare const autoPlayIntersectConfig: AutoPlayIntersectConfig;
+export declare function canAutoPlayByOcclusion(params: {
+    currentVisible: boolean;
+    panoIndex?: number;
+    computeVisibleByIntersect: (panoIndex: number | undefined, config: AutoPlayIntersectConfig) => {
+        value: boolean;
+    };
+}): {
+    value: boolean;
+};

package/dist/types/PanoTagPlugin/utils/tag/format.d.ts

@@ -0,0 +1,5 @@
+import { StickType, Tag } from '../../typings/index.js';
+export declare function getTagStickType(tag: Tag): StickType;
+export default function formatTag<T extends Tag>(tag: T): tag is T & {
+    stickType: StickType;
+};

package/dist/types/PanoTagPlugin/utils/tag/getRaycasterStartPosition.d.ts

@@ -0,0 +1,12 @@
+import * as THREE from 'three/webgpu';
+export type RaycasterStartPointMode = 'observer' | 'horizontal';
+/**
+ * @description 计算碰撞检测射线的起点
+ * @param observerPosition 观察点位置（全景态）或相机位置（模型态），含真实高度
+ * @param checkPoint 检测点（标签中心点或角点）
+ * @param mode
+ *  - `observer`：直接使用观察点位置，射线是斜的，可能从矮柜/栏杆上方越过
+ *  - `horizontal`：与检测点保持水平，y 取检测点高度、x/z 取观察点的值，
+ *    用于判定「当前点位与检测点的水平连线是否被模型挡住」
+ */
+export declare function getRaycasterStartPosition(observerPosition: THREE.Vector3, checkPoint: THREE.Vector3, mode?: RaycasterStartPointMode): THREE.Vector3;