vis-core 0.32.6 → 0.32.8

package/dist/index.d.ts

@@ -86,9 +86,13 @@ declare class Area extends GroupObject {
 /** vis-core 的运行时入口只接受编辑平台导出的完整场景文档。 */
 export declare function assertRuntimeSceneDocument(value: unknown): asserts value is VisSceneDocument & Record<string, any>;
 
+export declare function assertSceneManifest(value: unknown): asserts value is VisSceneManifest;
+
 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 +123,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 +397,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 +410,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 +456,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 +479,8 @@ declare interface EarthSceneBindings {
     secondaryMap?: string;
 }
 
+export declare type EmptySceneDefinition = Omit<SceneViewportDocument, 'scene'>;
+
 declare class Event_2 {
     event: EventEmitter;
     private eventHandlers;
@@ -517,7 +525,12 @@ declare class HemisphereLight extends HemisphereLightObject {
  */
 export declare function isSceneDocument(value: unknown): value is SceneDocumentMarker & Record<string, any>;
 
-declare class Map_2 extends Base {
+export declare function isSceneManifest(value: unknown): value is VisSceneManifest;
+
+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 +725,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;
@@ -1212,6 +1224,10 @@ export declare const SCENE_DOCUMENT_FORMAT: "vis-scene";
 
 export declare const SCENE_DOCUMENT_SCHEMA_VERSION: 3;
 
+export declare const SCENE_MANIFEST_FORMAT: "vis-scene-manifest";
+
+export declare const SCENE_MANIFEST_SCHEMA_VERSION: 1;
+
 export declare interface SceneBackInteraction {
     trigger: 'click' | 'clickOutside';
     objectId: string;
@@ -1255,6 +1271,10 @@ export declare interface SceneInteractionFilter {
 export declare class SceneManager extends Event_2 {
     private options;
     private document?;
+    private manifest?;
+    private manifestUrl?;
+    private loadedDefinitions;
+    private definitionLoads;
     private runtimeHooks?;
     private instances;
     private currentSceneId;
@@ -1276,28 +1296,35 @@ 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 | VisSceneManifest | 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 | VisSceneManifest | string, sceneId: string, adcode: number, hooks?: Record<string, any>): Promise<Map_3>;
+    loadMapRegion(documentOrUrl: VisSceneDocument | VisSceneManifest | 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>;
+    private getSceneMetadata;
+    private resolveManifestSource;
+    private loadSceneDefinition;
+    private createRuntimeSceneDocument;
+    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,19 +1332,20 @@ 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;
+    getManifest(): VisSceneManifest | undefined;
     private bindSceneInteractions;
     canBack(): boolean;
     private disposeInstances;
@@ -1330,9 +1358,11 @@ export declare interface SceneManagerBehaviorOptions {
     /** 输出射线命中和场景交互诊断，仅用于开发排查。 */
     debugInteractions?: boolean;
     /** 创建场景后、恢复 JSON 前调用。 */
-    prepareScene?: (scene: Base) => void;
+    prepareScene?: (scene: Base_2) => void;
     /** 是否保留非活动场景实例；编辑器可关闭以限制 GPU/内存占用。 */
     cacheScenes?: boolean;
+    /** 自定义分包场景读取器；可从 IndexedDB 等非 HTTP 存储按需读取。 */
+    loadScene?: (entry: SceneManifestEntry) => Promise<SceneViewportDocument>;
 }
 
 export declare type SceneManagerInitOptions = SceneManagerOptions & SceneManagerBehaviorOptions;
@@ -1344,6 +1374,13 @@ export declare interface SceneManagerOptions extends Pick<BaseOptions, 'containe
     safeAreaInsets?: Partial<MapSafeAreaInsets>;
 }
 
+export declare interface SceneManifestEntry extends Omit<SceneViewportDocument, 'scene'> {
+    /** Relative to the manifest URL unless an absolute URL is supplied. */
+    source: string;
+    /** Uncompressed JSON bytes, used only for diagnostics and progress UI. */
+    bytes?: number;
+}
+
 export declare interface SceneSwitchInteraction {
     trigger: 'click' | 'clickOutside';
     objectId: string;
@@ -1362,9 +1399,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 {
@@ -1414,6 +1451,21 @@ declare class SphereShadow extends MeshObject {
     rebuildFromScene(): void;
 }
 
+/**
+ * Creates deployable, independently fetchable scene JSON values. Resources are
+ * expanded per scene so loading the entry scene never requires a global pool.
+ */
+export declare function splitSceneDocument(document: VisSceneDocument, options?: {
+    sceneDirectory?: string;
+    extension?: '.json' | '.json.gz';
+}): SplitSceneDocumentBundle;
+
+export declare interface SplitSceneDocumentBundle {
+    manifest: VisSceneManifest;
+    /** Keys are the relative source paths written into the manifest. */
+    scenes: Record<string, SceneViewportDocument>;
+}
+
 declare class SpotLight extends SpotLightObject {
     constructor(...options: ConstructorParameters<typeof SpotLightObject>);
     update(delta: number, elapsed: number): void;
@@ -1463,7 +1515,7 @@ export { TWEEN }
 
 export { Tween }
 
-export declare const VERSION = "0.32.6";
+export declare const VERSION = "0.32.8";
 
 export declare interface VisSceneDocument extends SceneDocumentMarker {
     entrySceneId: string;
@@ -1476,6 +1528,17 @@ export declare interface VisSceneDocument extends SceneDocumentMarker {
     s?: string;
 }
 
+export declare interface VisSceneManifest {
+    format: typeof SCENE_MANIFEST_FORMAT;
+    schemaVersion: typeof SCENE_MANIFEST_SCHEMA_VERSION;
+    entrySceneId: string;
+    scenes: SceneManifestEntry[];
+    c?: Record<string, any>;
+    d?: Record<string, any>;
+    h?: Record<string, any>;
+    s?: string;
+}
+
 export { }