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

package/dist/GuideLinePlugin/Controller.d.ts

@@ -5,13 +5,14 @@ import type * as PluginType from './typing';
 import type { Config as BaseConfig } from '../base/BasePlugin';
 import { GuideLineItem } from './GuideLineItem';
 import CruisePluginController from '../CruisePlugin/Work';
+import { type UrlTransformer } from '../shared-utils';
 export declare const pluginFlag: (name: string) => string;
 type Config = BaseConfig & {
     /**
-     * @description 离线模式 - 当为 true 时，将 CDN 资源链接转换为本地路径
-     * @default false
+     * URL转换器 - 用于转换资源链接
+     * @default noTransform()
      */
-    isOffline?: boolean;
+    transformUrl?: UrlTransformer;
 };
 export default class Controller extends BasePluginWithData.Controller<PluginState, EventMap, PluginServerData, PluginData> {
     readonly name = "GuideLinePlugin";
@@ -29,7 +30,10 @@ export default class Controller extends BasePluginWithData.Controller<PluginStat
     get disposed(): boolean;
     private _config;
     private _disposed;
+    private transformUrl;
     constructor(five: Five, config?: Config);
+    /** 获取URL转换器 */
+    getUrlTransformer(): UrlTransformer;
     load(serverData: PluginServerData | PluginData, state?: PluginState, userAction?: boolean): Promise<void>;
     formatData(serverData: any): Promise<PluginType.PluginData>;
     /** 展示插件 */
@@ -55,6 +59,7 @@ export default class Controller extends BasePluginWithData.Controller<PluginStat
     }): void;
     /** 添加一个 GuideLineItem */
     addGuideLineItem(data?: PluginType.GuideLineItem): GuideLineItem;
+    private processItemUrls;
     /** 获取 Plugin 内的 GuideLineItem */
     getGuideLineItemByID(id: string | number): GuideLineItem;
     /** 移除一个 GuideLineItem */

package/dist/GuideLinePlugin/typing.d.ts

@@ -2,6 +2,7 @@ import type GuideLinePlugin from '.';
 import type { RequireAtLeastOne } from 'type-fest';
 import type * as BasePluginWithData from '../base/BasePluginWithData';
 import type { Tag } from '../PanoTagPlugin';
+import type { UrlTransformer } from '../shared-utils/url/UrlTransformer';
 export type RouteConfig = {
     /**
      * @description 箭头贴图
@@ -101,11 +102,6 @@ export type GuideLineItem = RequireAtLeastOne<{
     panorama_style?: PanoramaGuideLineStyle;
     /** 模型态使用的数据 */
     model_style?: ModelGuideLineStyle;
-    /**
-     * @description 离线模式 - 当为 true 时，将 CDN 资源链接转换为本地路径
-     * @default false
-     */
-    isOffline?: boolean;
 } & ExtraRouteData, 'id' | 'render_id'>;
 /** 全景路径样式 */
 export interface PanoramaGuideLineStyle extends GuideLineStyle {
@@ -182,11 +178,6 @@ export interface GuideLineMaterialStyle {
         /** 贴图地址 */
         url: string;
     };
-    /**
-     * @description 离线模式 - 当为 true 时，将 CDN 资源链接转换为本地路径
-     * @default false
-     */
-    isOffline?: boolean;
 }
 export interface ModelGuideLineTagData {
     position: number[];
@@ -207,3 +198,9 @@ export interface CatmullRomCurve3 {
     curve_type?: string;
     tension?: number;
 }
+export interface Config {
+    /** 静态资源前缀 - 用于处理资源URL转换 */
+    staticPrefix?: string;
+    /** URL转换器函数 - 高级选项，如果提供则会覆盖staticPrefix */
+    transformUrl?: UrlTransformer;
+}

package/dist/ModelChassisCompassPlugin/Plugin.d.ts

@@ -1,8 +1,12 @@
 import type { FivePlugin } from '@realsee/five';
+import { type UrlTransformer } from '../shared-utils/url/UrlTransformer';
 export interface ModelChassisCompassPluginParameterType {
     north_rad?: number;
     fbx_url?: string;
-    isOffline?: boolean;
+    /** 静态资源前缀 - 用于转换资源链接 */
+    staticPrefix?: string;
+    /** URL转换器 - 高级选项，如果提供则会覆盖staticPrefix */
+    transformUrl?: UrlTransformer;
 }
 export interface ModelChassisCompassPluginData {
     north_rad?: number;

package/dist/ModelEntryDoorGuidePlugin/Plugin.d.ts

@@ -1,5 +1,6 @@
 import type { FivePlugin } from '@realsee/five';
 import type { Vector3Position } from '../typings/math.type';
+import { type UrlTransformer } from '../shared-utils/url/UrlTransformer';
 export interface ModelEntryDoorGuidePluginData {
     position?: Vector3Position;
     rad?: number;
@@ -8,7 +9,10 @@ export interface ModelEntryDoorGuidePluginData {
 export type ModelEntryDoorGuidePluginParameterType = {
     animationEnabled?: boolean;
     name?: string;
-    isOffline?: boolean;
+    /** 静态资源前缀 - 用于转换资源链接 */
+    staticPrefix?: string;
+    /** URL转换器 - 高级选项，如果提供则会覆盖staticPrefix */
+    transformUrl?: UrlTransformer;
 } & ModelEntryDoorGuidePluginData;
 export interface ModelEntryDoorGuidePluginExportType {
     enable: (config?: {

package/dist/PanoSpatialTagPlugin/Plugin.d.ts

@@ -1,4 +1,5 @@
 import type { FivePlugin } from '@realsee/five';
+import { type UrlTransformer } from '../shared-utils';
 import type { PanoSpatialTagPluginId, PanoSpatialTagPluginDataElement, PanoSpatialTagPluginContentReplacement, PanoSpatialTagPluginContentEvent } from './typings';
 export interface PanoSpatialTagPluginData {
     folded?: boolean;
@@ -17,11 +18,10 @@ export interface PanoSpatialTagPluginParameterType {
     upsideHeight?: number;
     minDistance?: number;
     maxDistance?: number;
-    /**
-     * @description 离线模式 - 当为 true 时，将 CDN 资源链接转换为本地路径
-     * @default false
-     */
-    isOffline?: boolean;
+    /** 静态资源前缀 - 用于转换资源链接 */
+    staticPrefix?: string;
+    /** URL转换器 - 高级选项，如果提供则会覆盖staticPrefix */
+    transformUrl?: UrlTransformer;
 }
 export interface PanoSpatialTagPluginExportType {
     load: (data: PanoSpatialTagPluginData) => void;

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

@@ -4,6 +4,7 @@ import type { ArrayPosition } from '../typings';
 import { type Five } from '@realsee/five';
 import { TagRender } from './TagRender';
 import type { PartialObjectDeep } from '../../typings/typings';
+import { type UrlTransformer } from '../../shared-utils/url/UrlTransformer';
 export declare const pluginFlag: (name: string) => string;
 declare class PanoTagPluginController extends TagRender {
     /** state */
@@ -16,20 +17,25 @@ declare class PanoTagPluginController extends TagRender {
     private debugUtil;
     /** 全局 hover 启用状态，默认 true */
     globalHoverEnabled: boolean;
-    /** 离线模式标识，用于替换网络资源链接 */
-    private isOffline;
-    /** 插件参数 - 重写父类定义以添加 isOffline 参数 */
+    /** 插件参数 - 重写父类定义以添加 transformUrl 参数 */
     protected params: {
         config: Pick<Tags, 'contentTypeConfig' | 'globalConfig'>;
         debug: boolean;
         containerZIndex?: number;
-        isOffline?: boolean;
+        /** 静态资源前缀 - 用于转换资源链接 */
+        staticPrefix?: string;
+        /** URL转换器 - 高级选项，如果提供则会覆盖staticPrefix */
+        transformUrl?: UrlTransformer;
     };
+    private urlTransformer;
     constructor(five: Five, params?: {
         config?: Pick<Tags, 'contentTypeConfig' | 'globalConfig'>;
         debug?: boolean;
         containerZIndex?: number;
-        isOffline?: boolean;
+        /** 静态资源前缀 - 用于转换资源链接 */
+        staticPrefix?: string;
+        /** URL转换器 - 高级选项，如果提供则会覆盖staticPrefix */
+        transformUrl?: UrlTransformer;
     });
     appendTo(wrapper: Element): void;
     /**

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

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

package/dist/floorplan/PanoFloorplanRadarPlugin/typing.d.ts

@@ -55,10 +55,10 @@ export interface Parameters extends Partial<Config> {
         cameraImageUrl?: string;
     };
     /**
-     * @description 离线模式 - 当为 true 时，将 CDN 资源链接转换为本地路径
-     * @default false
+     * @description URL转换器 - 用于转换资源链接
+     * @default noTransform()
      */
-    isOffline?: boolean;
+    transformUrl?: (url: string) => string | Promise<string>;
     /** 静态资源前缀 */
     staticPrefix?: string;
     /** 国际化转换函数 */