vis-core 0.32.7 → 0.32.8

package/dist/index.d.ts

@@ -86,6 +86,8 @@ 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 type Base = Base_2;
@@ -523,6 +525,8 @@ declare class HemisphereLight extends HemisphereLightObject {
  */
 export declare function isSceneDocument(value: unknown): value is SceneDocumentMarker & Record<string, any>;
 
+export declare function isSceneManifest(value: unknown): value is VisSceneManifest;
+
 declare type Map_2 = Map_3;
 export { Map_2 as Map }
 
@@ -1220,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;
@@ -1263,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;
@@ -1286,7 +1298,7 @@ export declare class SceneManager extends Event_2 {
     private playTransition;
     /** 更新可编辑文档，并释放已经不属于文档的非活动场景实例。 */
     setDocument(document: VisSceneDocument): void;
-    load(documentOrUrl: VisSceneDocument | string, hooks?: Record<string, any>): Promise<Base_2>;
+    load(documentOrUrl: VisSceneDocument | VisSceneManifest | string, hooks?: Record<string, any>): Promise<Base_2>;
     /**
      * 创建一个没有快照输入的运行时页面，并在可选构建步骤完成后将其导出为
      * 标准单场景文档。主要供编辑器新建和旧模板迁移使用。
@@ -1296,9 +1308,13 @@ export declare class SceneManager extends Event_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>;
+    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;
+    private getSceneMetadata;
+    private resolveManifestSource;
+    private loadSceneDefinition;
+    private createRuntimeSceneDocument;
     switchScene(sceneId: string, options?: SwitchSceneOptions, hooks?: Record<string, any>): Promise<Base_2 | null>;
     /**
      * 恢复并缓存一个非活动场景，不改变当前场景、导航历史或相机。
@@ -1329,6 +1345,7 @@ export declare class SceneManager extends Event_2 {
     getSceneByName(name: string): Base_2 | undefined;
     private getSceneByType;
     getDocument(): VisSceneDocument | undefined;
+    getManifest(): VisSceneManifest | undefined;
     private bindSceneInteractions;
     canBack(): boolean;
     private disposeInstances;
@@ -1344,6 +1361,8 @@ export declare interface SceneManagerBehaviorOptions {
     prepareScene?: (scene: Base_2) => void;
     /** 是否保留非活动场景实例；编辑器可关闭以限制 GPU/内存占用。 */
     cacheScenes?: boolean;
+    /** 自定义分包场景读取器；可从 IndexedDB 等非 HTTP 存储按需读取。 */
+    loadScene?: (entry: SceneManifestEntry) => Promise<SceneViewportDocument>;
 }
 
 export declare type SceneManagerInitOptions = SceneManagerOptions & SceneManagerBehaviorOptions;
@@ -1355,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;
@@ -1425,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;
@@ -1474,7 +1515,7 @@ export { TWEEN }
 
 export { Tween }
 
-export declare const VERSION = "0.32.7";
+export declare const VERSION = "0.32.8";
 
 export declare interface VisSceneDocument extends SceneDocumentMarker {
     entrySceneId: string;
@@ -1487,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 { }