vis-core 0.33.0 → 0.33.2

package/dist/index.d.ts

@@ -87,7 +87,7 @@ declare class Area extends GroupObject {
 }
 
 /** Validation is read-only and does not materialize or allocate runtime resources. */
-export declare function assertProjectMaterials(document: Pick<VisSceneDocument, 'schemaVersion' | 'scenes' | 'materialLibrary' | 'prefabLibrary'>): void;
+export declare function assertProjectMaterials(document: Pick<VisSceneDocument, 'schemaVersion' | 'scenes' | 'materialLibrary' | 'prefabLibrary' | '_resourcePool'>): void;
 
 /** vis-core 的运行时入口只接受编辑平台导出的完整场景文档。 */
 export declare function assertRuntimeSceneDocument(value: unknown): asserts value is VisSceneDocument & Record<string, any>;
@@ -479,6 +479,7 @@ export declare function createRuntimeSceneDocument(document: VisSceneDocument):
 /** Convert authored asset aliases to the native catalog expected by graph restoration. */
 export declare function createRuntimeSceneGraph(scene: SceneViewportDocument, options?: {
     omitPrefabPreviews?: boolean;
+    /* Excluded from this release type: consumeInput */
 }): Record<string, any>;
 
 declare class DirectionalLight extends DirectionalLightObject {
@@ -590,6 +591,8 @@ declare class Event_2 {
     dispose(): void;
 }
 
+/* Excluded from this release type: expandOwnedSceneDocumentResources */
+
 /** Expand at the editor import boundary so independently edited scenes own their data. */
 export declare function expandSceneDocumentResources<T extends VisSceneDocument>(document: T): T;
 
@@ -1001,7 +1004,7 @@ export declare interface MaterialAsset {
     revision: number;
     scope: MaterialScope;
     name: string;
-    /** A complete Material.toJSON() value, including texture and image dependencies. */
+    /** Complete Material.toJSON(); schema 6 exports may pool image/texture payloads. */
     material: Record<string, any>;
     locked?: boolean;
 }
@@ -1017,6 +1020,8 @@ export declare interface MaterialDefinitionScope {
 /** One explicit mapping from an asset's authored resource UUIDs to runtime resource UUIDs. */
 export declare function materializeAssetDefinition(asset: MaterialAsset, materialUuid?: string): Record<string, any>;
 
+/* Excluded from this release type: materializeOwnedProjectMaterials */
+
 /** Mutate a detached working snapshot owned exclusively by the caller. */
 export declare function materializeOwnedSceneMaterials<T extends SceneViewportDocument>(scene: T, library?: MaterialAsset[]): T;
 
@@ -1140,10 +1145,11 @@ declare class Mountain extends GroupObject {
     }[];
     create(): Promise<void>;
     setNoise(geometry: THREE.BufferGeometry, image: HTMLImageElement, maxHeight?: number): void;
-    render(): void;
     rebuildFromScene(): void;
 }
 
+/* Excluded from this release type: normalizeOwnedProjectMaterials */
+
 /** Bind serialized runtime materials and alias catalogs to authored assets. */
 export declare function normalizeProjectMaterials<T extends VisSceneDocument>(document: T): T;
 
@@ -1323,6 +1329,8 @@ declare class PlaneMap extends GroupObject {
     mergeSideArea: ExtrudePolygonObject | null;
     extrudelineArr?: LineObject[];
     splitPolygons: number;
+    private standaloneHideMaterial?;
+    private getHideMaterial;
     constructor(options: Options);
     create(): Promise<void>;
     private markGeneratedObjects;
@@ -1403,6 +1411,8 @@ export declare interface PrefabAsset {
     revision: number;
     /** Stable public SDK identifier. Omit for assets used only by the editor. */
     sdkKey?: string;
+    /** Legacy business templates own complete material snapshots, without promoting scene assets. */
+    materialMode?: 'embedded';
     snapshot: Record<string, any>;
 }
 
@@ -1481,11 +1491,14 @@ declare interface RuntimeImageAsset {
 
 export declare const SCENE_DOCUMENT_FORMAT: "vis-scene";
 
-export declare const SCENE_DOCUMENT_SCHEMA_VERSION: 5;
+/** Schema 6 extends the document pool to authored material dependencies. */
+export declare const SCENE_DOCUMENT_RESOURCE_POOL_SCHEMA_VERSION: 6;
+
+export declare const SCENE_DOCUMENT_SCHEMA_VERSION: 6;
 
 export declare const SCENE_MANIFEST_FORMAT: "vis-scene-manifest";
 
-export declare const SCENE_MANIFEST_SCHEMA_VERSION: 2;
+export declare const SCENE_MANIFEST_SCHEMA_VERSION: 3;
 
 export declare interface SceneBackInteraction {
     trigger: 'click' | 'clickOutside';
@@ -1562,11 +1575,17 @@ export declare class SceneManager extends Event_2 {
     private identityTrackedScenes;
     private prefabOperations;
     private transactionCacheDepth;
+    private materialLibraryResources?;
     private invalidatePendingOperations;
     private assertGeneration;
     private debugInteraction;
     private enablePickDebug;
     private disposeInactiveScenes;
+    /** Retire inactive pages after the host accepts navigation; failures never undo the active page. */
+    trimInactiveScenes(): unknown[];
+    /** Update host navigation policy when lifecycle scripts change between scene activations. */
+    setSceneCachePolicy(cacheScenes: boolean, maxCachedScenes?: number | undefined): void;
+    private reportSceneRetirementErrors;
     constructor(options: SceneManagerInitOptions);
     private prepareScene;
     /** Publish one identity remap without exporting runtimes or copying other pages/resources. */
@@ -1581,6 +1600,10 @@ export declare class SceneManager extends Event_2 {
     private playTransition;
     /** 更新可编辑文档，并释放已经不属于文档的非活动场景实例。 */
     setDocument(document: VisSceneDocument): void;
+    /** Standalone material consumers cannot retain document-level pool references. */
+    private resolvedMaterialLibrary;
+    /** Keep scene payloads lazy, while independent material APIs own a resolved catalog. */
+    private ownDocument;
     private syncPrefabLibraries;
     /**
      * Replace the complete metadata projection for existing scenes without
@@ -1647,8 +1670,6 @@ export declare class SceneManager extends Event_2 {
     switchScene(sceneId: string, options?: SwitchSceneOptions, hooks?: Record<string, any>): Promise<Base_2 | null>;
     /**
      * 恢复并缓存一个非活动场景，不改变当前场景、导航历史或相机。
-     * 适合预制件场景：调用方可从返回实例取对象，再通过 instantiate({ target })
-     * 直接实例化到当前场景。
      */
     preloadScene(sceneId: string, hooks?: Record<string, any>): Promise<Base_2>;
     /** 编辑器事务：在独立页面上修改参数并重建快照，成功后一起提交文档和实例。 */
@@ -1705,6 +1726,8 @@ export declare interface SceneManagerBehaviorOptions {
     prepareScene?: (scene: Base_2) => void;
     /** 是否保留非活动场景实例；编辑器可关闭以限制 GPU/内存占用。 */
     cacheScenes?: boolean;
+    /** Pages retained after navigation, including the active page; oldest inactive pages retire first. */
+    maxCachedScenes?: number;
     /** 自定义分包场景读取器；可从 IndexedDB 等非 HTTP 存储按需读取。 */
     loadScene?: (entry: SceneManifestEntry) => Promise<SceneViewportDocument>;
 }
@@ -1906,8 +1929,8 @@ declare class SphereShadow extends MeshObject {
 }
 
 /**
- * Creates deployable, independently fetchable scene JSON values. Resources are
- * expanded per scene so loading the entry scene never requires a global pool.
+ * Creates independently fetchable scene JSON values. Manifest 3 owns shared
+ * payloads so scene and catalog copies do not multiply the deployed bytes.
  */
 export declare function splitSceneDocument(document: VisSceneDocument, options?: {
     sceneDirectory?: string;
@@ -1970,12 +1993,12 @@ declare interface TweenOptions {
 
 export declare function updateProjectMaterial<T extends VisSceneDocument>(document: T, assetId: string, patch: Partial<Pick<MaterialAsset, 'name' | 'material' | 'locked'>>): T;
 
-export declare const VERSION = "0.33.0";
+export declare const VERSION = "0.33.2";
 
 export declare interface VisSceneDocument extends SceneDocumentMarker {
     entrySceneId: string;
     scenes: SceneViewportDocument[];
-    /** Schema 3: image/video/data payloads shared across scenes, never live textures. */
+    /** Schema 3: scene payloads; schema 6 also shares material-library payloads. */
     _resourcePool?: any[];
     /** Schema 4: serializable definitions shared by explicit asset identity. */
     materialLibrary?: MaterialAsset[];
@@ -1989,10 +2012,12 @@ export declare interface VisSceneDocument extends SceneDocumentMarker {
 
 export declare interface VisSceneManifest {
     format: typeof SCENE_MANIFEST_FORMAT;
-    schemaVersion: 1 | typeof SCENE_MANIFEST_SCHEMA_VERSION;
+    schemaVersion: 1 | 2 | typeof SCENE_MANIFEST_SCHEMA_VERSION;
     entrySceneId: string;
     scenes: SceneManifestEntry[];
     materialLibrary?: MaterialAsset[];
+    /** Manifest 3: payloads referenced by the material catalog and scene files. */
+    _resourcePool?: any[];
     /** Externalized image files, relative to the manifest URL. */
     imageAssets?: string[];
     /** Reusable definitions. Only assets with sdkKey are available for SDK instantiation. */