vis-core 0.33.11 → 0.33.13

package/dist/index.d.ts

@@ -3066,8 +3066,16 @@ declare class Map_4 extends Base_3 {
     shadowMapEnabled(): Promise<void>;
     getReferenceScale(bboxa: number[], bboxb: number[]): number;
     getAdcodeShowLevel(adcode: number, fix?: boolean): string | undefined;
-    drawLabels(): Promise<void>;
+    private labelUpdates?;
+    private labelsDirty;
+    private labelsDisposed;
     private labelGroupObject3dUserData;
+    /** Update label mode atomically; superseded requests reject with AbortError. */
+    setLabels(showLabel: boolean | 'lite', options?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+    drawLabels(): Promise<void>;
+    private updateLabels;
     eraseLabels(): void;
     geAdcodePosition(adcode: number): [number, number, number] | undefined;
     /** 地图顶面的世界坐标；height 沿顶面世界法线偏移，单位为世界单位。 */
@@ -3318,6 +3326,11 @@ declare interface MapRegionEnterTransitionOptions extends SceneEnterTransitionOp
     preparedCamera?: [number, number, number, number, number, number];
 }
 
+export declare interface MapRegionOptions extends SwitchSceneOptions {
+    /** Cancel before commit. Submitted GPU/resource work is allowed to settle safely. */
+    signal?: AbortSignal;
+}
+
 export declare type MapRegionSceneResolver = (document: VisSceneDocument, adcode: number) => string | SceneViewportDocument | null | undefined | Promise<string | SceneViewportDocument | null | undefined>;
 
 export declare interface MapRegionSwitchInteraction {
@@ -4924,6 +4937,8 @@ declare interface SceneCaptureOptions {
     height?: number;
     pixelRatio?: number;
     maxDimension?: number;
+    /** Cancel the result; submitted GPU work settles before its buffers are reused. */
+    signal?: AbortSignal;
 }
 
 /** Scene membership/options delta. Existing authored graphs must use structure patches. */
@@ -4947,7 +4962,7 @@ export declare interface SceneDisplayContext {
     sceneId: string;
     /** 本次准备前已重新适配地图相机；false 的缓存页保留此前视角。 */
     cameraRefitted: boolean;
-    /** 文档替换或 manager 销毁时取消准备。 */
+    /** 文档替换、区域请求取消或 manager 销毁时取消准备。 */
     signal: AbortSignal;
 }
 
@@ -4994,6 +5009,9 @@ export declare class SceneManager extends Event_2 {
     private pencil?;
     private safeAreaInsets?;
     private generation;
+    private mapRequests;
+    private requestedMapDocument?;
+    private navigationWaiters;
     private displayPreparationAbort;
     private documentIdentityRevision;
     private preparedStructures;
@@ -5011,6 +5029,8 @@ export declare class SceneManager extends Event_2 {
     /** Notifications cannot invalidate a transaction that has already committed. */
     private notifySceneObservers;
     private finishNavigation;
+    private wakeNavigationWaiters;
+    private waitForNavigation;
     private disposeInactiveScenes;
     /** Retire inactive pages after the host accepts navigation; failures never undo the active page. */
     trimInactiveScenes(): unknown[];
@@ -5093,6 +5113,13 @@ export declare class SceneManager extends Event_2 {
      */
     loadMapRegion(documentOrUrl: VisSceneDocument | VisSceneManifest | string, sceneId: string, adcode: number, hooks?: Record<string, any>): Promise<Map_4>;
     loadMapRegion(documentOrUrl: VisSceneDocument | VisSceneManifest | string, adcode: number, resolveScene: MapRegionSceneResolver, hooks?: Record<string, any>): Promise<Map_4>;
+    /**
+     * Follow a host's latest region request, loading a new source only when needed.
+     * Superseded requests reject with AbortError; only the latest candidate commits.
+     * Existing click/back navigation finishes before the requested region starts.
+     */
+    requestMapRegion(source: VisSceneDocument | VisSceneManifest | string, adcode: number, resolveScene: MapRegionSceneResolver, options?: MapRegionOptions): Promise<Map_4>;
+    private loadMapRegionRequest;
     private loadDocument;
     private getSceneMetadata;
     private resolveManifestSource;
@@ -5116,7 +5143,7 @@ export declare class SceneManager extends Event_2 {
      * 始终从文档基线构建隔离页面，避免对缓存实例反复施加缩放/删除修正。
      * 旧页面在构建期间保持完整；只有所有资源、几何和交互就绪才提交导航。
      */
-    switchMapRegion(sceneId: string, adcode: number, options?: SwitchSceneOptions, hooks?: Record<string, any>): Promise<Map_4 | null>;
+    switchMapRegion(sceneId: string, adcode: number, options?: MapRegionOptions, hooks?: Record<string, any>): Promise<Map_4 | null>;
     /** 场景切换与区域切换共享一条返回历史。 */
     backMapRegion(hooks?: Record<string, any>): Promise<Base_3 | null>;
     getCurrentSceneId(): string;
@@ -5782,7 +5809,7 @@ declare class UseMaterial extends PointerEvent_2 {
 
 declare type ValuesOf<T extends readonly any[]> = T[number];
 
-export declare const VERSION = "0.33.11";
+export declare const VERSION = "0.33.13";
 
 declare interface Viewport {
     left: number;