vis-core 0.32.6 → 0.32.7

package/dist/index.d.ts

@@ -88,7 +88,9 @@ export declare function assertRuntimeSceneDocument(value: unknown): asserts valu
 
 export declare function assertSupportedSceneDocument(value: unknown): void;
 
-export declare class Base extends Camera {
+export declare type Base = Base_2;
+
+declare class Base_2 extends Camera {
     static VisName: string;
     runtimePolicy: {
         observeParentScale: boolean;
@@ -119,7 +121,7 @@ export declare class Base extends Camera {
     private resolveRendererDepthBufferOptions;
     private showDetectRes;
     setOptions(options: Record<string, any>): void;
-    fromJSON(jsonOrUrl: Record<string, any> | string, hooksE?: Record<string, any>): Promise<void>;
+    /* Excluded from this release type: fromJSON */
     private runtimeInitialization?;
     private disposed;
     /* Excluded from this release type: initializeRuntime */
@@ -393,7 +395,9 @@ declare class DirectionalLight extends DirectionalLightObject {
     render(): void;
 }
 
-export declare class Earth extends Base {
+export declare type Earth = Earth_2;
+
+declare class Earth_2 extends Base_2 {
     static VisName: string;
     leftTruck: boolean;
     options: Required<EarthOptions>;
@@ -404,7 +408,7 @@ export declare class Earth extends Base {
     setOptions(options: EarthOptions): void;
     handleSetting(key: string, value: any): void;
     protected get objectTypes(): {
-        Earth: Earth_2;
+        Earth: Earth_3;
         SphereShadow: SphereShadow;
         Countries: typeof PlaneMap;
         PlaneMap: typeof PlaneMap;
@@ -450,7 +454,7 @@ export declare class Earth extends Base {
     protected onSceneRestored(): Promise<void>;
 }
 
-declare class Earth_2 extends Sphere {
+declare class Earth_3 extends Sphere {
     objectType: string;
     options: Required<Options_4>;
     constructor(options: Options_4);
@@ -473,6 +477,8 @@ declare interface EarthSceneBindings {
     secondaryMap?: string;
 }
 
+export declare type EmptySceneDefinition = Omit<SceneViewportDocument, 'scene'>;
+
 declare class Event_2 {
     event: EventEmitter;
     private eventHandlers;
@@ -517,7 +523,10 @@ declare class HemisphereLight extends HemisphereLightObject {
  */
 export declare function isSceneDocument(value: unknown): value is SceneDocumentMarker & Record<string, any>;
 
-declare class Map_2 extends Base {
+declare type Map_2 = Map_3;
+export { Map_2 as Map }
+
+declare class Map_3 extends Base_2 {
     static VisName: string;
     options: Required<MapCityOptions>;
     /** 当前唯一主地图的运行时状态。 */
@@ -712,7 +721,6 @@ declare class Map_2 extends Base {
     applyRegionTextureRules(adcode: number): Promise<void>;
     protected onDispose(): void;
 }
-export { Map_2 as Map }
 
 declare interface MapAssetSources {
     worldGeojson: string;
@@ -1276,28 +1284,31 @@ export declare class SceneManager extends Event_2 {
     getSafeAreaInsets(): MapSafeAreaInsets;
     private captureCamera;
     private playTransition;
-    /** 接管一个已经恢复完成的场景，供编辑器首次加载时复用。 */
-    attach(document: VisSceneDocument, sceneId: string, scene: Base): Base;
     /** 更新可编辑文档，并释放已经不属于文档的非活动场景实例。 */
     setDocument(document: VisSceneDocument): void;
-    load(documentOrUrl: VisSceneDocument | string, hooks?: Record<string, any>): Promise<Base>;
+    load(documentOrUrl: VisSceneDocument | string, hooks?: Record<string, any>): Promise<Base_2>;
+    /**
+     * 创建一个没有快照输入的运行时页面，并在可选构建步骤完成后将其导出为
+     * 标准单场景文档。主要供编辑器新建和旧模板迁移使用。
+     */
+    createEmptyScene(definition: EmptySceneDefinition, build?: (scene: Base_2) => void | Promise<void>): Promise<Base_2>;
     /**
      * 以指定地图模板和行政区直接启动，不先加载文档配置的入口场景。
      * 适用于宿主按路由或业务参数决定初始省、市、区的场景。
      */
-    loadMapRegion(documentOrUrl: VisSceneDocument | string, sceneId: string, adcode: number, hooks?: Record<string, any>): Promise<Map_2>;
-    loadMapRegion(documentOrUrl: VisSceneDocument | string, adcode: number, resolveScene: MapRegionSceneResolver, hooks?: Record<string, any>): Promise<Map_2>;
+    loadMapRegion(documentOrUrl: VisSceneDocument | string, sceneId: string, adcode: number, hooks?: Record<string, any>): Promise<Map_3>;
+    loadMapRegion(documentOrUrl: VisSceneDocument | string, adcode: number, resolveScene: MapRegionSceneResolver, hooks?: Record<string, any>): Promise<Map_3>;
     private loadDocument;
-    switchScene(sceneId: string, options?: SwitchSceneOptions, hooks?: Record<string, any>): Promise<Base | null>;
+    switchScene(sceneId: string, options?: SwitchSceneOptions, hooks?: Record<string, any>): Promise<Base_2 | null>;
     /**
      * 恢复并缓存一个非活动场景，不改变当前场景、导航历史或相机。
      * 适合预制件场景：调用方可从返回实例取对象，再通过 instantiate({ target })
      * 直接实例化到当前场景。
      */
-    preloadScene(sceneId: string, hooks?: Record<string, any>): Promise<Base>;
+    preloadScene(sceneId: string, hooks?: Record<string, any>): Promise<Base_2>;
     /** 编辑器事务：在独立页面上修改参数并重建快照，成功后一起提交文档和实例。 */
-    editScene(sceneId: string, edit: (scene: Base, definition: SceneViewportDocument) => Promise<SceneViewportDocument>, hooks?: Record<string, any>): Promise<Base>;
-    back(hooks?: Record<string, any>): Promise<Base | null>;
+    editScene(sceneId: string, edit: (scene: Base_2, definition: SceneViewportDocument) => Promise<SceneViewportDocument>, hooks?: Record<string, any>): Promise<Base_2>;
+    back(hooks?: Record<string, any>): Promise<Base_2 | null>;
     /**
      * 切到目标地图场景，并按 adcode 重建其中的地图。sceneId 不同时，语义等价于
      * switchScene(sceneId) 后 switchMapRegion(adcode)，但候选场景只在两步都成功后提交，
@@ -1305,17 +1316,17 @@ export declare class SceneManager extends Event_2 {
      * 始终从文档基线构建隔离页面，避免对缓存实例反复施加缩放/删除修正。
      * 旧页面在构建期间保持完整；只有所有资源、几何和交互就绪才提交导航。
      */
-    switchMapRegion(sceneId: string, adcode: number, options?: SwitchSceneOptions, hooks?: Record<string, any>): Promise<Map_2 | null>;
+    switchMapRegion(sceneId: string, adcode: number, options?: SwitchSceneOptions, hooks?: Record<string, any>): Promise<Map_3 | null>;
     /** 场景切换与区域切换共享一条返回历史。 */
-    backMapRegion(hooks?: Record<string, any>): Promise<Base | null>;
+    backMapRegion(hooks?: Record<string, any>): Promise<Base_2 | null>;
     getCurrentSceneId(): string;
     getCurrentScene<T extends SceneType>(type: T): SceneTypeMap[T] | null;
-    getCurrentScene(): Base | null;
+    getCurrentScene(): Base_2 | null;
     private getCurrentSceneByType;
     getScene<T extends SceneType>(sceneId: string, type: T): SceneTypeMap[T] | undefined;
-    getScene(sceneId: string): Base | undefined;
+    getScene(sceneId: string): Base_2 | undefined;
     getSceneByName<T extends SceneType>(name: string, type: T): SceneTypeMap[T] | undefined;
-    getSceneByName(name: string): Base | undefined;
+    getSceneByName(name: string): Base_2 | undefined;
     private getSceneByType;
     getDocument(): VisSceneDocument | undefined;
     private bindSceneInteractions;
@@ -1330,7 +1341,7 @@ export declare interface SceneManagerBehaviorOptions {
     /** 输出射线命中和场景交互诊断，仅用于开发排查。 */
     debugInteractions?: boolean;
     /** 创建场景后、恢复 JSON 前调用。 */
-    prepareScene?: (scene: Base) => void;
+    prepareScene?: (scene: Base_2) => void;
     /** 是否保留非活动场景实例；编辑器可关闭以限制 GPU/内存占用。 */
     cacheScenes?: boolean;
 }
@@ -1362,9 +1373,9 @@ export declare interface SceneTransitionOptions {
 export declare type SceneType = keyof SceneTypeMap;
 
 export declare interface SceneTypeMap {
-    base: Base;
-    earth: Earth;
-    map: Map_2;
+    base: Base_2;
+    earth: Earth_2;
+    map: Map_3;
 }
 
 export declare interface SceneViewportDocument {
@@ -1463,7 +1474,7 @@ export { TWEEN }
 
 export { Tween }
 
-export declare const VERSION = "0.32.6";
+export declare const VERSION = "0.32.7";
 
 export declare interface VisSceneDocument extends SceneDocumentMarker {
     entrySceneId: string;