vis-core 0.33.14 → 0.33.15

package/dist/index.d.ts

@@ -4678,7 +4678,12 @@ export declare function remapProjectMaterialIds<T extends VisSceneDocument>(docu
  * 复制一组场景并为它们分配新 ID，同时保持文档内部的场景跳转关系。
  * 用于把完整模板追加到另一个场景文档中。
  */
-export declare function remapSceneDocumentIds(document: VisSceneDocument, createSceneId: (scene: SceneViewportDocument, index: number) => string): RemappedSceneDocument;
+export declare function remapSceneDocumentIds(document: VisSceneDocument, createSceneId: (scene: SceneViewportDocument, index: number) => string, options?: {
+    /** Leave authored definitions in the library until the selected scene loads. */
+    materialize?: boolean;
+    /** Resolve cross-project material collisions in the same ownership pass. */
+    occupiedMaterialIds?: Iterable<string>;
+}): RemappedSceneDocument;
 
 export declare const remapSceneMaterialReferencesCopy: <T>(scene: T, previous: string, next: string) => T;
 
@@ -4872,6 +4877,8 @@ declare class ResourceScope {
 }
 
 declare interface RestoreBaseObjectOptions {
+    /** Image loading boundaries, before native materials and scene objects are restored. */
+    onResourceLoad?: (phase: 'start' | 'done') => void | Promise<void>;
     /** Transfer an exclusively owned snapshot between packages; restoration may mutate it. */
     consumeInput?: boolean;
     /** The caller must validate equality with the serialized resource definitions. */
@@ -5103,7 +5110,12 @@ export declare class SceneManager extends Event_2 {
     commitSceneStructure(prepared: PreparedSceneStructure): void;
     /** Commit scalar material history without accepting or copying caller object graphs. */
     patchMaterialDefinitions(assets: MaterialAsset[], scenes: Pick<SceneViewportDocument, 'id'>[], scope?: MaterialDefinitionScope): void;
-    load(documentOrUrl: VisSceneDocument | VisSceneManifest | string, hooks?: Record<string, any>): Promise<Base_3>;
+    load(documentOrUrl: VisSceneDocument | VisSceneManifest | string, hooks?: Record<string, any>, options?: {
+        /** Transfer a detached document to the manager; the caller must not mutate it afterwards. */
+        consumeInput?: boolean;
+        /** Restore a saved active scene without changing the project's entry scene. */
+        sceneId?: string;
+    }): Promise<Base_3>;
     /**
      * 创建一个没有快照输入的运行时页面，并在可选构建步骤完成后将其导出为
      * 标准单场景文档。主要供编辑器新建和旧模板迁移使用。
@@ -5398,18 +5410,22 @@ export declare interface SceneStructurePatch {
         set?: Partial<Record<SceneStructureGraphKey, any>>;
         unset?: SceneStructureGraphKey[];
     };
+    /** Optional order lists every final row identity, including unchanged rows. */
     resources?: Partial<Record<SceneStructureResource, {
         upsert?: Record<string, any>[];
         remove?: string[];
+        order?: string[];
         unset?: true;
     }>>;
     assets?: {
         upsert?: MaterialAsset[];
         remove?: string[];
+        order?: string[];
     };
     prefabs?: {
         upsert?: PrefabAsset[];
         remove?: string[];
+        order?: string[];
     };
 }
 
@@ -5811,7 +5827,7 @@ declare class UseMaterial extends PointerEvent_2 {
 
 declare type ValuesOf<T extends readonly any[]> = T[number];
 
-export declare const VERSION = "0.33.14";
+export declare const VERSION = "0.33.15";
 
 declare interface Viewport {
     left: number;