vis-core 0.33.1 → 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?;
@@ -479,6 +476,7 @@ export declare function createRuntimeSceneDocument(document: VisSceneDocument):
 /** Convert authored asset aliases to the native catalog expected by graph restoration. */
 export declare function createRuntimeSceneGraph(scene: SceneViewportDocument, options?: {
     omitPrefabPreviews?: boolean;
+    /* Excluded from this release type: consumeInput */
 }): Record<string, any>;
 
 declare class DirectionalLight extends DirectionalLightObject {
@@ -590,6 +588,8 @@ declare class Event_2 {
     dispose(): void;
 }
 
+/* Excluded from this release type: expandOwnedSceneDocumentResources */
+
 /** Expand at the editor import boundary so independently edited scenes own their data. */
 export declare function expandSceneDocumentResources<T extends VisSceneDocument>(document: T): T;
 
@@ -679,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;
@@ -695,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;
@@ -780,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;
@@ -804,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;
@@ -868,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';
@@ -1017,6 +1036,8 @@ export declare interface MaterialDefinitionScope {
 /** One explicit mapping from an asset's authored resource UUIDs to runtime resource UUIDs. */
 export declare function materializeAssetDefinition(asset: MaterialAsset, materialUuid?: string): Record<string, any>;
 
+/* Excluded from this release type: materializeOwnedProjectMaterials */
+
 /** Mutate a detached working snapshot owned exclusively by the caller. */
 export declare function materializeOwnedSceneMaterials<T extends SceneViewportDocument>(scene: T, library?: MaterialAsset[]): T;
 
@@ -1140,10 +1161,11 @@ declare class Mountain extends GroupObject {
     }[];
     create(): Promise<void>;
     setNoise(geometry: THREE.BufferGeometry, image: HTMLImageElement, maxHeight?: number): void;
-    render(): void;
     rebuildFromScene(): void;
 }
 
+/* Excluded from this release type: normalizeOwnedProjectMaterials */
+
 /** Bind serialized runtime materials and alias catalogs to authored assets. */
 export declare function normalizeProjectMaterials<T extends VisSceneDocument>(document: T): T;
 
@@ -1323,6 +1345,8 @@ declare class PlaneMap extends GroupObject {
     mergeSideArea: ExtrudePolygonObject | null;
     extrudelineArr?: LineObject[];
     splitPolygons: number;
+    private standaloneHideMaterial?;
+    private getHideMaterial;
     constructor(options: Options);
     create(): Promise<void>;
     private markGeneratedObjects;
@@ -1403,6 +1427,8 @@ export declare interface PrefabAsset {
     revision: number;
     /** Stable public SDK identifier. Omit for assets used only by the editor. */
     sdkKey?: string;
+    /** Legacy business templates own complete material snapshots, without promoting scene assets. */
+    materialMode?: 'embedded';
     snapshot: Record<string, any>;
 }
 
@@ -1557,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;
@@ -1571,16 +1597,21 @@ export declare class SceneManager extends Event_2 {
     private debugInteraction;
     private enablePickDebug;
     private disposeInactiveScenes;
+    /** Retire inactive pages after the host accepts navigation; failures never undo the active page. */
+    trimInactiveScenes(): unknown[];
+    /** Update host navigation policy when lifecycle scripts change between scene activations. */
+    setSceneCachePolicy(cacheScenes: boolean, maxCachedScenes?: number | undefined): void;
+    private reportSceneRetirementErrors;
     constructor(options: SceneManagerInitOptions);
     private prepareScene;
     /** Publish one identity remap without exporting runtimes or copying other pages/resources. */
     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;
     /** 更新可编辑文档，并释放已经不属于文档的非活动场景实例。 */
@@ -1655,8 +1686,6 @@ export declare class SceneManager extends Event_2 {
     switchScene(sceneId: string, options?: SwitchSceneOptions, hooks?: Record<string, any>): Promise<Base_2 | null>;
     /**
      * 恢复并缓存一个非活动场景，不改变当前场景、导航历史或相机。
-     * 适合预制件场景：调用方可从返回实例取对象，再通过 instantiate({ target })
-     * 直接实例化到当前场景。
      */
     preloadScene(sceneId: string, hooks?: Record<string, any>): Promise<Base_2>;
     /** 编辑器事务：在独立页面上修改参数并重建快照，成功后一起提交文档和实例。 */
@@ -1713,6 +1742,8 @@ export declare interface SceneManagerBehaviorOptions {
     prepareScene?: (scene: Base_2) => void;
     /** 是否保留非活动场景实例；编辑器可关闭以限制 GPU/内存占用。 */
     cacheScenes?: boolean;
+    /** Pages retained after navigation, including the active page; oldest inactive pages retire first. */
+    maxCachedScenes?: number;
     /** 自定义分包场景读取器；可从 IndexedDB 等非 HTTP 存储按需读取。 */
     loadScene?: (entry: SceneManifestEntry) => Promise<SceneViewportDocument>;
 }
@@ -1978,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.1";
+export declare const VERSION = "0.33.3";
 
 export declare interface VisSceneDocument extends SceneDocumentMarker {
     entrySceneId: string;