vis-core 0.32.2 → 0.32.4

package/dist/index.d.ts

@@ -132,6 +132,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;
@@ -527,6 +533,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 +655,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 +749,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 +809,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;
@@ -1220,10 +1247,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;
     /** 接管一个已经恢复完成的场景，供编辑器首次加载时复用。 */
@@ -1239,6 +1274,12 @@ export declare class SceneManager extends Event_2 {
     loadMapRegion(documentOrUrl: VisSceneDocument | string, adcode: number, resolveScene: MapRegionSceneResolver, hooks?: Record<string, any>): Promise<Map_2>;
     private loadDocument;
     switchScene(sceneId: string, options?: SwitchSceneOptions, hooks?: Record<string, any>): Promise<Base | null>;
+    /**
+     * 恢复并缓存一个非活动场景，不改变当前场景、导航历史或相机。
+     * 适合预制件场景：调用方可从返回实例取对象，再通过 instantiate({ target })
+     * 直接实例化到当前场景。
+     */
+    preloadScene(sceneId: string, hooks?: Record<string, any>): Promise<Base>;
     /** 编辑器事务：在独立页面上修改参数并重建快照，成功后一起提交文档和实例。 */
     editScene(sceneId: string, edit: (scene: Base, definition: SceneViewportDocument) => Promise<SceneViewportDocument>, hooks?: Record<string, any>): Promise<Base>;
     back(hooks?: Record<string, any>): Promise<Base | null>;
@@ -1258,6 +1299,8 @@ export declare class SceneManager extends Event_2 {
     private getCurrentSceneByType;
     getScene<T extends SceneType>(sceneId: string, type: T): SceneTypeMap[T] | undefined;
     getScene(sceneId: string): Base | undefined;
+    getSceneByName<T extends SceneType>(name: string, type: T): SceneTypeMap[T] | undefined;
+    getSceneByName(name: string): Base | undefined;
     private getSceneByType;
     getDocument(): VisSceneDocument | undefined;
     private bindSceneInteractions;
@@ -1282,6 +1325,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 {
@@ -1403,7 +1448,7 @@ export { TWEEN }
 
 export { Tween }
 
-export declare const VERSION = "0.32.2";
+export declare const VERSION = "0.32.4";
 
 export declare interface VisSceneDocument extends SceneDocumentMarker {
     entrySceneId: string;