vis-core 0.33.0 → 0.33.1

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>;
@@ -1001,7 +1001,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;
 }
@@ -1481,11 +1481,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,6 +1565,7 @@ export declare class SceneManager extends Event_2 {
     private identityTrackedScenes;
     private prefabOperations;
     private transactionCacheDepth;
+    private materialLibraryResources?;
     private invalidatePendingOperations;
     private assertGeneration;
     private debugInteraction;
@@ -1581,6 +1585,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
@@ -1906,8 +1914,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 +1978,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.1";
 
 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 +1997,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. */