vis-core 0.32.3 → 0.32.5

package/dist/index.d.ts

@@ -59,7 +59,9 @@ declare class Arc extends LineObject {
     setControlPoints(points: [THREE.Vector3, THREE.Vector3, THREE.Vector3, THREE.Vector3]): void;
     setPath(from: THREE.Vector3 | number[], to: THREE.Vector3 | number[], radius: number, setPointWidth?: (p: number) => number): void;
     pickTube: Tube | null;
-    addPickTarget(radius?: number, show?: boolean): Promise<Tube>;
+    private pickTargetVersion;
+    addPickTarget(radius?: number, show?: boolean): Promise<Tube | undefined>;
+    dispose(): void;
     onPointerEvent(...args: Parameters<BaseObject['onPointerEvent']>): void;
     setColor(color: string): void;
     animateIn({ duration, delay, repeat, onComplete, onRepeat, }?: {
@@ -103,6 +105,7 @@ export declare class Base extends Camera {
     pmremGenerator: THREE.PMREMGenerator | null;
     re: RoomEnvironment | null;
     roomEnvMap?: THREE.Texture;
+    private roomEnvTarget?;
     visName: string;
     private detectRes?;
     private ownsPencil;
@@ -132,6 +135,12 @@ export declare class Base extends Camera {
     private createRuntime;
     private sceneActive;
     setSceneActive(): void;
+    /**
+     * Bloom and shadow-map configuration live on the shared renderer/composer,
+     * rather than on an individual Pencil page. Reapply the active page's saved
+     * values whenever a cached scene becomes active again.
+     */
+    private applySceneRenderState;
     /** 把 Pencil 生命周期交给外部场景管理器，当前实例仅拥有自己的 page。 */
     releasePencilOwnership(): void;
     private initSceneUserData;
@@ -151,7 +160,7 @@ export declare class Base extends Camera {
     hide(): void;
     exportScene(): THREE.Object3DJSON;
     exportBaseObject(baseObject: BaseObject): THREE.Object3DJSON;
-    restoreBaseObject(data: string | THREE.Object3DJSON, target?: BaseObject, objectsMap?: Record<string, any>): Promise<BaseObject<THREE.Object3D<THREE.Object3DEventMap>>>;
+    restoreBaseObject(data: string | THREE.Object3DJSON, target?: BaseObject, objectsMap?: Record<string, any>, signal?: AbortSignal): Promise<BaseObject<THREE.Object3D<THREE.Object3DEventMap>>>;
     restoreScene(str: string | THREE.Object3DJSON, objectsMap?: Record<string, any>): Promise<void>;
     getClassRefByType(type: string): typeof BaseObject;
     addGroup(): Promise< GroupObject>;
@@ -359,8 +368,12 @@ declare class CityPlane extends MeshObject {
     create(): Promise<void>;
     rebuildFromScene(): void;
     addWater(normalMaps: [THREE.Texture, THREE.Texture]): void;
+    dispose(): void;
 }
 
+/** Rebind internal targets while preserving links to scenes outside the copied set. */
+export declare function cloneSceneWithIds(scene: SceneViewportDocument, ids: Map<string, string>): SceneViewportDocument;
+
 declare class ContinentsBg extends GroupObject {
     objectType: string;
     options: Options_8;
@@ -471,6 +484,9 @@ declare class Event_2 {
     dispose(): void;
 }
 
+/** Expand at the editor import boundary so independently edited scenes own their data. */
+export declare function expandSceneDocumentResources<T extends VisSceneDocument>(document: T): T;
+
 declare const findAdcodeInfo: (adcode: number) => {
     adcode: number;
     lng: number;
@@ -488,7 +504,9 @@ declare type GeoJSON_3 = FeatureCollection<Polygon | MultiPolygon>;
 
 declare type GeoJSON_4 = FeatureCollection<Polygon | MultiPolygon>;
 
-export declare function getSceneDocument(document: VisSceneDocument, sceneId?: string): SceneViewportDocument;
+export declare function getSceneDocument(document: VisSceneDocument, sceneId?: string, options?: {
+    resolveResources?: boolean;
+}): SceneViewportDocument;
 
 declare class HemisphereLight extends HemisphereLightObject {
 }
@@ -527,6 +545,9 @@ declare class Map_2 extends Base {
     /** 当前已恢复或生成的主地图区域；空场景为 undefined。 */
     get adcode(): number | undefined;
     activePlaneMap: PlaneMap | null;
+    /** 宿主大屏图表等遮挡形成的运行时安全区；不写入场景 options。 */
+    private safeAreaInsets;
+    private safeAreaRefitPending;
     parentBg: PlaneMap[];
     continentsBg?: ContinentsBg;
     group: GroupObject;
@@ -646,7 +667,11 @@ declare class Map_2 extends Base {
         adcode: number;
         extrudelineBloom?: boolean;
     }): Promise<PlaneMap>;
-    setPadding(padding: [number, number, number, number], fitTo?: boolean, enableTransition?: boolean): void;
+    private hasSafeAreaInsets;
+    private getEffectiveSafeAreaPadding;
+    getSafeAreaInsets(): MapSafeAreaInsets;
+    setSafeAreaInsets(insets: Partial<MapSafeAreaInsets>, options?: MapSafeAreaOptions): Promise<void>;
+    refitSafeAreaIfNeeded(options?: MapSafeAreaOptions): Promise<void>;
     findAdcodeInfo(adcode: number): {
         adcode: number;
         lng: number;
@@ -736,7 +761,6 @@ declare interface MapOptions extends BaseOptions {
     continentsBg?: boolean;
     continentsBgDepth?: number;
     mapDepth?: number;
-    mapPadding?: [number, number, number, number];
     fixGeojson?: Record<string, string>;
     showDistrict?: boolean;
     showLabel?: boolean | 'lite';
@@ -797,6 +821,21 @@ export declare interface MapRegionSwitchInteraction {
     };
 }
 
+/** 宿主界面覆盖地图的运行时安全区，单位为 CSS px。 */
+export declare interface MapSafeAreaInsets {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+
+export declare interface MapSafeAreaOptions {
+    /** 设置后是否立即重新适配当前地图。默认 true。 */
+    refit?: boolean;
+    transition?: boolean;
+    smoothTime?: number;
+}
+
 /** 平台导出的运行时对象绑定，使用 Lead 的完整 key，不依赖命名规则。 */
 declare interface MapSceneBindings {
     container: string;
@@ -1032,6 +1071,9 @@ declare interface Options_9 {
     grey?: boolean;
 }
 
+/** Pack an export copy only; preserve the editor's independent scene snapshots. */
+export declare function packSceneDocumentResources<T extends VisSceneDocument>(document: T): T;
+
 declare class Plane extends MeshObject {
     objectType: string;
     create(): void;
@@ -1168,7 +1210,7 @@ declare class Road extends GroupObject {
 
 export declare const SCENE_DOCUMENT_FORMAT: "vis-scene";
 
-export declare const SCENE_DOCUMENT_SCHEMA_VERSION: 2;
+export declare const SCENE_DOCUMENT_SCHEMA_VERSION: 3;
 
 export declare interface SceneBackInteraction {
     trigger: 'click' | 'clickOutside';
@@ -1220,10 +1262,18 @@ export declare class SceneManager extends Event_2 {
     private isSwitching;
     private isRegionSwitching;
     private pencil?;
+    private safeAreaInsets;
     private debugInteraction;
     private enablePickDebug;
     private disposeInactiveScenes;
     constructor(options: SceneManagerInitOptions);
+    private prepareScene;
+    /**
+     * 设置宿主界面的运行时地图安全区。该状态不进入场景文档，并会自动传给
+     * 当前地图、缓存地图和后续创建的地图区域。
+     */
+    setSafeAreaInsets(insets: Partial<MapSafeAreaInsets>, options?: MapSafeAreaOptions): Promise<void>;
+    getSafeAreaInsets(): MapSafeAreaInsets;
     private captureCamera;
     private playTransition;
     /** 接管一个已经恢复完成的场景，供编辑器首次加载时复用。 */
@@ -1290,6 +1340,8 @@ export declare type SceneManagerInitOptions = SceneManagerOptions & SceneManager
 export declare interface SceneManagerOptions extends Pick<BaseOptions, 'container' | 'controlsContainer' | 'css2DContainer' | 'assetsPrefix' | 'pencilConfig' | 'logarithmicDepthBuffer' | 'tier' | 'observeParentScale'> {
     /** 动态行政区数据访问使用的授权 key。 */
     mapSwitchKey?: string;
+    /** 宿主大屏图表等覆盖区域形成的运行时地图安全区。 */
+    safeAreaInsets?: Partial<MapSafeAreaInsets>;
 }
 
 export declare interface SceneSwitchInteraction {
@@ -1411,11 +1463,13 @@ export { TWEEN }
 
 export { Tween }
 
-export declare const VERSION = "0.32.3";
+export declare const VERSION = "0.32.5";
 
 export declare interface VisSceneDocument extends SceneDocumentMarker {
     entrySceneId: string;
     scenes: SceneViewportDocument[];
+    /** Schema 3: image/video/data payloads shared across scenes, never live textures. */
+    _resourcePool?: any[];
     c?: Record<string, any>;
     d?: Record<string, any>;
     h?: Record<string, any>;