vis-core 0.33.2 → 0.33.3

package/dist/index.d.ts

@@ -24,7 +24,6 @@ import { Position } from 'geojson';
 import { ProjectionOptions } from 'gl-draw';
 import { RectAreaLightObject } from 'gl-draw';
 import { RestoreBaseObjectOptions } from 'gl-draw';
-import { RoomEnvironment } from 'three/examples/jsm/environments/RoomEnvironment.js';
 import { SceneSnapshot } from 'gl-draw';
 import { SpotLightObject } from 'gl-draw';
 import { SpriteObject } from 'gl-draw';
@@ -112,8 +111,6 @@ declare class Base_2 extends Camera {
     lead: Lead;
     sceneResources: default_2['sceneResources'];
     tier0: boolean;
-    pmremGenerator: THREE.PMREMGenerator | null;
-    re: RoomEnvironment | null;
     roomEnvMap?: THREE.Texture;
     private roomEnvTarget?;
     private roomEnvLease?;
@@ -682,7 +679,7 @@ declare class Map_3 extends Base_2 {
     get adcode(): number | undefined;
     activePlaneMap: PlaneMap | null;
     /** 宿主大屏图表等遮挡形成的运行时安全区；不写入场景 options。 */
-    private safeAreaInsets;
+    private safeAreaInsets?;
     private safeAreaRefitPending;
     parentBg: PlaneMap[];
     continentsBg?: ContinentsBg;
@@ -698,6 +695,8 @@ declare class Map_3 extends Base_2 {
      * 和 sceneBindings，因此在场景刚恢复时记录，供后续 fitTo 复用设计师视角。
      */
     private regionCameraFitReference?;
+    private authoredCameraPose?;
+    private cameraAngleOverrides?;
     setOptions(options: MapOptions): void;
     private _getProjectionCenter;
     private _getProjectionRotate;
@@ -783,16 +782,19 @@ declare class Map_3 extends Base_2 {
     private _loadBaseGeojson;
     private getGeojson;
     /* Excluded from this release type: buildRegion */
+    /** 流式读取实际世界坐标，不复制或持有地图几何。 */
+    private cameraFitPoints;
+    private cameraForPose;
+    private captureCameraFitReference;
+    /** 没有选中命名视角时，使用导出场景中的实际相机朝向和位置。 */
+    private readAuthoredCameraPose;
+    private getCameraFitReference;
     private calcPaddingFromReference;
     fitTo(obj: BaseObject, { polarAngle, azimuthAngle, reference, z, handleStart, adcode, enableTransition, smoothTime, }?: {
         adcode?: number;
         polarAngle?: number;
         azimuthAngle?: number;
-        reference?: {
-            lookat: [number, number, number, number, number, number];
-            adcode?: number;
-            center?: [number, number];
-        };
+        reference?: MapCameraFitReference;
         enableTransition?: boolean;
         smoothTime?: number;
         z?: number;
@@ -807,10 +809,10 @@ declare class Map_3 extends Base_2 {
         adcode: number;
         extrudelineBloom?: boolean;
     }): Promise<PlaneMap>;
-    private hasSafeAreaInsets;
     private getEffectiveSafeAreaPadding;
-    getSafeAreaInsets(): MapSafeAreaInsets;
-    setSafeAreaInsets(insets: Partial<MapSafeAreaInsets>, options?: MapSafeAreaOptions): Promise<void>;
+    /** undefined 表示沿用设计师构图；对象（包括全 0）表示宿主覆盖。 */
+    getSafeAreaInsets(): MapSafeAreaInsets | undefined;
+    setSafeAreaInsets(insets?: Partial<MapSafeAreaInsets>, options?: MapSafeAreaOptions): Promise<void>;
     refitSafeAreaIfNeeded(options?: MapSafeAreaOptions): Promise<void>;
     findAdcodeInfo(adcode: number): {
         adcode: number;
@@ -871,6 +873,20 @@ declare interface MapAssetSources {
     };
 }
 
+declare interface MapCameraFitReference {
+    lookat: MapCameraPose;
+    adcode?: number;
+    /** 兼容原有 reference 输入；留白计算使用真实地图几何。 */
+    center?: [number, number];
+    padding?: MapSafeAreaInsets;
+    viewport?: {
+        width: number;
+        height: number;
+    };
+}
+
+declare type MapCameraPose = [number, number, number, number, number, number];
+
 declare interface MapCityOptions extends MapOptions {
     cacheCity?: boolean;
     nearbyCities?: boolean | 'full';
@@ -1567,7 +1583,7 @@ export declare class SceneManager extends Event_2 {
     private isSwitching;
     private isRegionSwitching;
     private pencil?;
-    private safeAreaInsets;
+    private safeAreaInsets?;
     private generation;
     private documentIdentityRevision;
     private preparedStructures;
@@ -1592,10 +1608,10 @@ export declare class SceneManager extends Event_2 {
     remapCommittedIdentity(sceneId: string, previous: string, next: string, objectIdentity: boolean): boolean;
     /**
      * 设置宿主界面的运行时地图安全区。该状态不进入场景文档，并会自动传给
-     * 当前地图、缓存地图和后续创建的地图区域。
+     * 当前、缓存和加载中的地图。对象（包括全 0）替代设计留白；undefined 清除覆盖。
      */
-    setSafeAreaInsets(insets: Partial<MapSafeAreaInsets>, options?: MapSafeAreaOptions): Promise<void>;
-    getSafeAreaInsets(): MapSafeAreaInsets;
+    setSafeAreaInsets(insets?: Partial<MapSafeAreaInsets>, options?: MapSafeAreaOptions): Promise<void>;
+    getSafeAreaInsets(): MapSafeAreaInsets | undefined;
     private captureCamera;
     private playTransition;
     /** 更新可编辑文档，并释放已经不属于文档的非活动场景实例。 */
@@ -1993,7 +2009,7 @@ declare interface TweenOptions {
 
 export declare function updateProjectMaterial<T extends VisSceneDocument>(document: T, assetId: string, patch: Partial<Pick<MaterialAsset, 'name' | 'material' | 'locked'>>): T;
 
-export declare const VERSION = "0.33.2";
+export declare const VERSION = "0.33.3";
 
 export declare interface VisSceneDocument extends SceneDocumentMarker {
     entrySceneId: string;