@galacean/cli 2.0.0-alpha.26 → 2.0.0-alpha.27

package/dist/cli.bundle.cjs

@@ -1226,7 +1226,7 @@ var require_command = __commonJS({
     var childProcess = require("node:child_process");
     var path23 = require("node:path");
     var fs5 = require("node:fs");
-    var process6 = require("node:process");
+    var process7 = require("node:process");
     var { Argument: Argument2, humanReadableArgName } = require_argument();
     var { CommanderError: CommanderError2 } = require_error();
     var { Help: Help2, stripColor } = require_help();
@@ -1273,13 +1273,13 @@ var require_command = __commonJS({
         this._showSuggestionAfterError = true;
         this._savedState = null;
         this._outputConfiguration = {
-          writeOut: (str) => process6.stdout.write(str),
-          writeErr: (str) => process6.stderr.write(str),
+          writeOut: (str) => process7.stdout.write(str),
+          writeErr: (str) => process7.stderr.write(str),
           outputError: (str, write2) => write2(str),
-          getOutHelpWidth: () => process6.stdout.isTTY ? process6.stdout.columns : void 0,
-          getErrHelpWidth: () => process6.stderr.isTTY ? process6.stderr.columns : void 0,
-          getOutHasColors: () => useColor() ?? (process6.stdout.isTTY && process6.stdout.hasColors?.()),
-          getErrHasColors: () => useColor() ?? (process6.stderr.isTTY && process6.stderr.hasColors?.()),
+          getOutHelpWidth: () => process7.stdout.isTTY ? process7.stdout.columns : void 0,
+          getErrHelpWidth: () => process7.stderr.isTTY ? process7.stderr.columns : void 0,
+          getOutHasColors: () => useColor() ?? (process7.stdout.isTTY && process7.stdout.hasColors?.()),
+          getErrHasColors: () => useColor() ?? (process7.stderr.isTTY && process7.stderr.hasColors?.()),
           stripColor: (str) => stripColor(str)
         };
         this._hidden = false;
@@ -1684,7 +1684,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
         if (this._exitCallback) {
           this._exitCallback(new CommanderError2(exitCode, code, message));
         }
-        process6.exit(exitCode);
+        process7.exit(exitCode);
       }
       /**
        * Register callback `fn` for the command.
@@ -2084,16 +2084,16 @@ Expecting one of '${allowedValues.join("', '")}'`);
         }
         parseOptions = parseOptions || {};
         if (argv === void 0 && parseOptions.from === void 0) {
-          if (process6.versions?.electron) {
+          if (process7.versions?.electron) {
             parseOptions.from = "electron";
           }
-          const execArgv = process6.execArgv ?? [];
+          const execArgv = process7.execArgv ?? [];
           if (execArgv.includes("-e") || execArgv.includes("--eval") || execArgv.includes("-p") || execArgv.includes("--print")) {
             parseOptions.from = "eval";
           }
         }
         if (argv === void 0) {
-          argv = process6.argv;
+          argv = process7.argv;
         }
         this.rawArgs = argv.slice();
         let userArgs;
@@ -2104,7 +2104,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
             userArgs = argv.slice(2);
             break;
           case "electron":
-            if (process6.defaultApp) {
+            if (process7.defaultApp) {
               this._scriptPath = argv[1];
               userArgs = argv.slice(2);
             } else {
@@ -2295,11 +2295,11 @@ Expecting one of '${allowedValues.join("', '")}'`);
         }
         launchWithNode = sourceExt.includes(path23.extname(executableFile));
         let proc;
-        if (process6.platform !== "win32") {
+        if (process7.platform !== "win32") {
           if (launchWithNode) {
             args.unshift(executableFile);
-            args = incrementNodeInspectorPort(process6.execArgv).concat(args);
-            proc = childProcess.spawn(process6.argv[0], args, { stdio: "inherit" });
+            args = incrementNodeInspectorPort(process7.execArgv).concat(args);
+            proc = childProcess.spawn(process7.argv[0], args, { stdio: "inherit" });
           } else {
             proc = childProcess.spawn(executableFile, args, { stdio: "inherit" });
           }
@@ -2310,13 +2310,13 @@ Expecting one of '${allowedValues.join("', '")}'`);
             subcommand._name
           );
           args.unshift(executableFile);
-          args = incrementNodeInspectorPort(process6.execArgv).concat(args);
-          proc = childProcess.spawn(process6.execPath, args, { stdio: "inherit" });
+          args = incrementNodeInspectorPort(process7.execArgv).concat(args);
+          proc = childProcess.spawn(process7.execPath, args, { stdio: "inherit" });
         }
         if (!proc.killed) {
           const signals = ["SIGUSR1", "SIGUSR2", "SIGTERM", "SIGINT", "SIGHUP"];
           signals.forEach((signal) => {
-            process6.on(signal, () => {
+            process7.on(signal, () => {
               if (proc.killed === false && proc.exitCode === null) {
                 proc.kill(signal);
               }
@@ -2327,7 +2327,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
         proc.on("close", (code) => {
           code = code ?? 1;
           if (!exitCallback) {
-            process6.exit(code);
+            process7.exit(code);
           } else {
             exitCallback(
               new CommanderError2(
@@ -2349,7 +2349,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
             throw new Error(`'${executableFile}' not executable`);
           }
           if (!exitCallback) {
-            process6.exit(1);
+            process7.exit(1);
           } else {
             const wrappedError = new CommanderError2(
               1,
@@ -2854,13 +2854,13 @@ Expecting one of '${allowedValues.join("', '")}'`);
        */
       _parseOptionsEnv() {
         this.options.forEach((option) => {
-          if (option.envVar && option.envVar in process6.env) {
+          if (option.envVar && option.envVar in process7.env) {
             const optionKey = option.attributeName();
             if (this.getOptionValue(optionKey) === void 0 || ["default", "config", "env"].includes(
               this.getOptionValueSource(optionKey)
             )) {
               if (option.required || option.optional) {
-                this.emit(`optionEnv:${option.name()}`, process6.env[option.envVar]);
+                this.emit(`optionEnv:${option.name()}`, process7.env[option.envVar]);
               } else {
                 this.emit(`optionEnv:${option.name()}`);
               }
@@ -3401,7 +3401,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        */
       help(contextOptions) {
         this.outputHelp(contextOptions);
-        let exitCode = Number(process6.exitCode ?? 0);
+        let exitCode = Number(process7.exitCode ?? 0);
         if (exitCode === 0 && contextOptions && typeof contextOptions !== "function" && contextOptions.error) {
           exitCode = 1;
         }
@@ -3491,9 +3491,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
       });
     }
     function useColor() {
-      if (process6.env.NO_COLOR || process6.env.FORCE_COLOR === "0" || process6.env.FORCE_COLOR === "false")
+      if (process7.env.NO_COLOR || process7.env.FORCE_COLOR === "0" || process7.env.FORCE_COLOR === "false")
         return false;
-      if (process6.env.FORCE_COLOR || process6.env.CLICOLOR_FORCE !== void 0)
+      if (process7.env.FORCE_COLOR || process7.env.CLICOLOR_FORCE !== void 0)
         return true;
       return void 0;
     }
@@ -8058,9 +8058,9 @@ async function readRemoteConfig2(fs5, projectDir) {
   return { projectId, serverUrl };
 }
 async function readProjectConfig2(fs5, projectDir) {
-  const projectPath = import_node_path6.default.resolve(projectDir, "project.galacean");
+  const projectPath2 = import_node_path6.default.resolve(projectDir, "project.galacean");
   try {
-    const raw = decodeUtf82(await fs5.readFile(projectPath));
+    const raw = decodeUtf82(await fs5.readFile(projectPath2));
     return safeParseJsonObject2(raw);
   } catch {
     return {};
@@ -38908,8 +38908,13 @@ var init_src4 = __esm({
 function contextSuffix(context) {
   return context ? ` in ${context}` : "";
 }
-function isEditorAssetIdLikeSourceRef(sourceRef) {
-  return INTERNAL_ASSET_ID_REF_PATTERN.test(sourceRef) || UUID_ASSET_ID_REF_PATTERN.test(sourceRef);
+function hasEditorTypeExtension(sourceRef) {
+  const lastSegment = sourceRef.split("/").pop() ?? sourceRef;
+  const normalizedLastSegment = lastSegment.toLowerCase();
+  return EDITOR_TYPE_EXTENSIONS.some((extension) => normalizedLastSegment.endsWith(extension));
+}
+function isValidSourceAssetRef(sourceRef) {
+  return typeof sourceRef === "string" && sourceRef.length > 0 && !isUrlLikeSourceRef(sourceRef) && !sourceRef.includes("/") && !sourceRef.includes("\\") && !hasEditorTypeExtension(sourceRef);
 }
 function isUrlLikeSourceRef(sourceRef) {
   return URL_LIKE_SOURCE_REF_PATTERN.test(sourceRef);
@@ -38917,71 +38922,45 @@ function isUrlLikeSourceRef(sourceRef) {
 function normalizeSourceVirtualPath(value) {
   return value.replace(/\\/g, "/").replace(/^\/+/, "");
 }
-function assertCanonicalSourceRef(sourceRef, context) {
+function assertSourceAssetRef(sourceRef, context) {
   if (typeof sourceRef !== "string" || sourceRef.length === 0) {
-    throw new Error(`Source sentinel $ref must not be empty${contextSuffix(context)}`);
-  }
-  if (isEditorAssetIdLikeSourceRef(sourceRef)) {
-    throw new Error(`Source sentinel $ref must be a canonical virtualPath, not editor asset id "${sourceRef}"`);
+    throw new Error(`Source $ref must not be empty${contextSuffix(context)}`);
   }
   if (isUrlLikeSourceRef(sourceRef)) {
-    throw new Error(`Source sentinel $ref must be a canonical virtualPath, not URL "${sourceRef}"`);
-  }
-  if (sourceRef.startsWith("/")) {
-    throw new Error(`Source sentinel $ref must be a canonical virtualPath without leading slash "${sourceRef}"`);
+    throw new Error(`Source $ref must be an asset id, not a URL: "${sourceRef}"${contextSuffix(context)}`);
   }
-  if (sourceRef.includes("\\")) {
-    throw new Error(`Source sentinel $ref must use "/" path separators "${sourceRef}"`);
+  if (sourceRef.includes("/") || sourceRef.includes("\\")) {
+    throw new Error(`Source $ref must be an asset id, not a path: "${sourceRef}"${contextSuffix(context)}`);
   }
-  if (sourceRef.includes("//") || DOT_SEGMENT_SOURCE_REF_PATTERN.test(sourceRef)) {
-    throw new Error(`Source sentinel $ref must be a normalized virtualPath "${sourceRef}"`);
+  if (hasEditorTypeExtension(sourceRef)) {
+    throw new Error(`Source $ref must be an asset id, not a typed asset path: "${sourceRef}"${contextSuffix(context)}`);
   }
 }
-function resolveAssetIdToSourceRef(assetId, resolveAssetRef2, context) {
-  const sourceRef = resolveAssetRef2?.(assetId);
-  if (typeof sourceRef !== "string" || sourceRef.length === 0) {
-    throw new Error(
-      `[SceneV2] Unable to serialize asset ref "${assetId}"${contextSuffix(context)}: missing virtualPath`
-    );
-  }
-  assertCanonicalSourceRef(sourceRef, context);
+function assertAndReturnSourceAssetRef(sourceRef, context) {
+  assertSourceAssetRef(sourceRef, context);
   return sourceRef;
 }
-function resolveSourceRefToAssetId(sourceRef, resolveSourceRef2, context) {
-  assertCanonicalSourceRef(sourceRef, context);
-  const assetId = resolveSourceRef2?.(sourceRef);
-  if (typeof assetId !== "string" || assetId.length === 0) {
-    throw new Error(
-      `[SceneV2] Unable to resolve source asset ref "${sourceRef}"${contextSuffix(context)} to an editor asset id`
-    );
-  }
-  return assetId;
-}
-function createSourceRefCodec(options) {
+function createSourceRefCodec(options = {}) {
   return {
     domainToSource(assetId, context) {
-      return resolveAssetIdToSourceRef(assetId, options.resolveAssetRef, context);
+      return assertAndReturnSourceAssetRef(assetId, context);
     },
     sourceToDomain(sourceRef, context) {
-      return resolveSourceRefToAssetId(sourceRef, options.resolveSourceRef, context);
+      return assertAndReturnSourceAssetRef(sourceRef, context);
     },
     maybeResolveAssetKind(sourceRef) {
-      assertCanonicalSourceRef(sourceRef);
-      const assetId = options.resolveSourceRef?.(sourceRef);
-      if (typeof assetId !== "string" || assetId.length === 0)
-        return void 0;
-      return options.resolveAssetKind?.(sourceRef, assetId);
+      assertSourceAssetRef(sourceRef);
+      return options.resolveAssetKind?.(sourceRef);
     }
   };
 }
-var INTERNAL_ASSET_ID_REF_PATTERN, UUID_ASSET_ID_REF_PATTERN, URL_LIKE_SOURCE_REF_PATTERN, DOT_SEGMENT_SOURCE_REF_PATTERN;
+var URL_LIKE_SOURCE_REF_PATTERN, EDITOR_TYPE_EXTENSIONS;
 var init_source_ref_codec = __esm({
   "../model/src/scene-file-v2/source-ref-codec.ts"() {
     "use strict";
-    INTERNAL_ASSET_ID_REF_PATTERN = /^0{3,}[0-9A-Za-z_-]*$/;
-    UUID_ASSET_ID_REF_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+    init_asset_path();
     URL_LIKE_SOURCE_REF_PATTERN = /^[A-Za-z][A-Za-z0-9+.-]*:(?!:)/;
-    DOT_SEGMENT_SOURCE_REF_PATTERN = /(?:^|\/)\.\.?(?:\/|$)/;
+    EDITOR_TYPE_EXTENSIONS = Object.values(TYPE_EXTENSION).filter((extension) => Boolean(extension)).map((extension) => extension.toLowerCase());
   }
 });
 
@@ -39086,28 +39065,28 @@ function cloneSourceValue(value) {
   }
   return result2;
 }
-function convertSignalListenerAssetArgs(value, resolveSourceRef2) {
+function convertSignalListenerAssetArgs(value) {
   if (value === null || typeof value !== "object" || Array.isArray(value)) {
     return cloneSourceValue(value);
   }
   const record2 = value;
   const result2 = {};
   for (const [key2, child] of Object.entries(record2)) {
-    result2[key2] = key2 === "args" && Array.isArray(child) ? child.map((item) => convertAssetRefsToDomainRefs(item, resolveSourceRef2)) : cloneSourceValue(child);
+    result2[key2] = key2 === "args" && Array.isArray(child) ? child.map((item) => convertAssetRefsToDomainRefs(item)) : cloneSourceValue(child);
   }
   return result2;
 }
-function resolveRequiredSourceRef(ref, resolveSourceRef2) {
-  return resolveSourceRefToAssetId(ref, resolveSourceRef2);
+function resolveRequiredSourceRef(ref) {
+  return assertAndReturnSourceAssetRef(ref);
 }
-function convertAssetRefsToDomainRefs(obj, resolveSourceRef2) {
+function convertAssetRefsToDomainRefs(obj) {
   if (obj === null || obj === void 0 || typeof obj !== "object")
     return obj;
   if (Array.isArray(obj))
-    return obj.map((value) => convertAssetRefsToDomainRefs(value, resolveSourceRef2));
+    return obj.map((value) => convertAssetRefsToDomainRefs(value));
   const record2 = obj;
   if ("$ref" in record2 && typeof record2.$ref === "string") {
-    const refId = resolveRequiredSourceRef(record2.$ref, resolveSourceRef2);
+    const refId = resolveRequiredSourceRef(record2.$ref);
     const result3 = { refId };
     if (record2.key !== void 0)
       result3.key = record2.key;
@@ -39119,7 +39098,7 @@ function convertAssetRefsToDomainRefs(obj, resolveSourceRef2) {
   if ("$signal" in record2) {
     return {
       ...cloneSourceValue(record2),
-      $signal: Array.isArray(record2.$signal) ? record2.$signal.map((item) => convertSignalListenerAssetArgs(item, resolveSourceRef2)) : cloneSourceValue(record2.$signal)
+      $signal: Array.isArray(record2.$signal) ? record2.$signal.map((item) => convertSignalListenerAssetArgs(item)) : cloneSourceValue(record2.$signal)
     };
   }
   if ("$type" in record2) {
@@ -39127,13 +39106,13 @@ function convertAssetRefsToDomainRefs(obj, resolveSourceRef2) {
     for (const [key2, value] of Object.entries(record2)) {
       if (key2 === "$type")
         continue;
-      result3[key2] = convertAssetRefsToDomainRefs(value, resolveSourceRef2);
+      result3[key2] = convertAssetRefsToDomainRefs(value);
     }
     return result3;
   }
   const result2 = {};
   for (const [key2, value] of Object.entries(record2)) {
-    result2[key2] = convertAssetRefsToDomainRefs(value, resolveSourceRef2);
+    result2[key2] = convertAssetRefsToDomainRefs(value);
   }
   return result2;
 }
@@ -39144,7 +39123,9 @@ function isSourceId(value) {
   return typeof value === "string" && value.length > 0;
 }
 function resolveInternalAssetRef(ref, options) {
-  return resolveAssetIdToSourceRef(ref, options.resolveAssetRef, options.context);
+  const assetId = assertAndReturnSourceAssetRef(ref, options.context);
+  options.validateAssetRef?.(assetId, options.context);
+  return assetId;
 }
 function getSourceSentinelKeys(record2) {
   return SOURCE_SENTINEL_KEYS.filter((key2) => key2 in record2);
@@ -39199,7 +39180,7 @@ function normalizeSourceAssetRefRecord(record2) {
   if (record2.$ref.length === 0) {
     throw new Error("Source sentinel $ref must not be empty");
   }
-  assertCanonicalSourceRef(record2.$ref);
+  assertSourceAssetRef(record2.$ref);
   const result2 = { $ref: record2.$ref };
   if (record2.key !== void 0) {
     if (typeof record2.key !== "string") {
@@ -39335,8 +39316,9 @@ function normalizeDomainValueRecord(record2, options = {}) {
   }
   return result2;
 }
-function convertInternalRefsToSourceValue(value, resolveAssetRef2, context) {
-  return normalizeInternalSourceValue(value, { resolveAssetRef: resolveAssetRef2, context }) ?? null;
+function convertInternalRefsToSourceValue(value, contextOrOptions) {
+  const options = typeof contextOrOptions === "string" ? { context: contextOrOptions } : contextOrOptions ?? {};
+  return normalizeInternalSourceValue(value, options) ?? null;
 }
 var SOURCE_SENTINEL_KEYS;
 var init_source_value = __esm({
@@ -40128,7 +40110,7 @@ function assertNoExtraKeys(record2, allowedKeys, label) {
     }
   }
 }
-function sourceAssetRefToEditorRef(value, resolveAssetId) {
+function sourceAssetRefToEditorRef(value) {
   if (value === null || value === void 0)
     return value;
   if (!isPlainObject2(value) || typeof value.$ref !== "string") {
@@ -40138,16 +40120,13 @@ function sourceAssetRefToEditorRef(value, resolveAssetId) {
   if (value.key !== void 0 && typeof value.key !== "string") {
     throw new Error("Source scene setting asset ref key must be a string");
   }
-  const refId = resolveAssetId(value.$ref);
-  if (typeof refId !== "string" || refId.length === 0) {
-    throw new Error(`[SceneV2] Unable to resolve scene setting asset ref "${value.$ref}" to an editor asset id`);
-  }
+  assertSourceAssetRef(value.$ref, " in scene setting");
   return {
-    refId,
+    refId: value.$ref,
     ...typeof value.key === "string" ? { key: value.key } : {}
   };
 }
-function editorAssetRefToSourceRef(value, resolveVirtualPath) {
+function editorAssetRefToSourceRef(value) {
   if (value === null || value === void 0)
     return value;
   if (!isPlainObject2(value) || typeof value.refId !== "string") {
@@ -40157,15 +40136,19 @@ function editorAssetRefToSourceRef(value, resolveVirtualPath) {
   if (value.key !== void 0 && typeof value.key !== "string") {
     throw new Error("Editor scene setting asset ref key must be a string");
   }
-  const sourceRef = resolveVirtualPath(value.refId);
-  if (typeof sourceRef !== "string" || sourceRef.length === 0) {
-    throw new Error(`[SceneV2] Unable to serialize scene setting asset ref "${value.refId}": missing virtualPath`);
-  }
+  assertSourceAssetRef(value.refId, " in scene setting");
   return {
-    $ref: sourceRef,
+    $ref: value.refId,
     ...typeof value.key === "string" ? { key: value.key } : {}
   };
 }
+function editorAssetRefToSourceRefWithValidation(value, validateAssetRef) {
+  const result2 = editorAssetRefToSourceRef(value);
+  if (isPlainObject2(result2) && typeof result2.$ref === "string") {
+    validateAssetRef?.(result2.$ref, " in scene setting");
+  }
+  return result2;
+}
 function mapSceneSettingAssetRefs(settings, convert) {
   const result2 = { ...settings };
   for (const [category, definitions] of Object.entries(SCENE_SETTING_DEFINITIONS)) {
@@ -40197,14 +40180,14 @@ function mapSceneSettingAssetRefs(settings, convert) {
   }
   return result2;
 }
-function sourceSceneSettingsToEditorSettings(settings, resolveAssetId) {
-  return mapSceneSettingAssetRefs(settings, (value) => sourceAssetRefToEditorRef(value, resolveAssetId));
+function sourceSceneSettingsToEditorSettings(settings) {
+  return mapSceneSettingAssetRefs(settings, (value) => sourceAssetRefToEditorRef(value));
 }
-function editorSceneSettingsToSourceSettings(settings, resolveVirtualPath) {
+function editorSceneSettingsToSourceSettings(settings, options = {}) {
   return mapSceneSettingAssetRefs(settings, (value, { category, property: property2 }) => {
     if (value === null && !sourceAssetRefSettingAllowsNull(category, property2))
       return void 0;
-    return editorAssetRefToSourceRef(value, resolveVirtualPath);
+    return editorAssetRefToSourceRefWithValidation(value, options.validateAssetRef);
   });
 }
 var init_sceneSettingRefs = __esm({
@@ -40212,6 +40195,7 @@ var init_sceneSettingRefs = __esm({
     "use strict";
     init_sceneSettingDefinitions();
     init_sceneSettingValueNormalization();
+    init_source_ref_codec();
   }
 });
 
@@ -40430,7 +40414,7 @@ function assertSourceCallResult(value, kind, path23) {
   assertSourceValueRecord(value.props, kind, `${path23}.props`);
   assertSourceCalls(value.calls, kind, `${path23}.calls`);
 }
-function assertSourceAssetRef(value, kind, path23) {
+function assertSourceAssetRef2(value, kind, path23) {
   if (!isRecord(value)) {
     throw new Error(`Invalid source v2 ${kind} file: ${path23} must be a v2 $ref object`);
   }
@@ -40502,7 +40486,7 @@ function assertSourceComponentSchema(component2, kind, path23) {
     throw new Error(`Invalid source v2 ${kind} file: ${path23}.type must be a non-empty string`);
   }
   if (component2.script !== void 0)
-    assertSourceAssetRef(component2.script, kind, `${path23}.script`);
+    assertSourceAssetRef2(component2.script, kind, `${path23}.script`);
   assertSourceValueRecord(component2.props, kind, `${path23}.props`);
   assertCanonicalPostProcessProps(
     component2.type,
@@ -40522,7 +40506,7 @@ function assertInlineComponentSchema(component2, kind, path23) {
     throw new Error(`Invalid source v2 ${kind} file: ${path23}.type must be a non-empty string`);
   }
   if (component2.script !== void 0)
-    assertSourceAssetRef(component2.script, kind, `${path23}.script`);
+    assertSourceAssetRef2(component2.script, kind, `${path23}.script`);
   assertSourceValueRecord(component2.props, kind, `${path23}.props`);
   assertCanonicalPostProcessProps(
     component2.type,
@@ -40558,7 +40542,7 @@ function assertInlineEntitySchema(entity, kind, path23) {
       throw new Error(`Invalid source v2 ${kind} file: ${path23}.instance must be an object`);
     }
     assertAllowedObjectKeys(entity.instance, SOURCE_V2_INSTANCE_KEYS, kind, `${path23}.instance`);
-    assertSourceAssetRef(entity.instance.asset, kind, `${path23}.instance.asset`);
+    assertSourceAssetRef2(entity.instance.asset, kind, `${path23}.instance.asset`);
     assertInstanceOverrides(entity.instance.overrides, kind, `${path23}.instance.overrides`);
     return;
   }
@@ -40679,7 +40663,7 @@ function assertSourceV2EntityArray(entities, kind) {
         throw new Error(`Invalid source v2 ${kind} file: entities[${entityIndex}].instance must be an object`);
       }
       assertAllowedObjectKeys(entity.instance, SOURCE_V2_INSTANCE_KEYS, kind, `entities[${entityIndex}].instance`);
-      assertSourceAssetRef(entity.instance.asset, kind, `entities[${entityIndex}].instance.asset`);
+      assertSourceAssetRef2(entity.instance.asset, kind, `entities[${entityIndex}].instance.asset`);
       assertInstanceOverrides(entity.instance.overrides, kind, `entities[${entityIndex}].instance.overrides`);
       const leakedBoundaryFields = ["children", "components"].filter((key2) => entity[key2] !== void 0);
       if (leakedBoundaryFields.length > 0) {
@@ -40797,7 +40781,7 @@ function assertOptionalSourceAssetRef(value, kind, path23, options = {}) {
     return;
   if (value === null && options.allowNull)
     return;
-  assertSourceAssetRef(value, kind, path23);
+  assertSourceAssetRef2(value, kind, path23);
 }
 function assertOptionalNumber(value, kind, path23) {
   if (value === void 0)
@@ -41154,14 +41138,18 @@ var init_source_validator = __esm({
 });
 
 // ../model/src/scene-file-v2/prefab-overrides.ts
-function vec3TupleFromPartial(value, defaults2) {
+function vec3TupleFromPartial(value, source, field) {
   if (!isRecord(value))
     return void 0;
-  return [
-    typeof value.x === "number" ? value.x : defaults2[0],
-    typeof value.y === "number" ? value.y : defaults2[1],
-    typeof value.z === "number" ? value.z : defaults2[2]
-  ];
+  const resolveAxis = (axis) => {
+    const axisValue = value[axis];
+    if (typeof axisValue === "number")
+      return axisValue;
+    if (source)
+      return source[axis];
+    throw new Error(`Cannot serialize partial prefab ${field} override without source snapshot transform`);
+  };
+  return [resolveAxis("x"), resolveAxis("y"), resolveAxis("z")];
 }
 function cloneSourceTuple(value) {
   if (!Array.isArray(value) || value.length < 3)
@@ -41169,8 +41157,8 @@ function cloneSourceTuple(value) {
   const tuple2 = [Number(value[0]), Number(value[1]), Number(value[2])];
   return tuple2.every(Number.isFinite) ? tuple2 : void 0;
 }
-function entityOverridePropsToSource(props, resolveRef3) {
-  const normalized = convertInternalRefsToSourceValue(props, resolveRef3);
+function entityOverridePropsToSource(props, options = {}, sourceTransform) {
+  const normalized = convertInternalRefsToSourceValue(props, options);
   const result2 = {};
   if (typeof normalized.name === "string")
     result2.name = normalized.name;
@@ -41190,9 +41178,9 @@ function entityOverridePropsToSource(props, resolveRef3) {
   if (scale2)
     result2.scale = scale2;
   if (isRecord(normalized.transform)) {
-    const transformPosition = vec3TupleFromPartial(normalized.transform.position, [0, 0, 0]);
-    const transformRotation = vec3TupleFromPartial(normalized.transform.rotation, [0, 0, 0]);
-    const transformScale = vec3TupleFromPartial(normalized.transform.scale, [1, 1, 1]);
+    const transformPosition = vec3TupleFromPartial(normalized.transform.position, sourceTransform?.position, "position");
+    const transformRotation = vec3TupleFromPartial(normalized.transform.rotation, sourceTransform?.rotation, "rotation");
+    const transformScale = vec3TupleFromPartial(normalized.transform.scale, sourceTransform?.scale, "scale");
     if (transformPosition)
       result2.position = transformPosition;
     if (transformRotation)
@@ -41327,13 +41315,15 @@ function normalizePrefabRootInstanceOverrides(rootEntity, rootSourceEntityId) {
 function prefabBindingToV2Overrides(state, binding, resolveRef3) {
   if (!binding)
     return void 0;
+  const refOptions = createInternalAssetRefSerializeOptions(resolveRef3);
   const overrides = {};
   let hasData = false;
   const entityProps = [];
   for (const [sourceEntityId, props] of Object.entries(binding.overrides.entityProps ?? {})) {
+    const sourceSnapshot = binding.sourceEntitySnapshots?.[sourceEntityId];
     entityProps.push({
       target: sourceEntityId,
-      ...entityOverridePropsToSource(props, resolveRef3)
+      ...entityOverridePropsToSource(props, refOptions, sourceSnapshot?.transform)
     });
   }
   if (entityProps.length) {
@@ -41347,7 +41337,7 @@ function prefabBindingToV2Overrides(state, binding, resolveRef3) {
         continue;
       componentProps.push({
         target: sourceComponentKey,
-        props: convertInternalRefsToSourceValue(props, resolveRef3)
+        props: convertInternalRefsToSourceValue(props, refOptions)
       });
     }
   }
@@ -41413,7 +41403,6 @@ function prefabBindingsToV2OverridesForEntity(state, binding, resolveRef3) {
 }
 function parseSceneFileV2(sceneFile, entities, rootEntityIds, options = {}) {
   assertSourceV2SceneFileStructure(sceneFile);
-  const resolveSourceRef2 = options.resolveSourceRef;
   const v2Entities = sceneFile.entities;
   const v2Components = sceneFile.components;
   const sourceIndex = buildSourceIdIndex(sceneFile);
@@ -41443,12 +41432,12 @@ function parseSceneFileV2(sceneFile, entities, rootEntityIds, options = {}) {
       if (!sourceComponent) {
         throw new Error(`Invalid source v2 scene file: component "${componentId}" must exist`);
       }
-      components[componentId] = sourceComponentToComponentState(sourceComponent, resolveSourceRef2);
+      components[componentId] = sourceComponentToComponentState(sourceComponent);
     }
     const parentId = parentById.get(entityId);
     const instanceAssetRef = sourceEntity.instance?.asset?.$ref;
-    const instanceAssetId = instanceAssetRef ? resolveRequiredSourceRef(instanceAssetRef, resolveSourceRef2) : null;
-    const instanceAssetKind = instanceAssetRef && instanceAssetId ? options.resolveAssetKind?.(instanceAssetRef, instanceAssetId) : void 0;
+    const instanceAssetId = instanceAssetRef ? resolveRequiredSourceRef(instanceAssetRef) : null;
+    const instanceAssetKind = instanceAssetId ? options.resolveAssetKind?.(instanceAssetId) : void 0;
     const initialBinding = instanceAssetId ? findPrefabBindingForSourceEntity(options.initialPrefabState, entityId, {
       assetId: instanceAssetId,
       assetKind: instanceAssetKind
@@ -41493,13 +41482,7 @@ function parseSceneFileV2(sceneFile, entities, rootEntityIds, options = {}) {
     entities[entityId] = entityState;
   }
   if (!options.deferPrefabInlineOverrideMaterialization) {
-    materializeAddedOverridesFromSource(
-      sceneFile,
-      entities,
-      resolveSourceRef2,
-      options.resolveAssetKind,
-      options.initialPrefabState
-    );
+    materializeAddedOverridesFromSource(sceneFile, entities, options.resolveAssetKind, options.initialPrefabState);
   }
 }
 function assertInstanceOverridesDoNotRequireBinding(sourceEntity, sourceEntityId, rootOverrideTarget) {
@@ -41514,14 +41497,14 @@ function assertInstanceOverridesDoNotRequireBinding(sourceEntity, sourceEntityId
     `Cannot parse source v2 instance entity "${sourceEntityId}" with sidecar-owned overrides without prefab binding state. Use hydrateSourceV2SceneToDomain, pass initialPrefabState, or defer prefab inline override materialization.`
   );
 }
-function sourceComponentToComponentState(component2, resolveSourceRef2) {
+function sourceComponentToComponentState(component2) {
   assertCanonicalPostProcessProps(component2.type, component2.props, `source component ${component2.type}.props`);
   return {
     type: component2.type,
-    ...component2.script?.$ref ? { refId: resolveRequiredSourceRef(component2.script.$ref, resolveSourceRef2) } : {},
+    ...component2.script?.$ref ? { refId: resolveRequiredSourceRef(component2.script.$ref) } : {},
     ...component2.script?.key ? { scriptKey: component2.script.key } : {},
-    props: convertAssetRefsToDomainRefs(component2.props ?? {}, resolveSourceRef2),
-    ...component2.calls?.length ? { calls: convertAssetRefsToDomainRefs(component2.calls, resolveSourceRef2) } : {}
+    props: convertAssetRefsToDomainRefs(component2.props ?? {}),
+    ...component2.calls?.length ? { calls: convertAssetRefsToDomainRefs(component2.calls) } : {}
   };
 }
 function tupleToTransform(entity) {
@@ -41640,11 +41623,11 @@ function canMergeMaterializedNestedInstanceRoot(existing, sidecarBinding, instan
     return false;
   return sidecarBinding.instanceRootEntityId === existing.id;
 }
-function materializeInlineAddedEntity(entities, binding, entityId, parentId, inlineEntity, prefabBindings, resolveSourceRef2, resolveAssetKind3, report, siblingIndex) {
+function materializeInlineAddedEntity(entities, binding, entityId, parentId, inlineEntity, prefabBindings, resolveAssetKind3, report, siblingIndex) {
   const instanceAssetRef = inlineEntity.instance?.asset?.$ref;
   if (instanceAssetRef) {
-    const instanceAssetId = resolveRequiredSourceRef(instanceAssetRef, resolveSourceRef2);
-    const instanceAssetKind = resolveAssetKind3?.(instanceAssetRef, instanceAssetId);
+    const instanceAssetId = resolveRequiredSourceRef(instanceAssetRef);
+    const instanceAssetKind = resolveAssetKind3?.(instanceAssetId);
     const sidecarBinding = findPrefabBindingForSourceEntity(prefabBindings, entityId, {
       assetId: instanceAssetId,
       assetKind: instanceAssetKind
@@ -41690,7 +41673,6 @@ function materializeInlineAddedEntity(entities, binding, entityId, parentId, inl
           sidecarBinding,
           entities,
           prefabBindings,
-          resolveSourceRef2,
           resolveAssetKind3,
           report
         );
@@ -41707,7 +41689,6 @@ function materializeInlineAddedEntity(entities, binding, entityId, parentId, inl
         sidecarBinding,
         entities,
         prefabBindings,
-        resolveSourceRef2,
         resolveAssetKind3,
         report
       );
@@ -41719,7 +41700,7 @@ function materializeInlineAddedEntity(entities, binding, entityId, parentId, inl
   componentEntries.forEach((component2, index2) => {
     const componentId = `${entityId}:component-${index2}`;
     components[componentId] = {
-      ...sourceComponentToComponentState(component2, resolveSourceRef2),
+      ...sourceComponentToComponentState(component2),
       instance: { bindingId: binding.id, role: "added" }
     };
   });
@@ -41754,14 +41735,13 @@ function materializeInlineAddedEntity(entities, binding, entityId, parentId, inl
       entityId,
       child,
       prefabBindings,
-      resolveSourceRef2,
       resolveAssetKind3,
       report,
       index2
     );
   });
 }
-function materializeAddedOverridesForBinding(overrides, binding, entities, prefabBindings, resolveSourceRef2, resolveAssetKind3, report) {
+function materializeAddedOverridesForBinding(overrides, binding, entities, prefabBindings, resolveAssetKind3, report) {
   const addedEntityBuckets = /* @__PURE__ */ new Map();
   for (const added of Object.values(binding.overrides.addedEntities ?? {})) {
     const bucket = addedEntityBuckets.get(added.parentSourceEntityId) ?? [];
@@ -41788,7 +41768,6 @@ function materializeAddedOverridesForBinding(overrides, binding, entities, prefa
       parentSceneEntityId,
       override3.entity,
       prefabBindings,
-      resolveSourceRef2,
       resolveAssetKind3,
       report,
       added.index
@@ -41798,7 +41777,7 @@ function materializeAddedOverridesForBinding(overrides, binding, entities, prefa
   overrides.addedComponents?.forEach((override3) => {
     const ownerSourceEntityId = override3.owner;
     const candidates = Object.values(binding.overrides.addedComponents?.[ownerSourceEntityId] ?? {});
-    const component2 = sourceComponentToComponentState(override3.component, resolveSourceRef2);
+    const component2 = sourceComponentToComponentState(override3.component);
     const inlineAdded = selectAddedComponentSidecarEntry(
       candidates,
       consumedAddedComponents,
@@ -41822,15 +41801,15 @@ function materializeAddedOverridesForBinding(overrides, binding, entities, prefa
     recordMaterializedAddedComponent(report, binding.id, added.ownerSourceEntityId, added.componentId);
   });
 }
-function materializeAddedOverridesFromSource(sceneFile, entities, resolveSourceRef2, resolveAssetKind3, prefabBindings, report) {
+function materializeAddedOverridesFromSource(sceneFile, entities, resolveAssetKind3, prefabBindings, report) {
   sceneFile.entities.forEach((sourceEntity) => {
     const overrides = sourceEntity.instance?.overrides;
     if (!overrides)
       return;
     const rootEntityId = sourceEntity.id;
     const instanceAssetRef = sourceEntity.instance?.asset?.$ref;
-    const instanceAssetId = instanceAssetRef ? resolveRequiredSourceRef(instanceAssetRef, resolveSourceRef2) : void 0;
-    const instanceAssetKind = instanceAssetRef && instanceAssetId ? resolveAssetKind3?.(instanceAssetRef, instanceAssetId) : void 0;
+    const instanceAssetId = instanceAssetRef ? resolveRequiredSourceRef(instanceAssetRef) : void 0;
+    const instanceAssetKind = instanceAssetId ? resolveAssetKind3?.(instanceAssetId) : void 0;
     const binding = rootEntityId ? findPrefabBindingForSourceEntity(prefabBindings, rootEntityId, {
       assetId: instanceAssetId,
       assetKind: instanceAssetKind
@@ -41843,15 +41822,7 @@ function materializeAddedOverridesFromSource(sceneFile, entities, resolveSourceR
       }
       return;
     }
-    materializeAddedOverridesForBinding(
-      overrides,
-      binding,
-      entities,
-      prefabBindings,
-      resolveSourceRef2,
-      resolveAssetKind3,
-      report
-    );
+    materializeAddedOverridesForBinding(overrides, binding, entities, prefabBindings, resolveAssetKind3, report);
   });
 }
 function hasNonEmptyArray(value) {
@@ -41885,41 +41856,35 @@ function findBindingForSerializableInstance(state, entity) {
   }
   return findPrefabBindingForSourceEntity(state.prefab, entity.id, expected) ?? void 0;
 }
-function domainStateToSceneFileV2(state, optionsOrResolveAssetRef = {}) {
-  const resolveRef3 = createAssetRefResolver(optionsOrResolveAssetRef);
-  let sceneSettings;
-  if (state.scene.settings) {
-    try {
-      sceneSettings = editorSceneSettingsToSourceSettings(
-        state.scene.settings,
-        resolveRef3
-      );
-    } catch (err2) {
-      if (err2 instanceof SceneV2DanglingAssetRefError) {
-        console.warn(`[SceneV2] scene settings dangling ref, settings \u6574\u4F53\u8DF3\u8FC7: ${err2.message}`);
-        sceneSettings = void 0;
-      } else {
-        throw err2;
-      }
+function createSerializeAssetRefResolver(options) {
+  return (assetId) => {
+    const sourceRef = assertAndReturnSourceAssetRef(assetId);
+    if (options.assetExists && !options.assetExists(sourceRef)) {
+      throw new SceneV2DanglingAssetRefError(sourceRef);
     }
-  }
+    return sourceRef;
+  };
+}
+function createInternalAssetRefSerializeOptions(resolveRef3) {
+  return {
+    validateAssetRef: (assetId) => {
+      resolveRef3(assetId);
+    }
+  };
+}
+function domainStateToSceneFileV2(state, _options = {}) {
+  const resolveRef3 = createSerializeAssetRefResolver(_options);
+  const refOptions = createInternalAssetRefSerializeOptions(resolveRef3);
+  const sceneSettings = state.scene.settings ? editorSceneSettingsToSourceSettings(state.scene.settings, refOptions) : void 0;
   const ordered = orderSceneEntities(state);
   const components = [];
   const candidateEntityIds = ordered.map((entity) => entity.id);
   const entities = ordered.map((entity) => {
     const entityComponentsBuffer = [];
-    try {
-      const result3 = serializeOneEntity(entity, entityComponentsBuffer, candidateEntityIds);
-      components.push(...entityComponentsBuffer);
-      return result3;
-    } catch (err2) {
-      if (err2 instanceof SceneV2DanglingAssetRefError) {
-        console.warn(`[SceneV2] skip entity "${entity.id}" (name="${entity.name}") from save: ${err2.message}`);
-        return null;
-      }
-      throw err2;
-    }
-  }).filter((e6) => e6 !== null);
+    const result3 = serializeOneEntity(entity, entityComponentsBuffer, candidateEntityIds);
+    components.push(...entityComponentsBuffer);
+    return result3;
+  });
   const validEntityIds = new Set(entities.map((e6) => e6.id));
   for (const entity of entities) {
     if (!entity.children)
@@ -42010,13 +41975,11 @@ function domainStateToSceneFileV2(state, optionsOrResolveAssetRef = {}) {
 }
 function buildSourceSceneFile(root3, currentAssetId) {
   return domainStateToSceneFileV2(root3.domainStore.state, {
-    resolveAssetRef: (assetId) => root3.assetStore?.getAssetVirtualPath?.(assetId),
     currentAssetId
   });
 }
-function domainStateToPrefabFileV2(state, rootEntityId, optionsOrResolveAssetRef = {}) {
-  const currentAssetId = typeof optionsOrResolveAssetRef === "function" ? void 0 : optionsOrResolveAssetRef.currentAssetId;
-  const resolveRef3 = createAssetRefResolver(optionsOrResolveAssetRef);
+function domainStateToPrefabFileV2(state, rootEntityId, options = {}) {
+  const currentAssetId = options.currentAssetId;
   const selectedEntityIds = collectPrefabEntityIds(state, rootEntityId, currentAssetId);
   const selectedEntityIdSet = new Set(selectedEntityIds);
   collectPrefabInlineOverrideEntityIds(state, selectedEntityIdSet);
@@ -42048,7 +42011,7 @@ function domainStateToPrefabFileV2(state, rootEntityId, optionsOrResolveAssetRef
       entities,
       prefab: state.prefab
     },
-    optionsOrResolveAssetRef
+    options
   );
   const root3 = sceneFile.scene.rootEntities[0];
   if (root3 === void 0) {
@@ -42086,16 +42049,6 @@ function collectPrefabInlineOverrideEntityIds(state, selectedEntityIdSet) {
     }
   }
 }
-function createAssetRefResolver(optionsOrResolveAssetRef) {
-  const resolveAssetRef2 = typeof optionsOrResolveAssetRef === "function" ? optionsOrResolveAssetRef : optionsOrResolveAssetRef.resolveAssetRef;
-  return (assetId) => {
-    const sourceRef = resolveAssetRef2?.(assetId);
-    if (typeof sourceRef !== "string" || sourceRef.length === 0) {
-      throw new SceneV2DanglingAssetRefError(assetId);
-    }
-    return sourceRef;
-  };
-}
 function entityStateToInlineEntity(state, entityId, resolveRef3) {
   const entity = state.entities[entityId];
   if (!entity)
@@ -42176,7 +42129,8 @@ function collectPrefabEntityIds(state, rootEntityId, currentAssetId) {
   return ordered;
 }
 function componentStateToSourceComponent(componentId, component2, resolveRef3) {
-  const props = convertInternalRefsToSourceValue(component2.props ?? {}, resolveRef3);
+  const refOptions = createInternalAssetRefSerializeOptions(resolveRef3);
+  const props = convertInternalRefsToSourceValue(component2.props ?? {}, refOptions);
   assertCanonicalPostProcessProps(component2.type, props, `domain component ${component2.type}.props`);
   return {
     id: componentId,
@@ -42188,7 +42142,7 @@ function componentStateToSourceComponent(componentId, component2, resolveRef3) {
       }
     } : {},
     props,
-    ...component2.calls?.length ? { calls: convertInternalRefsToSourceValue(component2.calls, resolveRef3) } : {}
+    ...component2.calls?.length ? { calls: convertInternalRefsToSourceValue(component2.calls, refOptions) } : {}
   };
 }
 function isMaterializedInstanceLinkedEntity(state, entity) {
@@ -42242,12 +42196,13 @@ var init_domain_codec = __esm({
     init_source_validator();
     init_source_id_index();
     init_source_value();
+    init_source_ref_codec();
     init_prefab_overrides();
     init_prefab_override_utils();
     SCENE_V2_DANGLING_REF_SENTINEL = Symbol("SceneV2DanglingAssetRef");
     SceneV2DanglingAssetRefError = class extends Error {
       constructor(assetId) {
-        super(`[SceneV2] dangling asset ref "${assetId}" \u2014 entity/binding skipped from save`);
+        super(`[SceneV2] dangling asset ref "${assetId}"`);
         this.assetId = assetId;
         this.name = "SceneV2DanglingAssetRefError";
       }
@@ -42546,14 +42501,14 @@ var init_prefab_source_structural_edit = __esm({
 });
 
 // ../model/src/scene-file-v2/scene-settings.ts
-function extractSceneSettings(scene, options = {}) {
+function extractSceneSettings(scene) {
   if (!scene || typeof scene !== "object")
     return void 0;
   const settings = { ...scene };
   delete settings.rootEntities;
   if (Object.keys(settings).length === 0)
     return void 0;
-  return convertAssetRefsToDomainRefs(settings, options.resolveSourceRef);
+  return convertAssetRefsToDomainRefs(settings);
 }
 var init_scene_settings = __esm({
   "../model/src/scene-file-v2/scene-settings.ts"() {
@@ -44597,7 +44552,7 @@ function createResolveInstanceAssetKind(options) {
     return options.resolveInstanceAssetKind;
   if (!options.resolveAssetKind)
     return void 0;
-  return (sourceRef) => options.resolveAssetKind?.(sourceRef, options.resolveSourceRef?.(sourceRef) ?? sourceRef);
+  return (sourceRef) => options.resolveAssetKind?.(sourceRef);
 }
 var init_compile_scene_like_blob_to_runtime = __esm({
   "../builder/utils/compile-scene-like-blob-to-runtime.ts"() {
@@ -44695,27 +44650,15 @@ function resolveBuildAssetRef(context, ref) {
   const byId = requireBuildPath(context.fileMap.get(ref), ref);
   if (byId)
     return byId;
-  const byPath = resolveBuildPathByVirtualPath(context, ref);
-  if (byPath)
-    return byPath;
   throw new Error(`Unable to resolve source asset ref "${ref}" to a build path`);
 }
 function resolveBuildSourceAssetRef(context, ref) {
-  assertCanonicalSourceRef(ref);
-  const byPath = resolveBuildPathByVirtualPath(context, ref);
-  if (byPath)
-    return byPath;
+  assertSourceAssetRef(ref);
+  const byId = requireBuildPath(context.fileMap.get(ref), ref);
+  if (byId)
+    return byId;
   throw new Error(`Unable to resolve source asset ref "${ref}" to a build path`);
 }
-function resolveBuildPathByVirtualPath(context, ref) {
-  const pathCandidates = [`/${ref}`, ref];
-  for (const path23 of pathCandidates) {
-    const byPath = requireBuildPath(context.getFileByPath(path23), ref);
-    if (byPath)
-      return byPath;
-  }
-  return void 0;
-}
 var init_build_asset_ref_resolver = __esm({
   "../builder/utils/build-asset-ref-resolver.ts"() {
     "use strict";
@@ -44725,21 +44668,9 @@ var init_build_asset_ref_resolver = __esm({
 });
 
 // ../builder/utils/resolve-source-file.ts
-function lookupByPath(vfs, path23) {
-  if (vfs.getFileByPath)
-    return vfs.getFileByPath(path23);
-  return vfs.filePathMap?.get(path23);
-}
 function resolveSourceFileByVirtualPath(vfs, value) {
-  assertCanonicalSourceRef(value);
-  return lookupSourceFileByVirtualPath(vfs, value);
-}
-function lookupSourceFileByVirtualPath(vfs, value) {
-  const normalized = value.startsWith("/") ? value : `/${value}`;
-  return lookupByPath(vfs, normalized);
-}
-function resolveSourceRef(vfs, value) {
-  return resolveSourceFileByVirtualPath(vfs, value)?.id ?? value;
+  assertSourceAssetRef(value);
+  return vfs.fileMap.get(value);
 }
 function resolveAssetKind(vfs, value) {
   const type = String(resolveSourceFileByVirtualPath(vfs, value)?.meta?.type ?? "");
@@ -44846,7 +44777,7 @@ function importSourceRefs(obj, resolve5) {
   return convertRefs(obj, SOURCE_IMPORT_RULES, (value) => {
     const resolved = resolve5(value);
     if (resolved !== void 0)
-      assertCanonicalSourceRef(resolved, "source import");
+      assertSourceAssetRef(resolved, "source import");
     return resolved;
   });
 }
@@ -69139,7 +69070,7 @@ var require_main2 = __commonJS({
         array2.length--;
         return true;
       };
-      Utils4.decodeText = function decodeText2(array2) {
+      Utils4.decodeText = function decodeText3(array2) {
         if (typeof TextDecoder !== "undefined") {
           return new TextDecoder().decode(array2);
         }
@@ -123819,20 +123750,17 @@ function derivePrefabSourceSnapshotsFromFile(binding, prefabFile, options, compo
       components[sourceComponentKey] = {
         sceneComponentId,
         type: sourceComponent.type,
-        ...sourceComponent.script?.$ref ? { refId: resolveSourceAssetRef(sourceComponent.script.$ref, options, "script") } : {},
+        ...sourceComponent.script?.$ref ? { refId: resolveRequiredSourceRef(sourceComponent.script.$ref) } : {},
         ...sourceComponent.script?.key ? { scriptKey: sourceComponent.script.key } : {},
-        props: convertAssetRefsToDomainRefs(sourceComponent.props ?? {}, options.resolveSourceRef),
+        props: convertAssetRefsToDomainRefs(sourceComponent.props ?? {}),
         ...sourceComponent.calls?.length ? {
-          calls: convertAssetRefsToDomainRefs(
-            sourceComponent.calls,
-            options.resolveSourceRef
-          )
+          calls: convertAssetRefsToDomainRefs(sourceComponent.calls)
         } : {}
       };
     }
     const instanceRef = sourceEntity.instance?.asset?.$ref;
-    const assetId = instanceRef ? resolveSourceAssetRef(instanceRef, options, "nested instance") : void 0;
-    const instanceAssetKind = instanceRef && assetId ? resolveSourceAssetKind(instanceRef, assetId, options, "nested instance") : void 0;
+    const assetId = instanceRef ? resolveRequiredSourceRef(instanceRef) : void 0;
+    const instanceAssetKind = assetId ? resolveSourceAssetKind(assetId, options, "nested instance") : void 0;
     const rootOverrideTarget = resolveSourceInstanceRootOverrideTarget({
       sourceEntity,
       fallbackSourceEntityId: sourceEntityId,
@@ -123869,18 +123797,11 @@ function findExactPreviousSourceComponentSnapshot(previousSnapshot, sourceCompon
   const exact = previousSnapshot?.components?.[sourceComponentKey];
   return exact?.type === sourceComponent.type ? exact : void 0;
 }
-function resolveSourceAssetRef(ref, options, label) {
-  const assetId = options.resolveSourceRef?.(ref);
-  if (typeof assetId !== "string" || assetId.length === 0) {
-    throw new Error(`Unable to resolve source asset ref "${ref}" to an editor asset id while refreshing ${label}`);
-  }
-  return assetId;
-}
-function resolveSourceAssetKind(ref, assetId, options, label) {
-  const assetKind = options.resolveAssetKind?.(ref, assetId);
+function resolveSourceAssetKind(assetId, options, label) {
+  const assetKind = options.resolveAssetKind?.(assetId);
   if (assetKind !== "Prefab" && assetKind !== "glTF") {
     throw new Error(
-      `Unable to resolve supported source asset kind for "${ref}" while refreshing ${label}; expected Prefab or glTF`
+      `Unable to resolve supported source asset kind for "${assetId}" while refreshing ${label}; expected Prefab or glTF`
     );
   }
   return assetKind;
@@ -123986,7 +123907,7 @@ function requireInlineOverrideId(explicitId, inlineId, label) {
   }
   return id;
 }
-function seedPrefabOverridesFromInlineSource(overrides, prefabFile, resolveSourceRef2) {
+function seedPrefabOverridesFromInlineSource(overrides, prefabFile) {
   const next = createEmptyPrefabOverrides();
   if (!overrides)
     return next;
@@ -123998,7 +123919,7 @@ function seedPrefabOverridesFromInlineSource(overrides, prefabFile, resolveSourc
     if (!sourceIndex.entityById.has(override3.target)) {
       throw new Error(`Invalid source v2 scene file: entityProps override target "${override3.target}" does not exist`);
     }
-    next.entityProps[override3.target] = inlineEntityOverrideToDomainProps(override3, resolveSourceRef2);
+    next.entityProps[override3.target] = inlineEntityOverrideToDomainProps(override3);
   }
   for (const override3 of overrides.componentProps ?? []) {
     if (typeof override3.target !== "string") {
@@ -124011,7 +123932,7 @@ function seedPrefabOverridesFromInlineSource(overrides, prefabFile, resolveSourc
       );
     }
     const bucket = next.componentProps[ownerSourceEntityId] ??= {};
-    bucket[override3.target] = convertAssetRefsToDomainRefs(override3.props ?? {}, resolveSourceRef2);
+    bucket[override3.target] = convertAssetRefsToDomainRefs(override3.props ?? {});
   }
   for (const sourceEntityId of overrides.removedEntities ?? []) {
     if (!sourceIndex.entityById.has(sourceEntityId)) {
@@ -124056,11 +123977,11 @@ function seedPrefabOverridesFromInlineSource(overrides, prefabFile, resolveSourc
       ownerSourceEntityId: override3.owner,
       type: component2.type,
       ...component2.script?.$ref ? {
-        refId: resolveSourceRef2(component2.script.$ref),
+        refId: resolveRequiredSourceRef(component2.script.$ref),
         ...component2.script.key ? { scriptKey: component2.script.key } : {}
       } : {},
-      props: convertAssetRefsToDomainRefs(component2.props ?? {}, resolveSourceRef2),
-      ...component2.calls?.length ? { calls: convertAssetRefsToDomainRefs(component2.calls, resolveSourceRef2) } : {}
+      props: convertAssetRefsToDomainRefs(component2.props ?? {}),
+      ...component2.calls?.length ? { calls: convertAssetRefsToDomainRefs(component2.calls) } : {}
     };
   }
   return next;
@@ -124070,13 +123991,13 @@ function requireRootOnlyGLTFOverrideTarget(target, label) {
     return;
   throw new Error(`Invalid source v2 scene file: glTF ${label} target "${target}" is not the synthetic root`);
 }
-function seedRootOnlyGLTFOverridesFromInlineSource(overrides, resolveSourceRef2) {
+function seedRootOnlyGLTFOverridesFromInlineSource(overrides) {
   const next = createEmptyPrefabOverrides();
   if (!overrides)
     return next;
   for (const override3 of overrides.entityProps ?? []) {
     requireRootOnlyGLTFOverrideTarget(override3.target, "entityProps");
-    next.entityProps.root = inlineEntityOverrideToDomainProps(override3, resolveSourceRef2);
+    next.entityProps.root = inlineEntityOverrideToDomainProps(override3);
   }
   for (const sourceEntityId of overrides.removedEntities ?? []) {
     requireRootOnlyGLTFOverrideTarget(sourceEntityId, "removed entity");
@@ -124112,11 +124033,11 @@ function seedRootOnlyGLTFOverridesFromInlineSource(overrides, resolveSourceRef2)
       ownerSourceEntityId: "root",
       type: component2.type,
       ...component2.script?.$ref ? {
-        refId: resolveSourceRef2(component2.script.$ref),
+        refId: resolveRequiredSourceRef(component2.script.$ref),
         ...component2.script.key ? { scriptKey: component2.script.key } : {}
       } : {},
-      props: convertAssetRefsToDomainRefs(component2.props ?? {}, resolveSourceRef2),
-      ...component2.calls?.length ? { calls: convertAssetRefsToDomainRefs(component2.calls, resolveSourceRef2) } : {}
+      props: convertAssetRefsToDomainRefs(component2.props ?? {}),
+      ...component2.calls?.length ? { calls: convertAssetRefsToDomainRefs(component2.calls) } : {}
     };
   }
   return next;
@@ -124303,8 +124224,8 @@ function seedSourceSceneInstanceBindings(prefab, sceneFile, options) {
     const sourceRef = entity.instance?.asset?.$ref;
     if (!sourceRef)
       continue;
-    const assetId = resolveSourceAssetRef(sourceRef, options, "scene instance");
-    const assetKind = resolveSourceAssetKind(sourceRef, assetId, options, "scene instance");
+    const assetId = resolveRequiredSourceRef(sourceRef);
+    const assetKind = resolveSourceAssetKind(assetId, options, "scene instance");
     if (assetKind !== "Prefab" && assetKind !== "glTF")
       continue;
     if (findBindingForInstanceRoot(next, entity.id, { assetId, assetKind })) {
@@ -124326,11 +124247,7 @@ function seedSourceSceneInstanceBindings(prefab, sceneFile, options) {
       assertSourceV2PrefabFileStructure(prefabFile);
       const sourceRootEntityId = prefabFile.root;
       const bindingId = `binding-${assetId}-${entity.id}`;
-      const overrides = seedPrefabOverridesFromInlineSource(
-        entity.instance?.overrides,
-        prefabFile,
-        options.resolveSourceRef
-      );
+      const overrides = seedPrefabOverridesFromInlineSource(entity.instance?.overrides, prefabFile);
       binding = {
         id: bindingId,
         assetId,
@@ -124359,10 +124276,7 @@ function seedSourceSceneInstanceBindings(prefab, sceneFile, options) {
             sceneEntityId: entity.id
           })
         },
-        overrides: seedRootOnlyGLTFOverridesFromInlineSource(
-          entity.instance?.overrides,
-          options.resolveSourceRef
-        )
+        overrides: seedRootOnlyGLTFOverridesFromInlineSource(entity.instance?.overrides)
       };
     }
     next.bindings[binding.id] = binding;
@@ -124391,9 +124305,9 @@ function sourceVec3Override(value) {
   const [x3, y5, z3] = value;
   return typeof x3 === "number" && typeof y5 === "number" && typeof z3 === "number" ? { x: x3, y: y5, z: z3 } : void 0;
 }
-function inlineEntityOverrideToDomainProps(item, resolveSourceRef2) {
+function inlineEntityOverrideToDomainProps(item) {
   const { target, position, rotation, scale: scale2, ...rest2 } = item;
-  const props = convertAssetRefsToDomainRefs(rest2, resolveSourceRef2);
+  const props = convertAssetRefsToDomainRefs(rest2);
   const transform5 = {};
   const nextPosition = sourceVec3Override(position);
   const nextRotation = sourceVec3Override(rotation);
@@ -124441,8 +124355,8 @@ function prunePrefabBindingsToReachableSourceInstances(sceneFile, prefab, option
       const sourceRef = sourceEntity?.instance?.asset?.$ref;
       if (!sourceEntity || !sourceEntityId || !sourceRef)
         continue;
-      const assetId = resolveSourceAssetRef(sourceRef, options, "nested instance");
-      const assetKind = resolveSourceAssetKind(sourceRef, assetId, options, "nested instance");
+      const assetId = resolveRequiredSourceRef(sourceRef);
+      const assetKind = resolveSourceAssetKind(assetId, options, "nested instance");
       const sceneEntityId = getSceneEntityIdForSourceEntity(binding, sourceEntityId);
       if (!sceneEntityId)
         continue;
@@ -124456,8 +124370,8 @@ function prunePrefabBindingsToReachableSourceInstances(sceneFile, prefab, option
     const sourceRef = entity.instance?.asset?.$ref;
     if (!entityId || !sourceRef)
       return;
-    const assetId = resolveSourceAssetRef(sourceRef, options, "scene instance");
-    const assetKind = resolveSourceAssetKind(sourceRef, assetId, options, "scene instance");
+    const assetId = resolveRequiredSourceRef(sourceRef);
+    const assetKind = resolveSourceAssetKind(assetId, options, "scene instance");
     const binding = findBindingForInstanceRoot(prefab, entityId, { assetId, assetKind });
     if (binding)
       markReachableBinding(binding);
@@ -124494,8 +124408,8 @@ function collectMissingNestedSourceInstanceBindings(prefab, options) {
       const sourceRef = sourceEntity?.instance?.asset?.$ref;
       if (!sourceEntityId || !sourceRef || isRemovedSourceEntity(binding, sourceEntityId))
         continue;
-      const assetId = resolveSourceAssetRef(sourceRef, options, "nested instance");
-      const assetKind = resolveSourceAssetKind(sourceRef, assetId, options, "nested instance");
+      const assetId = resolveRequiredSourceRef(sourceRef);
+      const assetKind = resolveSourceAssetKind(assetId, options, "nested instance");
       const sceneEntityId = getSceneEntityIdForSourceEntity(binding, sourceEntityId);
       if (!sceneEntityId) {
         throw new Error(
@@ -124580,11 +124494,7 @@ function createSourceInstanceBindingFromInlineSource(input) {
       sourceRevision: 1,
       sourceToSceneEntity: { [sourceRootEntityId]: sceneEntityId },
       sourceEntitySnapshots: {},
-      overrides: seedPrefabOverridesFromInlineSource(
-        sourceEntity.instance?.overrides,
-        prefabFile,
-        options.resolveSourceRef
-      )
+      overrides: seedPrefabOverridesFromInlineSource(sourceEntity.instance?.overrides, prefabFile)
     };
   }
   return {
@@ -124602,10 +124512,7 @@ function createSourceInstanceBindingFromInlineSource(input) {
         sceneEntityId
       })
     },
-    overrides: seedRootOnlyGLTFOverridesFromInlineSource(
-      sourceEntity.instance?.overrides,
-      options.resolveSourceRef
-    )
+    overrides: seedRootOnlyGLTFOverridesFromInlineSource(sourceEntity.instance?.overrides)
   };
 }
 function seedInlineAddedSourceInstanceBindings(prefab, overrides, options) {
@@ -124618,8 +124525,8 @@ function seedInlineAddedSourceInstanceBindings(prefab, overrides, options) {
     if (!sourceRef)
       continue;
     const sceneEntityId = requireInlineOverrideId(override3.id, inlineEntity.id, "added entity override");
-    const assetId = resolveSourceAssetRef(sourceRef, options, "inline added instance");
-    const assetKind = resolveSourceAssetKind(sourceRef, assetId, options, "inline added instance");
+    const assetId = resolveRequiredSourceRef(sourceRef);
+    const assetKind = resolveSourceAssetKind(assetId, options, "inline added instance");
     if (findBindingForInstanceRoot(prefab, sceneEntityId, { assetId, assetKind }))
       continue;
     const binding = createSourceInstanceBindingFromInlineSource({
@@ -124648,8 +124555,8 @@ function hasMissingInlineAddedSourceInstanceBindings(prefab, overrides, options)
     if (!sourceRef)
       continue;
     const sceneEntityId = requireInlineOverrideId(override3.id, inlineEntity.id, "added entity override");
-    const assetId = resolveSourceAssetRef(sourceRef, options, "inline added instance");
-    const assetKind = resolveSourceAssetKind(sourceRef, assetId, options, "inline added instance");
+    const assetId = resolveRequiredSourceRef(sourceRef);
+    const assetKind = resolveSourceAssetKind(assetId, options, "inline added instance");
     if (!findBindingForInstanceRoot(prefab, sceneEntityId, { assetId, assetKind }))
       return true;
   }
@@ -124679,8 +124586,8 @@ function seedInlineAddedSourceInstanceBindingsForNestedSourceInstances(prefab, o
       const sceneEntityId = getSceneEntityIdForSourceEntity(binding, sourceEntityId);
       if (!sceneEntityId)
         continue;
-      const assetId = resolveSourceAssetRef(sourceRef, options, "nested instance");
-      const assetKind = resolveSourceAssetKind(sourceRef, assetId, options, "nested instance");
+      const assetId = resolveRequiredSourceRef(sourceRef);
+      const assetKind = resolveSourceAssetKind(assetId, options, "nested instance");
       if (!findBindingForInstanceRoot(prefab, sceneEntityId, { assetId, assetKind }))
         continue;
       if (seedInlineAddedSourceInstanceBindings(prefab, sourceEntity.instance.overrides, options))
@@ -124712,8 +124619,8 @@ function hasMissingInlineAddedSourceInstanceBindingsForNestedSourceInstances(pre
       const sceneEntityId = getSceneEntityIdForSourceEntity(binding, sourceEntityId);
       if (!sceneEntityId)
         continue;
-      const assetId = resolveSourceAssetRef(sourceRef, options, "nested instance");
-      const assetKind = resolveSourceAssetKind(sourceRef, assetId, options, "nested instance");
+      const assetId = resolveRequiredSourceRef(sourceRef);
+      const assetKind = resolveSourceAssetKind(assetId, options, "nested instance");
       if (!findBindingForInstanceRoot(prefab, sceneEntityId, { assetId, assetKind }))
         continue;
       if (hasMissingInlineAddedSourceInstanceBindings(prefab, sourceEntity.instance.overrides, options))
@@ -124758,11 +124665,7 @@ function seedNestedSourceInstanceBindings(prefab, options, ancestorAssetIdsByBin
         sourceRevision: 1,
         sourceToSceneEntity: { [sourceRootEntityId]: item.sceneEntityId },
         sourceEntitySnapshots: {},
-        overrides: seedPrefabOverridesFromInlineSource(
-          item.sourceEntity.instance?.overrides,
-          prefabFile,
-          options.resolveSourceRef
-        )
+        overrides: seedPrefabOverridesFromInlineSource(item.sourceEntity.instance?.overrides, prefabFile)
       };
     } else {
       binding = {
@@ -124780,10 +124683,7 @@ function seedNestedSourceInstanceBindings(prefab, options, ancestorAssetIdsByBin
             sceneEntityId: item.sceneEntityId
           })
         },
-        overrides: seedRootOnlyGLTFOverridesFromInlineSource(
-          item.sourceEntity.instance?.overrides,
-          options.resolveSourceRef
-        )
+        overrides: seedRootOnlyGLTFOverridesFromInlineSource(item.sourceEntity.instance?.overrides)
       };
     }
     next.bindings[binding.id] = binding;
@@ -125015,37 +124915,28 @@ function assertGLTFBindingsHaveSourceSnapshots(prefab) {
     );
   }
 }
-function createRequiredHydrationSourceRefResolver(resolveSourceRef2) {
-  const codec2 = createSourceRefCodec({ resolveSourceRef: resolveSourceRef2 });
-  return (ref) => codec2.sourceToDomain(ref);
-}
 function hydrateSourceV2SceneToDomain(sceneFile, options = {}) {
   const parseSceneFile = sceneFile;
   const entities = {};
   const rootEntityIds = [];
-  const resolveSourceRef2 = createRequiredHydrationSourceRefResolver(options.resolveSourceRef);
-  const hydrationOptions = {
-    ...options,
-    resolveSourceRef: resolveSourceRef2
-  };
   parseSceneFileV2(parseSceneFile, entities, rootEntityIds, {
-    ...hydrationOptions,
+    ...options,
     deferPrefabInlineOverrideMaterialization: true
   });
   const reservedSceneEntityIds = parseSceneFile.entities.map((entity) => entity.id);
   const reservedSceneComponentIds = parseSceneFile.components.map((component2) => component2.id);
-  const initialPrefabState = hydrationOptions.initialPrefabState ? clone(hydrationOptions.initialPrefabState) : createEmptyPrefabState();
+  const initialPrefabState = options.initialPrefabState ? clone(options.initialPrefabState) : createEmptyPrefabState();
   const refreshedPrefab = refreshAndSeedPrefabBindingsFromSource(
     initialPrefabState,
     parseSceneFile,
-    hydrationOptions,
+    options,
     entities,
     reservedSceneEntityIds,
     reservedSceneComponentIds
   );
-  const prefab = prunePrefabBindingsToReachableSourceInstances(parseSceneFile, refreshedPrefab, hydrationOptions);
-  if (!hydrationOptions.allowMissingNestedInstanceBindings) {
-    assertNestedSourceInstanceBindingsPresent(prefab, hydrationOptions);
+  const prefab = prunePrefabBindingsToReachableSourceInstances(parseSceneFile, refreshedPrefab, options);
+  if (!options.allowMissingNestedInstanceBindings) {
+    assertNestedSourceInstanceBindingsPresent(prefab, options);
   }
   assertGLTFBindingsHaveSourceSnapshots(prefab);
   materializePrefabBindingSnapshots(entities, prefab);
@@ -125053,14 +124944,13 @@ function hydrateSourceV2SceneToDomain(sceneFile, options = {}) {
   materializeAddedOverridesFromSource(
     parseSceneFile,
     entities,
-    resolveSourceRef2,
-    hydrationOptions.resolveAssetKind,
+    options.resolveAssetKind,
     prefab,
     addedOverrideMaterializationReport
   );
   assertAddedOverridesMaterialized(prefab, addedOverrideMaterializationReport);
-  assertNoUnmaterializedSourceInstances(entities, prefab, hydrationOptions);
-  const settings = extractSceneSettings(sceneFile.scene, hydrationOptions);
+  assertNoUnmaterializedSourceInstances(entities, prefab, options);
+  const settings = extractSceneSettings(sceneFile.scene);
   return {
     scene: {
       rootEntityIds,
@@ -125444,65 +125334,6 @@ var init_sync_adapter = __esm({
   }
 });
 
-// src/domain-bridge/asset-virtual-path.ts
-function normalizeSourceVirtualPath2(value) {
-  return value.replace(/\\/g, "/").replace(/^\/+/, "");
-}
-function localAssetPathToSourceVirtualPath(localPath, assetType) {
-  const parts = normalizeSourceVirtualPath2(localPath).split("/").filter(Boolean);
-  if (parts[0] === STORAGE_ASSET_ROOT)
-    parts.shift();
-  if (parts.length === 0)
-    return "";
-  if (assetType !== "Folder") {
-    parts[parts.length - 1] = assetNameFromPath(localPath, assetType);
-  }
-  return parts.join("/");
-}
-function createManifestSourceVirtualPathIndex(manifest) {
-  const index2 = /* @__PURE__ */ new Map();
-  for (const [assetId, entry] of Object.entries(manifest.entries)) {
-    const virtualPath = localAssetPathToSourceVirtualPath(entry.path, entry.type);
-    if (!virtualPath)
-      continue;
-    index2.set(virtualPath, assetId);
-    index2.set(`/${virtualPath}`, assetId);
-  }
-  return index2;
-}
-function createDomainAssetSourceRefResolver(assets2) {
-  const cache = /* @__PURE__ */ new Map();
-  const resolve5 = (assetId, visiting = /* @__PURE__ */ new Set()) => {
-    if (cache.has(assetId))
-      return cache.get(assetId);
-    const asset3 = assets2[assetId];
-    if (!asset3 || visiting.has(assetId)) {
-      cache.set(assetId, void 0);
-      return void 0;
-    }
-    visiting.add(assetId);
-    const parentPath = asset3.parentFolderId ? resolve5(asset3.parentFolderId, visiting) : void 0;
-    visiting.delete(assetId);
-    if (asset3.parentFolderId && !parentPath) {
-      cache.set(assetId, void 0);
-      return void 0;
-    }
-    const assetName = asset3.type === "Folder" ? asset3.name : assetNameFromPath(asset3.name, asset3.type);
-    const virtualPath = parentPath ? `${parentPath}/${assetName}` : assetName;
-    cache.set(assetId, virtualPath);
-    return virtualPath;
-  };
-  return (assetId) => resolve5(assetId);
-}
-var STORAGE_ASSET_ROOT;
-var init_asset_virtual_path = __esm({
-  "src/domain-bridge/asset-virtual-path.ts"() {
-    "use strict";
-    init_sync_adapter();
-    STORAGE_ASSET_ROOT = "assets";
-  }
-});
-
 // src/domain-bridge/scene-parser.ts
 function isBuiltinShader(shader) {
   return typeof shader === "string" && BUILTIN_SHADER_NAMES.has(shader);
@@ -125648,22 +125479,9 @@ function resolveSceneAssetId(config2, manifest) {
   }
   return sceneAssetIds[0] ?? "";
 }
-function createSourceRefResolver(manifest, manifestIndex) {
-  const sourceVirtualPathToId = createManifestSourceVirtualPathIndex(manifest);
-  return (ref) => {
-    const assetId = manifestIndex.pathToId.get(ref) ?? sourceVirtualPathToId.get(ref);
-    if (assetId)
-      return assetId;
-    throw new Error(
-      `[domain-bridge] Unable to resolve source asset ref "${ref}". Source-v2 $ref must be a virtualPath.`
-    );
-  };
-}
-function createSourceAssetKindResolver(manifest, manifestIndex) {
-  const sourceVirtualPathToId = createManifestSourceVirtualPathIndex(manifest);
-  return (ref, assetId) => {
-    const resolvedAssetId = manifest.entries[assetId] ? assetId : manifestIndex.pathToId.get(ref) ?? sourceVirtualPathToId.get(ref);
-    const type = manifest.entries[resolvedAssetId ?? ""]?.type;
+function createSourceAssetKindResolver(manifest) {
+  return (assetId) => {
+    const type = manifest.entries[assetId]?.type;
     return type === "Prefab" || type === "glTF" ? type : void 0;
   };
 }
@@ -125696,8 +125514,7 @@ async function loadDomainState(projectDir) {
   let activeSceneFile;
   const assetMeta = /* @__PURE__ */ new Map();
   const manifestIndex = createManifestEntryIndex(manifest.entries);
-  const resolveSourceRef2 = createSourceRefResolver(manifest, manifestIndex);
-  const resolveAssetKind3 = createSourceAssetKindResolver(manifest, manifestIndex);
+  const resolveAssetKind3 = createSourceAssetKindResolver(manifest);
   for (const [assetId, entry] of Object.entries(manifest.entries)) {
     let meta4;
     const inlineMeta = entry.meta;
@@ -125771,7 +125588,6 @@ async function loadDomainState(projectDir) {
   }
   if (activeSceneFile) {
     const hydrated = hydrateSourceV2SceneToDomain(activeSceneFile, {
-      resolveSourceRef: resolveSourceRef2,
       resolveAssetKind: resolveAssetKind3,
       resolvePrefabSourceFile: (assetId) => {
         const content = assets2[assetId]?.content;
@@ -125810,7 +125626,6 @@ var init_load = __esm({
     init_hydrateSourceV2SceneToDomain();
     init_meta_file();
     init_sync_adapter();
-    init_asset_virtual_path();
     init_scene_parser();
     init_utils();
     emptyPrefabDomainState = () => ({ bindings: {}, byAssetId: {} });
@@ -125837,8 +125652,8 @@ async function saveDomainState(projectDir, state, ctx) {
   let currentSceneJson;
   if (ctx.sceneAssetId && state.assets[ctx.sceneAssetId]) {
     const sceneFile = domainStateToSceneFileV2(state, {
-      resolveAssetRef: createDomainAssetSourceRefResolver(state.assets),
-      currentAssetId: ctx.sceneAssetId
+      currentAssetId: ctx.sceneAssetId,
+      assetExists: (assetId) => Boolean(state.assets[assetId])
     });
     state.assets[ctx.sceneAssetId].content = sceneFile;
     currentSceneJson = formatSourceV2SceneFile(sceneFile);
@@ -126118,7 +125933,6 @@ var init_save = __esm({
     init_meta_file();
     init_path_tree();
     init_scene_file_v2();
-    init_asset_virtual_path();
     init_scene_parser();
     init_path_case_guard();
     init_utils();
@@ -126804,7 +126618,6 @@ async function cliCompile(vfs, config2, options, projectShaderChunks = {}) {
         new Blob([JSON.stringify(parsedSceneLike)], { type: "application/json" }),
         resolve5,
         {
-          resolveSourceRef: (value) => resolveSourceRef(vfs, value),
           resolveAssetKind: (value) => resolveAssetKind(vfs, value),
           resolveInstanceSourceFile: (value) => resolveInstanceSourceFile(vfs, value)
         }
@@ -153103,23 +152916,29 @@ var init_AssetFacade = __esm({
        * 删除资产
        */
       async deleteAsset(assetId) {
-        const flush = this.prepareFlush([assetId]);
+        const deleteIds = this.collectDeleteTargetAssetIds([assetId]);
+        const flush = this.prepareFlush(deleteIds);
         if (flush) {
           try {
             await flush;
           } catch {
           }
         }
-        const input = { assetId };
-        this.root.commandBus.execute(this.deleteCmd, input, "asset.delete");
-        this.root.assetUIStore?.clearAssetUploading(assetId);
+        this.runBatch("asset.delete", () => {
+          this.unlinkAssetInstancesBeforeDelete(deleteIds);
+          this.executeDeleteCommands([assetId]);
+        });
+        for (const id of deleteIds) {
+          this.root.assetUIStore?.clearAssetUploading(id);
+        }
       }
       /**
        * 批量删除资产
        */
       async deleteAssets(assetIds) {
         const ids = [...assetIds];
-        const flush = this.prepareFlush(ids);
+        const deleteIds = this.collectDeleteTargetAssetIds(ids);
+        const flush = this.prepareFlush(deleteIds);
         if (flush) {
           try {
             await flush;
@@ -153127,9 +152946,10 @@ var init_AssetFacade = __esm({
           }
         }
         this.runBatch("asset.deleteMultiple", () => {
+          this.unlinkAssetInstancesBeforeDelete(deleteIds);
           this.executeDeleteCommands(ids);
         });
-        for (const id of ids) {
+        for (const id of deleteIds) {
           this.root.assetUIStore?.clearAssetUploading(id);
         }
       }
@@ -153141,7 +152961,9 @@ var init_AssetFacade = __esm({
        */
       async deleteAssetsWithInstances(assetIds, instanceEntityIds) {
         const ids = [...assetIds];
-        const flush = this.prepareFlush(ids);
+        const deleteIds = this.collectDeleteTargetAssetIds(ids);
+        const entityIds = this.collectInstanceEntityIdsForAssets(deleteIds, instanceEntityIds);
+        const flush = this.prepareFlush(deleteIds);
         if (flush) {
           try {
             await flush;
@@ -153149,10 +152971,11 @@ var init_AssetFacade = __esm({
           }
         }
         this.runBatch("asset.deleteWithInstances", () => {
-          this.root.entityFacade.deleteEntities(instanceEntityIds);
+          this.root.entityFacade.deleteEntities(entityIds);
+          this.unlinkAssetInstancesBeforeDelete(deleteIds);
           this.executeDeleteCommands(ids);
         });
-        for (const id of ids) {
+        for (const id of deleteIds) {
           this.root.assetUIStore?.clearAssetUploading(id);
         }
       }
@@ -153176,6 +152999,47 @@ var init_AssetFacade = __esm({
           }
         }
       }
+      collectDeleteTargetAssetIds(assetIds) {
+        const ids = /* @__PURE__ */ new Set();
+        for (const assetId of assetIds) {
+          if (!this.state.assets[assetId])
+            continue;
+          for (const id of collectAssetSubtree(this.state, assetId)) {
+            ids.add(id);
+          }
+        }
+        return Array.from(ids);
+      }
+      unlinkAssetInstancesBeforeDelete(assetIds) {
+        const deleting = new Set(assetIds);
+        for (const assetId of assetIds) {
+          if (this.state.prefab.byAssetId[assetId]?.length) {
+            this.root.prefabFacade.unpackByAsset(assetId);
+          }
+        }
+        const directInstanceEntityIds = Object.values(this.state.entities).filter((entity) => {
+          const instance2 = entity.instance;
+          return Boolean(instance2?.assetId && deleting.has(instance2.assetId) && !instance2.bindingId);
+        }).map((entity) => entity.id);
+        for (const entityId of directInstanceEntityIds) {
+          if (this.state.entities[entityId]?.instance) {
+            this.root.entityFacade.updateEntity(entityId, { instance: null });
+          }
+        }
+      }
+      collectInstanceEntityIdsForAssets(assetIds, existingEntityIds) {
+        const entityIds = new Set(existingEntityIds);
+        for (const assetId of assetIds) {
+          const bindingIds = this.state.prefab.byAssetId[assetId] ?? [];
+          for (const bindingId of bindingIds) {
+            const binding = this.state.prefab.bindings[bindingId];
+            if (binding?.instanceRootEntityId) {
+              entityIds.add(binding.instanceRootEntityId);
+            }
+          }
+        }
+        return Array.from(entityIds);
+      }
       /** Collect pending flush promises and track them. Returns void if nothing to flush. */
       prepareFlush(assetIds) {
         const pending = this.flushAllPendingSaves(assetIds);
@@ -287940,9 +287804,17 @@ function compactTransformAgainstSnapshot(snapshot, transform5) {
     const axisPatch = transform5[key2];
     if (!axisPatch)
       continue;
-    const compactedAxis = compactDomainRecordPatch(snapshot[key2], axisPatch);
-    if (compactedAxis)
-      next[key2] = compactedAxis;
+    const compactedAxis = {};
+    for (const axis of TRANSFORM_AXIS_KEYS) {
+      const value = axisPatch[axis];
+      if (value === void 0)
+        continue;
+      if (Math.abs(value - snapshot[key2][axis]) > TRANSFORM_OVERRIDE_EPSILON) {
+        compactedAxis[axis] = value;
+      }
+    }
+    if (Object.keys(compactedAxis).length)
+      next[key2] = cloneState(compactedAxis);
   }
   return Object.keys(next).length ? next : void 0;
 }
@@ -288064,7 +287936,7 @@ function isNestedInstanceSubtreeEntity(state, entity, targetBindingId, subtreeId
   const nestedBinding = state.prefab.bindings[instance2.bindingId];
   return Boolean(nestedBinding && subtreeIds.has(nestedBinding.instanceRootEntityId));
 }
-var SetEntityOverrideCommand, SetComponentOverrideCommand, AddEntityOverrideCommand, AddExistingEntityOverrideCommand, RemoveSourceEntityOverrideCommand, AddComponentOverrideCommand, UpdateAddedComponentOverrideCommand, RemoveSourceComponentOverrideCommand;
+var TRANSFORM_OVERRIDE_EPSILON, TRANSFORM_AXIS_KEYS, SetEntityOverrideCommand, SetComponentOverrideCommand, AddEntityOverrideCommand, AddExistingEntityOverrideCommand, RemoveSourceEntityOverrideCommand, AddComponentOverrideCommand, UpdateAddedComponentOverrideCommand, RemoveSourceComponentOverrideCommand;
 var init_OverrideCommands = __esm({
   "../model/src/domain/commands/prefab/OverrideCommands.ts"() {
     "use strict";
@@ -288077,6 +287949,8 @@ var init_OverrideCommands = __esm({
     init_cloneState();
     init_transformHierarchy();
     init_isPlainRecord();
+    TRANSFORM_OVERRIDE_EPSILON = 1e-8;
+    TRANSFORM_AXIS_KEYS = ["x", "y", "z"];
     SetEntityOverrideCommand = class {
       name = "prefab.setEntityOverride";
       execute(state, input) {
@@ -288087,6 +287961,8 @@ var init_OverrideCommands = __esm({
         const sourceEntityId = requirePrefabSourceEntityId(entity, entityId, binding);
         const encodedSourceId = encodeJsonPointerSegment(sourceEntityId);
         const encodedBindingId = encodeJsonPointerSegment(binding.id);
+        const sourceSnapshot = binding.sourceEntitySnapshots?.[sourceEntityId];
+        const existingOverride = binding.overrides.entityProps[sourceEntityId];
         if (overrides.name !== void 0) {
           ops2.push({ op: "replace", path: `/entities/${encodedEntityId}/name`, value: overrides.name });
         }
@@ -288126,9 +288002,8 @@ var init_OverrideCommands = __esm({
             });
           }
         }
-        const existingOverride = binding.overrides.entityProps[sourceEntityId];
         const merged = mergeEntityOverrideProps2(existingOverride, overrides);
-        const compacted = compactEntityOverrideAgainstSnapshot(binding.sourceEntitySnapshots?.[sourceEntityId], merged);
+        const compacted = compactEntityOverrideAgainstSnapshot(sourceSnapshot, merged);
         let overrideChangeAction = null;
         if (compacted) {
           ops2.push({
@@ -290070,7 +289945,7 @@ function isV2PrefabContent(content) {
 function normalizeSourceIdPrefabContent(content) {
   return content;
 }
-function normalizePrefabEntities(content, resolveSourceRef2) {
+function normalizePrefabEntities(content) {
   if (!isV2PrefabContent(content)) {
     return content.entities ?? [];
   }
@@ -290112,10 +289987,10 @@ function normalizePrefabEntities(content, resolveSourceRef2) {
           {
             id: componentId,
             type: component2.type,
-            props: convertAssetRefsToDomainRefs(component2.props ?? {}, resolveSourceRef2),
-            ...component2.script?.$ref ? { refId: resolveRequiredSourceRef(component2.script.$ref, resolveSourceRef2) } : {},
+            props: convertAssetRefsToDomainRefs(component2.props ?? {}),
+            ...component2.script?.$ref ? { refId: resolveRequiredSourceRef(component2.script.$ref) } : {},
             ...component2.script?.key ? { scriptKey: component2.script.key } : {},
-            ...component2.calls?.length ? { calls: convertAssetRefsToDomainRefs(component2.calls, resolveSourceRef2) } : {}
+            ...component2.calls?.length ? { calls: convertAssetRefsToDomainRefs(component2.calls) } : {}
           }
         ];
       })
@@ -290412,7 +290287,7 @@ var init_HeadlessAssetProxy = __esm({
           throw new Error(`instantiate \u4EC5\u652F\u6301 Prefab \u7C7B\u578B\uFF0C\u5F53\u524D\u7C7B\u578B: ${this.type}`);
         }
         const content = this.asset.content;
-        const entities = content ? normalizePrefabEntities(content, (sourceRef) => this.store.getAssetByVirtualPath(sourceRef)?.id) : void 0;
+        const entities = content ? normalizePrefabEntities(content) : void 0;
         if (!entities || !Array.isArray(entities) || entities.length === 0) {
           throw new Error(`Prefab "${this.name}" content \u7F3A\u5C11\u6709\u6548\u7684 entities \u6570\u7EC4`);
         }
@@ -290477,7 +290352,7 @@ var init_HeadlessAssetProxy = __esm({
         const state = this.store.domainStore.state;
         const content = domainStateToPrefabFileV2(state, entity.id, {
           currentAssetId: this.asset.id,
-          resolveAssetRef: (assetId) => this.store.getAssetVirtualPath(assetId)
+          assetExists: (assetId) => Boolean(state.assets[assetId])
         });
         this.store.root.assetFacade.writeContent(this.asset.id, content);
       }
@@ -290515,8 +290390,6 @@ var init_HeadlessVFS = __esm({
       }
       /**
        * 通过 vfs 绝对路径解析到资产（id + 类型）。
-       * editor-api 的 `resolveAssetRef` 调用此入口，将 path 入参翻译成内部 uuid。
-       *
        * 这里直接复用 `resolveAssetByPath`（HeadlessVFS 既有路径解析核心），
        * 因此和 file tools (read/list/write/edit) 看到的图结构完全一致。
        */
@@ -291192,51 +291065,37 @@ var init_ResourcePackageImporter = __esm({
           manifestPathMap.set(asset3.path, asset3);
           manifestPathMap.set(normalizeSourceVirtualPath(asset3.path), asset3);
         }
-        const importedVirtualPathByEntryPath = /* @__PURE__ */ new Map();
-        let plannedTargetVirtualPathByEntryPath = /* @__PURE__ */ new Map();
         const resolveExistingTargetAssetId = (entry) => {
           const targetVirtualPath = desiredTargetVirtualPathByEntryPath.get(entry.path);
           const targetId = targetVirtualPath ? virtualPathToId.get(targetVirtualPath) ?? virtualPathToId.get(normalizeSourceVirtualPath(targetVirtualPath)) : void 0;
           return targetId ?? virtualPathToId.get(entry.path) ?? virtualPathToId.get(normalizeSourceVirtualPath(entry.path));
         };
         const resolveUrlToAssetId = (url2) => {
-          const entry = manifestPathMap.get(url2);
+          const sourceRef = normalizeSourceVirtualPath(url2);
+          const entry = manifestPathMap.get(url2) ?? manifestPathMap.get(sourceRef);
           if (entry) {
             return assetIdByPath.get(entry.path) || resolveExistingTargetAssetId(entry) || void 0;
           }
-          return virtualPathToId.get(url2) ?? virtualPathToId.get(normalizeSourceVirtualPath(url2));
+          return virtualPathToId.get(url2) ?? virtualPathToId.get(sourceRef);
         };
         const resolveUrlToImportableSourceRef = (url2) => {
           const sourceRef = normalizeSourceVirtualPath(url2);
-          const entry = manifestPathMap.get(url2);
+          const entry = manifestPathMap.get(url2) ?? manifestPathMap.get(sourceRef);
           if (entry) {
-            if (assetIdByPath.get(entry.path))
-              return normalizeSourceVirtualPath(entry.path);
-            const targetVirtualPath = desiredTargetVirtualPathByEntryPath.get(entry.path);
-            if (targetVirtualPath && (virtualPathToId.has(targetVirtualPath) || virtualPathToId.has(normalizeSourceVirtualPath(targetVirtualPath)))) {
-              return normalizeSourceVirtualPath(targetVirtualPath);
-            }
-            if (virtualPathToId.has(url2) || virtualPathToId.has(sourceRef))
-              return sourceRef;
-            return void 0;
+            const assetId = assetIdByPath.get(entry.path) || resolveExistingTargetAssetId(entry);
+            return assetId ? assertAndReturnSourceAssetRef(assetId, ` for GRP source reference "${url2}"`) : void 0;
           }
-          const hasExistingTargetAsset = virtualPathToId.has(url2) || virtualPathToId.has(sourceRef);
+          const existingTargetAssetId = virtualPathToId.get(url2) ?? virtualPathToId.get(sourceRef);
           const isInternalRef = isInternalAssetPath(url2) || sourceRef.startsWith("Internal/");
           if (isInternalRef) {
-            if (hasExistingTargetAsset)
-              return sourceRef;
+            if (existingTargetAssetId) {
+              return assertAndReturnSourceAssetRef(existingTargetAssetId, ` for GRP source reference "${url2}"`);
+            }
             throw new Error(`GRP source asset reference "${url2}" could not be resolved in the target project`);
           }
           throw new Error(`GRP source asset reference "${url2}" is not declared in the GRP manifest`);
         };
         const resolveUrlToSourceRef = (url2) => {
-          const sourceRef = normalizeSourceVirtualPath(url2);
-          const importedPath = importedVirtualPathByEntryPath.get(url2) ?? importedVirtualPathByEntryPath.get(sourceRef);
-          if (importedPath)
-            return normalizeSourceVirtualPath(importedPath);
-          const plannedPath = plannedTargetVirtualPathByEntryPath.get(url2) ?? plannedTargetVirtualPathByEntryPath.get(sourceRef);
-          if (plannedPath)
-            return normalizeSourceVirtualPath(plannedPath);
           return resolveUrlToImportableSourceRef(url2);
         };
         const entriesToImport = parsedManifest.assets.filter((entry) => assetIdByPath.has(entry.path));
@@ -291254,11 +291113,6 @@ var init_ResourcePackageImporter = __esm({
           await this.createFolderStructure(entriesToImport, options.targetFolderId, folderIdMapping);
         }
         const sortedEntries = this.topologicalSort(parsedManifest);
-        plannedTargetVirtualPathByEntryPath = this.buildPlannedTargetVirtualPathByEntryPath(
-          sortedEntries.filter((entry) => assetIdByPath.has(entry.path)),
-          folderIdMapping,
-          options
-        );
         const importedAssets = [];
         for (const entry of sortedEntries) {
           const newId = assetIdByPath.get(entry.path);
@@ -291279,12 +291133,6 @@ var init_ResourcePackageImporter = __esm({
             const assetId = await this.createAsset(entry, processedFileData, newId, folderIdMapping, options);
             if (assetId) {
               importedAssets.push(assetId);
-              const importedAsset = this.assetStore.assets[assetId];
-              const importedPath = importedAsset?.getRouteString(true);
-              if (importedPath) {
-                importedVirtualPathByEntryPath.set(entry.path, importedPath);
-                importedVirtualPathByEntryPath.set(normalizeSourceVirtualPath(entry.path), importedPath);
-              }
             }
           } catch (e6) {
             const name16 = getGRPAssetName(entry);
@@ -291391,26 +291239,6 @@ var init_ResourcePackageImporter = __esm({
         }
         return targetPathByEntryPath;
       }
-      buildPlannedTargetVirtualPathByEntryPath(entries, folderIdMapping, options) {
-        const targetPathByEntryPath = /* @__PURE__ */ new Map();
-        const reservedNamesByFolder = /* @__PURE__ */ new Map();
-        for (const entry of entries) {
-          const parentFolderId = this.resolveTargetFolderId(entry, folderIdMapping, options);
-          const folderKey = parentFolderId ?? "__ROOT__";
-          let reservedNames = reservedNamesByFolder.get(folderKey);
-          if (!reservedNames) {
-            reservedNames = /* @__PURE__ */ new Set();
-            reservedNamesByFolder.set(folderKey, reservedNames);
-          }
-          const rawName = getGRPAssetName(entry);
-          const plannedName = options.conflictStrategy === "overwrite" ? rawName : this.getAvailableAssetName(rawName, parentFolderId, reservedNames);
-          reservedNames.add(plannedName);
-          const targetVirtualPath = joinVirtualPath([this.getFolderVirtualPath(parentFolderId), plannedName]);
-          targetPathByEntryPath.set(entry.path, targetVirtualPath);
-          targetPathByEntryPath.set(normalizeSourceVirtualPath(entry.path), targetVirtualPath);
-        }
-        return targetPathByEntryPath;
-      }
       getDesiredTargetVirtualPath(entry, options) {
         const parts = [this.getFolderVirtualPath(options.targetFolderId)];
         if (options.preserveStructure !== false) {
@@ -291441,25 +291269,6 @@ var init_ResourcePackageImporter = __esm({
           return "";
         }
       }
-      getAvailableAssetName(name16, parentFolderId, reservedNames) {
-        const usedNames = new Set(reservedNames);
-        for (const asset3 of Object.values(this.assetStore.assets)) {
-          if ((asset3.parentFolderId ?? null) === parentFolderId) {
-            usedNames.add(asset3.name);
-          }
-        }
-        if (!usedNames.has(name16))
-          return name16;
-        const ext = extname2(name16);
-        const baseName = ext ? name16.slice(0, -ext.length) : name16;
-        let index2 = 1;
-        while (true) {
-          const candidate = `${baseName}${index2}${ext}`;
-          if (!usedNames.has(candidate))
-            return candidate;
-          index2++;
-        }
-      }
       /**
        * 创建文件夹结构
        */
@@ -291520,7 +291329,7 @@ var init_ResourcePackageImporter = __esm({
       /**
        * 预处理文件数据：
        * - metadata 始终走 editor-internal 形态（url→refId / assetUrl→assetId）。
-       * - source scene/prefab main file 走 v2 source 形态（url→$ref(virtualPath)）。
+       * - source scene/prefab main file 走 v2 source 形态（url→$ref(assetId)）。
        * - 其他 JSON main file 走 editor-internal 形态（url→refId）。
        */
       async _preprocessFileData(entry, fileData, resolveUrlToAssetId, resolveUrlToSourceRef) {
@@ -292097,9 +291906,7 @@ function performHeadlessSceneSwap(args) {
   const state = domainStore.state;
   const nextAssets = { ...state.assets };
   if (currentSceneId && nextAssets[currentSceneId]?.type === "Scene") {
-    const sceneFile = domainStateToSceneFileV2(state, {
-      resolveAssetRef: (assetId) => resolveAssetRefForSource(state, assetId)
-    });
+    const sceneFile = domainStateToSceneFileV2(state);
     nextAssets[currentSceneId] = {
       ...nextAssets[currentSceneId],
       content: sceneFile
@@ -292111,10 +291918,8 @@ function performHeadlessSceneSwap(args) {
   let newPrefabState = { bindings: {}, byAssetId: {} };
   const targetContent = nextAssets[targetSceneId]?.content;
   if (targetContent && typeof targetContent === "object") {
-    const resolveSourceRef2 = createSourceRefResolver2(state);
     const resolveAssetKind3 = createSourceAssetKindResolver2(state);
     const hydrated = hydrateSourceV2SceneToDomain(targetContent, {
-      resolveSourceRef: resolveSourceRef2,
       resolveAssetKind: resolveAssetKind3,
       resolvePrefabSourceFile: (assetId) => {
         const content = nextAssets[assetId]?.content;
@@ -292136,45 +291941,8 @@ function performHeadlessSceneSwap(args) {
   domainStore.reset(newState);
   return { entityCount: Object.keys(newEntities).length };
 }
-function resolveAssetRefForSource(state, assetId) {
-  return assetIdToVirtualPath(state, assetId) ?? assetId;
-}
-function assetIdToVirtualPath(state, assetId) {
-  const asset3 = state.assets[assetId];
-  if (!asset3)
-    return void 0;
-  const folders = [];
-  let parentId = asset3.parentFolderId;
-  while (parentId) {
-    const folder = state.assets[parentId];
-    if (!folder)
-      break;
-    folders.unshift(folder.name);
-    parentId = folder.parentFolderId;
-  }
-  const assetName = asset3.type === "Folder" ? asset3.name : assetNameFromPath(asset3.name, asset3.type);
-  return `${folders.length ? `${folders.join("/")}/` : ""}${assetName}`;
-}
-function virtualPathToAssetId(state, virtualPath) {
-  if (state.assets[virtualPath])
-    return virtualPath;
-  for (const assetId of Object.keys(state.assets)) {
-    if (assetIdToVirtualPath(state, assetId) === virtualPath)
-      return assetId;
-  }
-  return void 0;
-}
-function createSourceRefResolver2(state) {
-  return (ref) => {
-    const assetId = virtualPathToAssetId(state, ref);
-    if (!assetId) {
-      throw new Error(`source v2 asset ref "${ref}" does not match any project asset`);
-    }
-    return assetId;
-  };
-}
 function createSourceAssetKindResolver2(state) {
-  return (_ref, assetId) => {
+  return (assetId) => {
     const type = state.assets[assetId]?.type;
     return type === "Prefab" || type === "glTF" ? type : void 0;
   };
@@ -292182,7 +291950,6 @@ function createSourceAssetKindResolver2(state) {
 var init_sceneSwap = __esm({
   "../model/src/headless/sceneSwap.ts"() {
     "use strict";
-    init_sync_adapter();
     init_scene_file_v2();
     init_hydrateSourceV2SceneToDomain();
   }
@@ -446073,7 +445840,7 @@ function combineLayers(layers) {
     combined |= l6;
   return combined;
 }
-var TRANSFORM_PROPERTIES, TRANSFORM_COMPONENT_TYPES, SCENE_ROOT_ID, InspectorFacade;
+var TRANSFORM_PROPERTIES, TRANSFORM_COMPONENT_TYPES, VIRTUAL_TRANSFORM_SUFFIX, SCENE_ROOT_ID, InspectorFacade;
 var init_InspectorFacade = __esm({
   "../model/src/facades/InspectorFacade.ts"() {
     "use strict";
@@ -446081,6 +445848,7 @@ var init_InspectorFacade = __esm({
     init_resolveSceneChangePath();
     TRANSFORM_PROPERTIES = /* @__PURE__ */ new Set(["position", "rotation", "scale"]);
     TRANSFORM_COMPONENT_TYPES = /* @__PURE__ */ new Set(["Transform", "UITransform"]);
+    VIRTUAL_TRANSFORM_SUFFIX = ":Transform";
     SCENE_ROOT_ID = "__scene__";
     InspectorFacade = class {
       constructor(root3) {
@@ -446113,6 +445881,7 @@ var init_InspectorFacade = __esm({
               throw new Error(`InspectorFacade.applyChange: component owner not found: ${input.objectId}`);
             }
             if (this.isTransformProperty(ownerEntityId, input.objectId, input.property)) {
+              const isVirtualTransformComponent = this.isVirtualTransformComponent(input.objectId, ownerEntityId);
               if (this._batchEntityId && this._batchEntityId !== ownerEntityId) {
                 this.flushBatch();
               }
@@ -446130,9 +445899,11 @@ var init_InspectorFacade = __esm({
                 value
               );
               this._getOrCreateBatch().apply(ops2);
-              this.root.componentFacade.updateComponent(ownerEntityId, input.objectId, {
-                [input.property]: value
-              });
+              if (!isVirtualTransformComponent) {
+                this.root.componentFacade.updateComponent(ownerEntityId, input.objectId, {
+                  [input.property]: value
+                });
+              }
               return;
             }
             this.root.componentFacade.updateComponent(ownerEntityId, input.objectId, {
@@ -446259,6 +446030,8 @@ var init_InspectorFacade = __esm({
       isTransformProperty(entityId, componentId, property2) {
         if (!TRANSFORM_PROPERTIES.has(property2))
           return false;
+        if (this.isVirtualTransformComponent(componentId, entityId))
+          return true;
         const normalized = this.root.domainStore.getNormalizedState();
         return normalized.relations.componentOwner[componentId] === entityId && TRANSFORM_COMPONENT_TYPES.has(normalized.components[componentId]?.type ?? "");
       }
@@ -446274,7 +446047,22 @@ var init_InspectorFacade = __esm({
         ];
       }
       findComponentOwnerEntityId(componentId) {
-        return this.root.domainStore.getNormalizedState().relations.componentOwner[componentId] ?? null;
+        const normalized = this.root.domainStore.getNormalizedState();
+        const ownerEntityId = normalized.relations.componentOwner[componentId];
+        if (ownerEntityId)
+          return ownerEntityId;
+        return this.resolveVirtualTransformOwnerEntityId(componentId);
+      }
+      resolveVirtualTransformOwnerEntityId(componentId) {
+        if (!componentId.endsWith(VIRTUAL_TRANSFORM_SUFFIX))
+          return null;
+        const entityId = componentId.slice(0, -VIRTUAL_TRANSFORM_SUFFIX.length);
+        if (!entityId)
+          return null;
+        return this.root.domainStore.getNormalizedState().entities[entityId] ? entityId : null;
+      }
+      isVirtualTransformComponent(componentId, entityId) {
+        return this.resolveVirtualTransformOwnerEntityId(componentId) === entityId;
       }
     };
   }
@@ -446419,6 +446207,9 @@ var init_Meta = __esm({
 });
 
 // ../model/src/modules/assets/collectAssetReferenceIds.ts
+function isSourceAssetRefRecord(node) {
+  return typeof node.$ref === "string" && isValidSourceAssetRef(node.$ref) && Object.keys(node).every((key2) => SOURCE_ASSET_REF_KEYS.has(key2));
+}
 function collectAssetReferenceIds(value, options, result2 = /* @__PURE__ */ new Set()) {
   const visit = (node, key2) => {
     if (Array.isArray(node)) {
@@ -446437,11 +446228,11 @@ function collectAssetReferenceIds(value, options, result2 = /* @__PURE__ */ new
     if (typeof node.refId === "string" && node.refId !== options.currentAssetId) {
       result2.add(node.refId);
     }
-    if (typeof node.$ref === "string") {
-      const resolvedAssetId = options.resolveVirtualPath?.(node.$ref);
-      if (resolvedAssetId && resolvedAssetId !== options.currentAssetId) {
-        result2.add(resolvedAssetId);
+    if (isSourceAssetRefRecord(node)) {
+      if (node.$ref !== options.currentAssetId) {
+        result2.add(node.$ref);
       }
+      return;
     }
     for (const [childKey, childValue] of Object.entries(node)) {
       visit(childValue, childKey);
@@ -446450,10 +446241,13 @@ function collectAssetReferenceIds(value, options, result2 = /* @__PURE__ */ new
   visit(value);
   return result2;
 }
+var SOURCE_ASSET_REF_KEYS;
 var init_collectAssetReferenceIds = __esm({
   "../model/src/modules/assets/collectAssetReferenceIds.ts"() {
     "use strict";
     init_is_record();
+    init_source_ref_codec();
+    SOURCE_ASSET_REF_KEYS = /* @__PURE__ */ new Set(["$ref", "key", "isClone"]);
   }
 });
 
@@ -516360,8 +516154,7 @@ var init_EditorAsset = __esm({
         this._dependsOnAssetIds.clear();
         const collectRefs = (value) => collectAssetReferenceIds(value, {
           currentAssetId: this.id,
-          extractInstanceAssetId: _EditorAsset._extractV1InstanceAssetId,
-          resolveVirtualPath: (virtualPath) => this.root?.assetStore?.getAssetByVirtualPath?.(virtualPath)?.id
+          extractInstanceAssetId: _EditorAsset._extractV1InstanceAssetId
         });
         collectRefs(this.meta).forEach((refId) => this._dependsOnAssetIds.add(refId));
         if (this._originMainFile) {
@@ -517024,7 +516817,6 @@ var init_ResourcePackageExporter = __esm({
     init_types4();
     init_manifest2();
     init_refConverter();
-    init_source_ref_codec();
     init_collectAssetReferenceIds();
     ResourcePackageExporter = class _ResourcePackageExporter {
       root;
@@ -517132,23 +516924,9 @@ var init_ResourcePackageExporter = __esm({
       collectAssetReferences(asset3, value) {
         return collectAssetReferenceIds(value, {
           currentAssetId: asset3.id,
-          extractInstanceAssetId: _ResourcePackageExporter.extractEntityInstanceAssetId,
-          resolveVirtualPath: (virtualPath) => this.resolveAssetIdByVirtualPath(virtualPath)
+          extractInstanceAssetId: _ResourcePackageExporter.extractEntityInstanceAssetId
         });
       }
-      resolveAssetIdByVirtualPath(virtualPath) {
-        const fromIndex = this.assetStore.getAssetByVirtualPath?.(virtualPath)?.id;
-        if (fromIndex)
-          return fromIndex;
-        const normalizedTarget = normalizeSourceVirtualPath(virtualPath);
-        for (const asset3 of Object.values(this.assetStore.assets)) {
-          const assetPath = this.getVirtualPath(asset3);
-          if (assetPath === virtualPath || normalizeSourceVirtualPath(assetPath) === normalizedTarget) {
-            return asset3.id;
-          }
-        }
-        return void 0;
-      }
       /**
        * 判断资产是否应该跳过（子资产、内置锁定资产等）
        */
@@ -517253,27 +517031,16 @@ var init_ResourcePackageExporter = __esm({
         return null;
       }
       createExportRefResolver() {
-        const virtualPaths = /* @__PURE__ */ new Map();
-        for (const asset3 of Object.values(this.assetStore.assets)) {
-          try {
-            const virtualPath = asset3.getRouteString(true);
-            if (virtualPath) {
-              virtualPaths.set(virtualPath, virtualPath);
-              virtualPaths.set(normalizeSourceVirtualPath(virtualPath), virtualPath);
-            }
-          } catch {
-          }
-        }
         return (value) => {
           const asset3 = this.assetStore.assets[value];
           if (asset3)
             return asset3.getRouteString(true) || void 0;
-          return virtualPaths.get(value);
+          return void 0;
         };
       }
       /**
        * 深度遍历对象，将资产引用转换为 GRP 包内 { url: "/virtualPath" } 格式。
-       * 支持 editor-internal { refId: assetId } 和 source v2 { $ref: virtualPath } 两种输入。
+       * 支持 editor-internal { refId: assetId } 和 source v2 { $ref: assetId } 两种输入。
        */
       convertRefIdsInObject(obj, resolveRef3 = this.createExportRefResolver()) {
         return exportRefs(obj, resolveRef3);
@@ -546707,8 +546474,8 @@ var require_registry = __commonJS({
         if (this.exist(name16) && !force && !x6_common_1.Platform.isApplyingHMR()) {
           this.onDuplicated(name16);
         }
-        const process6 = this.options.process;
-        const entity = process6 ? x6_common_1.FunctionExt.call(process6, this, name16, options) : options;
+        const process7 = this.options.process;
+        const entity = process7 ? x6_common_1.FunctionExt.call(process7, this, name16, options) : options;
         this.data[name16] = entity;
         return entity;
       }
@@ -603705,6 +603472,11 @@ var init_collectComponentPropsFromBinding = __esm({
 });
 
 // ../model/src/modules/entity/helpers/collectEntityPropsFromBinding.ts
+function vectorPatchToTuple(patch, source) {
+  if (!patch)
+    return void 0;
+  return [patch.x ?? source.x, patch.y ?? source.y, patch.z ?? source.z];
+}
 function collectEntityPropsFromBinding(binding) {
   const overrides = binding.overrides?.entityProps;
   if (!overrides)
@@ -603714,7 +603486,8 @@ function collectEntityPropsFromBinding(binding) {
   for (const [sourceEntityId, state] of Object.entries(overrides)) {
     if (sourceEntityIsCoveredByRemovedEntity(binding, sourceEntityId))
       continue;
-    if (!snapshots[sourceEntityId])
+    const snapshot = snapshots[sourceEntityId];
+    if (!snapshot)
       continue;
     const props = {};
     if (state.name !== void 0)
@@ -603725,15 +603498,15 @@ function collectEntityPropsFromBinding(binding) {
       props.layer = state.layer;
     if (state.transform) {
       const t8 = state.transform;
-      if (t8.position) {
-        props.position = [t8.position.x ?? 0, t8.position.y ?? 0, t8.position.z ?? 0];
-      }
-      if (t8.rotation) {
-        props.rotation = [t8.rotation.x ?? 0, t8.rotation.y ?? 0, t8.rotation.z ?? 0];
-      }
-      if (t8.scale) {
-        props.scale = [t8.scale.x ?? 1, t8.scale.y ?? 1, t8.scale.z ?? 1];
-      }
+      const position = vectorPatchToTuple(t8.position, snapshot.transform.position);
+      const rotation = vectorPatchToTuple(t8.rotation, snapshot.transform.rotation);
+      const scale2 = vectorPatchToTuple(t8.scale, snapshot.transform.scale);
+      if (position)
+        props.position = position;
+      if (rotation)
+        props.rotation = rotation;
+      if (scale2)
+        props.scale = scale2;
     }
     if (Object.keys(props).length === 0)
       continue;
@@ -606987,7 +606760,7 @@ var init_EntityModel = __esm({
         const sourceRootAssetRef = sourceRootInstanceAsset?.$ref;
         if (!sourceRootAssetRef)
           return void 0;
-        const sourceRootAsset = this.root.assetStore.getAssetByVirtualPath?.(sourceRootAssetRef);
+        const sourceRootAsset = this.root.assetStore.assets?.[sourceRootAssetRef];
         const assetKind = sourceRootAsset?.getMetaConfig?.()?.type;
         if (assetKind !== "glTF")
           return void 0;
@@ -607426,22 +607199,19 @@ var init_SerializeContext = __esm({
       components = [];
       /** 按序收集的组件 ID。仅供调用方做局部匹配，不写入 source 文件。 */
       componentIds = [];
-      /** assetId → virtualPath 解析函数 */
-      _resolveVirtualPath;
       _sourceRefCodec;
       /** 根据 componentId 查 raw 透传字段（script/calls/refId），用于补 toJSON 遗失的字段。 */
       _lookupComponentState;
-      constructor(orderedEntityIds, resolveVirtualPath, lookupComponentState) {
+      constructor(orderedEntityIds, lookupComponentState) {
         this.entityIds = orderedEntityIds;
-        this._resolveVirtualPath = resolveVirtualPath;
-        this._sourceRefCodec = createSourceRefCodec({ resolveAssetRef: resolveVirtualPath });
+        this._sourceRefCodec = createSourceRefCodec({});
         this._lookupComponentState = lookupComponentState;
         this.entityIndex = /* @__PURE__ */ new Map();
         for (let i6 = 0; i6 < orderedEntityIds.length; i6++) {
           this.entityIndex.set(orderedEntityIds[i6], i6);
         }
       }
-      /** assetId → virtualPath，找不到则 fail-fast，禁止把 editor asset id 写入 source-v2 $ref。 */
+      /** assetId → source $ref. In source-v2 this is identity. */
       resolveVirtualPath(assetId) {
         return this._sourceRefCodec.domainToSource(assetId);
       }
@@ -607482,9 +607252,9 @@ var init_SerializeContext = __esm({
       hasEntityId(entityId) {
         return this.entityIndex.has(entityId);
       }
-      /** 递归转换对象中的 { refId } → { $ref: virtualPath } */
+      /** 递归转换对象中的 { refId } → { $ref: assetId } */
       convertRefs(value) {
-        return convertInternalRefsToSourceValue(value, (ref) => this.resolveVirtualPath(ref));
+        return convertInternalRefsToSourceValue(value);
       }
     };
   }
@@ -607494,15 +607264,6 @@ var init_SerializeContext = __esm({
 function isSceneFile2(file2) {
   return "scene" in file2;
 }
-function createRequiredLocalSourceRefResolver(resolveSourceRef2) {
-  return (ref) => {
-    const assetId = resolveSourceRef2?.(ref);
-    if (typeof assetId !== "string" || assetId.length === 0) {
-      throw new Error(`Unable to resolve source asset ref "${ref}" to an editor asset id during local v2 hydration`);
-    }
-    return assetId;
-  };
-}
 function buildParentById(file2) {
   const parentById = /* @__PURE__ */ new Map();
   file2.entities.forEach((entity) => {
@@ -607514,18 +607275,18 @@ function buildParentById(file2) {
   });
   return parentById;
 }
-function componentToLocalSchema(component2, componentId, resolveSourceRef2) {
+function componentToLocalSchema(component2, componentId) {
   return {
     id: componentId,
     type: component2.type,
-    props: convertAssetRefsToDomainRefs(component2.props ?? {}, resolveSourceRef2),
+    props: convertAssetRefsToDomainRefs(component2.props ?? {}),
     ...component2.script?.$ref ? {
       script: {
-        $ref: resolveSourceRef2(component2.script.$ref),
+        $ref: component2.script.$ref,
         ...component2.script.key ? { key: component2.script.key } : {}
       }
     } : {},
-    ...component2.calls?.length ? { calls: convertAssetRefsToDomainRefs(component2.calls, resolveSourceRef2) } : {}
+    ...component2.calls?.length ? { calls: convertAssetRefsToDomainRefs(component2.calls) } : {}
   };
 }
 function readTransform(entity, rootOverrideTarget) {
@@ -607578,7 +607339,7 @@ function insertLocalChild(parent2, child, sourceChildOffset) {
     return;
   parent2.engineObject.addChild(Math.min(sourceChildOffset, parent2.engineObject.children.length), child.engineObject);
 }
-async function addSourceComponents(model, sourceEntity, sourceIndex, resolveSourceRef2) {
+async function addSourceComponents(model, sourceEntity, sourceIndex) {
   const transform5 = readTransform(sourceEntity);
   if (!model.transform && !hasSourceTransformComponent(sourceEntity, sourceIndex) && EditorComponent.getRegisteredComponent("Transform")) {
     await model.addEditorComponent({
@@ -607592,7 +607353,7 @@ async function addSourceComponents(model, sourceEntity, sourceIndex, resolveSour
     if (!component2) {
       throw new Error(`Invalid source v2 local hydration: component "${componentId}" is missing from source index`);
     }
-    await model.addEditorComponent(componentToLocalSchema(component2, componentId, resolveSourceRef2));
+    await model.addEditorComponent(componentToLocalSchema(component2, componentId));
   }
 }
 async function createSourceEntityModel(manager, sourceIndex, entityId, options) {
@@ -607602,8 +607363,8 @@ async function createSourceEntityModel(manager, sourceIndex, entityId, options)
   }
   const instanceRef = sourceEntity.instance?.asset;
   if (instanceRef?.$ref) {
-    const assetId = options.resolveSourceRef(instanceRef.$ref);
-    const assetKind = options.resolveAssetKind(instanceRef.$ref, assetId);
+    const assetId = instanceRef.$ref;
+    const assetKind = options.resolveAssetKind(assetId);
     const rootOverrideTarget = resolveSourceInstanceRootOverrideTarget({
       sourceEntity,
       fallbackSourceEntityId: entityId,
@@ -607637,7 +607398,7 @@ async function createSourceEntityModel(manager, sourceIndex, entityId, options)
   await model.initImmediate();
   await model.ensureReady();
   applySourceEntityState(model, sourceEntity);
-  await addSourceComponents(model, sourceEntity, sourceIndex, options.resolveSourceRef);
+  await addSourceComponents(model, sourceEntity, sourceIndex);
   applySourceEntityState(model, sourceEntity);
   return model;
 }
@@ -607651,9 +607412,7 @@ async function hydrateSourceV2LocalEntities(manager, file2, options = {}) {
   if (shouldClearExisting) {
     manager.clear();
   }
-  const resolveSourceRef2 = createRequiredLocalSourceRefResolver(options.resolveSourceRef);
   const normalizedOptions = {
-    resolveSourceRef: resolveSourceRef2,
     resolveAssetKind: options.resolveAssetKind ?? (() => void 0),
     resolvePrefabSourceFile: options.resolvePrefabSourceFile,
     clearExisting: shouldClearExisting,
@@ -608682,19 +608441,9 @@ var init_EntityManager = __esm({
         this.clear();
         const raw = parsedData ?? JSON.parse(sceneAsset.getMainData());
         assertSourceV2LocalHydrationFile(raw, `Asset "${sceneAsset.name ?? sceneAsset.id}"`);
-        const getAssetByVirtualPath = (virtualPath) => this.root?.assetStore?.getAssetByVirtualPath?.(virtualPath);
         await this.hydrateSourceV2LocalEntities(raw, {
-          resolveSourceRef: (virtualPath) => {
-            const assetId = getAssetByVirtualPath(virtualPath)?.id;
-            if (typeof assetId !== "string" || assetId.length === 0) {
-              throw new Error(
-                `[SceneV2] Unable to resolve asset ref "${virtualPath}" while loading asset "${sceneAsset.id}". Source-v2 $ref must be a virtualPath, not an editor asset id.`
-              );
-            }
-            return assetId;
-          },
-          resolveAssetKind: (virtualPath) => {
-            const type = getAssetByVirtualPath(virtualPath)?.getMetaConfig?.()?.type;
+          resolveAssetKind: (assetId) => {
+            const type = this.root?.assetStore?.assets?.[assetId]?.getMetaConfig?.()?.type;
             return type === "Prefab" || type === "glTF" ? type : void 0;
           }
         });
@@ -609448,8 +609197,6 @@ var init_EntityManager = __esm({
       toJSON(isForPrefab = false) {
         const orderedEntities = this._collectOrderedEntities(isForPrefab);
         const orderedIds = orderedEntities.map((e6) => e6.id);
-        const assetStore = this.root?.assetStore;
-        const resolveVirtualPath = (assetId) => assetStore?.getAssetVirtualPath?.(assetId);
         const domainStore = this.root?.domainStore;
         const lookupComponentState = domainStore ? (componentId) => {
           const comp = domainStore.getNormalizedState().components[componentId];
@@ -609461,7 +609208,7 @@ var init_EntityManager = __esm({
             ...comp.calls ? { calls: comp.calls } : {}
           };
         } : void 0;
-        const ctx = new SerializeContext(orderedIds, resolveVirtualPath, lookupComponentState);
+        const ctx = new SerializeContext(orderedIds, lookupComponentState);
         const entities = orderedEntities.map((entity) => entity.toV2(ctx, isForPrefab));
         return {
           entities,
@@ -610216,7 +609963,7 @@ var init_EditorScene = __esm({
         const sourceRefs = sceneFile.entities.map((entity) => entity.instance?.asset?.$ref).filter((sourceRef) => typeof sourceRef === "string");
         await Promise.all(
           sourceRefs.map(async (sourceRef) => {
-            const asset3 = this.root.assetStore.getAssetByVirtualPath?.(sourceRef);
+            const asset3 = this.root.assetStore.assets[sourceRef];
             const type = asset3?.getMetaConfig?.()?.type;
             if (type !== "Prefab")
               return;
@@ -610243,7 +609990,7 @@ var init_EditorScene = __esm({
           const sourceRef = entity.instance?.asset?.$ref;
           if (!sourceRef)
             continue;
-          const asset3 = this.root.assetStore.getAssetByVirtualPath?.(sourceRef);
+          const asset3 = this.root.assetStore.assets[sourceRef];
           const assetId = asset3?.id;
           if (!asset3 || !assetId) {
             throw new Error(
@@ -610330,17 +610077,14 @@ var init_EditorScene = __esm({
       async init(sceneAsset) {
         const sceneFile = parseSourceV2SceneFileJson(sceneAsset.getMainData());
         await this.ensureSourceInstancePrefabFilesLoaded(sceneFile);
-        const getAssetByVirtualPath = (virtualPath) => this.root.assetStore.getAssetByVirtualPath?.(virtualPath);
         const sourceRefCodec = createSourceRefCodec({
-          resolveSourceRef: (virtualPath) => getAssetByVirtualPath(virtualPath)?.id,
-          resolveAssetKind: (virtualPath) => {
-            const type = getAssetByVirtualPath(virtualPath)?.getMetaConfig?.()?.type;
+          resolveAssetKind: (assetId) => {
+            const type = this.root.assetStore.assets[assetId]?.getMetaConfig?.()?.type;
             return type === "Prefab" || type === "glTF" ? type : void 0;
           }
         });
         const hydrated = hydrateSourceV2SceneToDomain(sceneFile, {
-          resolveSourceRef: (virtualPath) => sourceRefCodec.sourceToDomain(virtualPath, `loading scene "${sceneAsset.id}"`),
-          resolveAssetKind: (virtualPath) => sourceRefCodec.maybeResolveAssetKind(virtualPath),
+          resolveAssetKind: (assetId) => sourceRefCodec.maybeResolveAssetKind(assetId),
           resolvePrefabSourceFile: (assetId) => {
             return readLoadedPrefabSourceFile(this.root.assetStore.assets[assetId]);
           }
@@ -610424,10 +610168,7 @@ var init_EditorScene = __esm({
        */
       deserialize(sceneFile) {
         const serializeConfigs = getSerializeConfigs(this);
-        const sceneWithEditorRefs = sourceSceneSettingsToEditorSettings(
-          sceneFile.scene ?? {},
-          (ref) => this.root.assetStore.getAssetByVirtualPath?.(ref)?.id
-        );
+        const sceneWithEditorRefs = sourceSceneSettingsToEditorSettings(sceneFile.scene ?? {});
         const editorSceneFile = { ...sceneFile, scene: sceneWithEditorRefs };
         Object.keys(serializeConfigs).forEach((key2) => {
           const serializeConfig = serializeConfigs[key2];
@@ -610479,10 +610220,7 @@ var init_EditorScene = __esm({
           }
           set2(settingsData, serialKey, value);
         });
-        const sceneSettings = editorSceneSettingsToSourceSettings(
-          settingsData.scene ?? {},
-          (assetId) => this.root.assetStore.getAssetVirtualPath?.(assetId)
-        );
+        const sceneSettings = editorSceneSettingsToSourceSettings(settingsData.scene ?? {});
         const sceneAssetName = this.root.assetStore.assets[this.refId]?.name;
         const rootEntityIds = this.rootEntities.map((entity) => entity.id);
         const scene = {
@@ -621940,6 +621678,7 @@ var init_AssetEffectsRunner = __esm({
         const capturedProjectId = this.projectId;
         const commandName = tx.commandName ?? "";
         const shouldCreateFromAdd = commandName.startsWith("undo:") || commandName === "redo:asset.create" || commandName === "asset.copy";
+        const createCandidates = [];
         const updates = /* @__PURE__ */ new Map();
         for (const op of tx.operations) {
           const propertyMatch = this.parsePropertyPath(op.path);
@@ -621970,15 +621709,14 @@ var init_AssetEffectsRunner = __esm({
             }
           } else if (op.op === "add" && shouldCreateFromAdd && "value" in op) {
             const state = op.value;
-            if (state.url) {
-              this.scheduleAssetTask(
-                assetId,
-                () => this.handleCreate(assetId, state, rev, capturedProjectId, sessionToken),
-                sessionToken
-              );
+            if (this.shouldCreateRemoteAsset(state)) {
+              createCandidates.push({ assetId, state, revision: rev });
             }
           }
         }
+        if (createCandidates.length) {
+          this.scheduleCreateBatch(createCandidates, capturedProjectId, sessionToken);
+        }
         for (const [assetId, payload] of updates) {
           this.scheduleAssetTask(
             assetId,
@@ -622002,6 +621740,58 @@ var init_AssetEffectsRunner = __esm({
           );
         }
       }
+      shouldCreateRemoteAsset(state) {
+        return Boolean(state.url) || state.type === "Folder";
+      }
+      scheduleCreateBatch(candidates, capturedProjectId, sessionToken) {
+        void this.runTask(this.processCreateBatch(candidates, capturedProjectId, sessionToken));
+      }
+      async processCreateBatch(candidates, capturedProjectId, sessionToken) {
+        const blockedParents = /* @__PURE__ */ new Set();
+        for (const candidate of this.orderCreateCandidates(candidates)) {
+          if (this._sessionToken !== sessionToken)
+            return;
+          const parentId = candidate.state.parentFolderId ?? null;
+          if (parentId && blockedParents.has(parentId)) {
+            blockedParents.add(candidate.assetId);
+            continue;
+          }
+          const created = await this.handleCreate(
+            candidate.assetId,
+            candidate.state,
+            candidate.revision,
+            capturedProjectId,
+            sessionToken
+          );
+          if (!created) {
+            blockedParents.add(candidate.assetId);
+          }
+        }
+      }
+      orderCreateCandidates(candidates) {
+        const byId = new Map(candidates.map((candidate) => [candidate.assetId, candidate]));
+        const ordered = [];
+        const visited = /* @__PURE__ */ new Set();
+        const visiting = /* @__PURE__ */ new Set();
+        const visit = (candidate) => {
+          if (visited.has(candidate.assetId))
+            return;
+          if (visiting.has(candidate.assetId))
+            return;
+          visiting.add(candidate.assetId);
+          const parentId = candidate.state.parentFolderId ?? null;
+          const parent2 = parentId ? byId.get(parentId) : void 0;
+          if (parent2)
+            visit(parent2);
+          visiting.delete(candidate.assetId);
+          visited.add(candidate.assetId);
+          ordered.push(candidate);
+        };
+        for (const candidate of candidates) {
+          visit(candidate);
+        }
+        return ordered;
+      }
       async executeDelete(serverIds, capturedProjectId) {
         const { error: error49 } = await this.retryOnce(() => this.api.assets.delete(serverIds, capturedProjectId));
         if (error49) {
@@ -622055,18 +621845,22 @@ var init_AssetEffectsRunner = __esm({
         await this.runTask(this.executeDelete(serverIds, this.projectId));
       }
       async handleCreate(assetId, state, rev, capturedProjectId, sessionToken) {
+        if (this._sessionToken !== sessionToken)
+          return false;
+        if (this.revisions.get(assetId) !== rev || !this.domainStore.state.assets[assetId])
+          return false;
         try {
           const data = await this.api.assets.create(
             buildCreateAssetRequest({ assetId, projectId: capturedProjectId, state })
           );
           if (this._sessionToken !== sessionToken) {
             void this.runTask(this.executeDelete([data.id], capturedProjectId));
-            return;
+            return false;
           }
           const currentAsset = this.domainStore.state.assets[assetId];
           if (this.revisions.get(assetId) !== rev || !currentAsset) {
             void this.runTask(this.executeDelete([data.id], capturedProjectId));
-            return;
+            return false;
           }
           const opType = Object.prototype.hasOwnProperty.call(currentAsset, "serverId") ? "replace" : "add";
           try {
@@ -622075,6 +621869,7 @@ var init_AssetEffectsRunner = __esm({
             void this.runTask(this.executeDelete([data.id], capturedProjectId));
             throw applyError;
           }
+          return true;
         } catch (error49) {
           console.warn("[AssetEffectsRunner] recreate failed:", error49);
           this.reportError(
@@ -622083,6 +621878,7 @@ var init_AssetEffectsRunner = __esm({
               originalError: error49
             })
           );
+          return false;
         }
       }
       runTask(task) {
@@ -623137,7 +622933,6 @@ var init_InstanceEditorAsset = __esm({
         }
       }
       afterDelete() {
-        this.unpackAllInstances();
         this.root.sceneStore.selectEntity(null);
         this._clonedEntities.forEach((entity) => entity.destroy());
         const dragTempEntity = this.getDragTempEntity();
@@ -713284,14 +713079,25 @@ var init_launchAssetInIde = __esm({
 });
 
 // ../../plugins/main/src/assets/shader/parseEnumStorageType.ts
-function detectEnumStorageType(firstPair) {
+function hasEnumStorageTypeOverride(propertyName) {
+  return FLOAT_STORAGE_ENUM_PROPERTIES.has(propertyName);
+}
+function detectEnumStorageType(firstPair, propertyName) {
+  if (propertyName && FLOAT_STORAGE_ENUM_PROPERTIES.has(propertyName))
+    return "Float" /* Float */;
   const rawValue = firstPair.split(":")[1] ?? "";
   return rawValue.includes(".") ? "Float" /* Float */ : "Integer" /* Integer */;
 }
+var FLOAT_STORAGE_ENUM_PROPERTIES;
 var init_parseEnumStorageType = __esm({
   "../../plugins/main/src/assets/shader/parseEnumStorageType.ts"() {
     "use strict";
     init_types9();
+    FLOAT_STORAGE_ENUM_PROPERTIES = /* @__PURE__ */ new Set([
+      // PBR declares this as `Enum(UV0:0, UV1:1)` in the editor UI block, but the
+      // runtime shader uniform and PBRMaterial API store it as a float.
+      "material_OcclusionTextureCoord"
+    ]);
   }
 });
 
@@ -714824,8 +714630,8 @@ var init_ShaderAsset = __esm({
       static create(content, propertyName) {
         const itemContent = content.slice(5, -1);
         const pairs = itemContent.split(",");
-        let type = detectEnumStorageType(pairs[0]);
-        if (propertyName) {
+        let type = detectEnumStorageType(pairs[0], propertyName);
+        if (propertyName && !hasEnumStorageTypeOverride(propertyName)) {
           const engineType = import_engine115.ShaderProperty.getByName(propertyName).type;
           if (engineType === import_engine115.ShaderPropertyType.Int)
             type = "Integer" /* Integer */;
@@ -718756,14 +718562,11 @@ function replaceAssetRefValue(value, oldRef, newRef) {
 function replacePrefabAssetRefs(prefabFile, oldRef, newRef) {
   return replaceAssetRefValue(prefabFile, oldRef, newRef);
 }
-function replacePrefabDependentAssetRef(prefabFile, oldAsset, newAssetId, resolveVirtualPath) {
-  const oldRef = oldAsset.ref ?? resolveVirtualPath(oldAsset.id);
+function replacePrefabDependentAssetRef(prefabFile, oldAsset, newAssetId) {
+  const newRef = assertAndReturnSourceAssetRef(newAssetId);
+  const oldRef = oldAsset.ref ?? oldAsset.id;
   if (typeof oldRef !== "string" || oldRef.length === 0) {
-    throw new Error(`[SceneV2] Unable to replace prefab asset ref "${oldAsset.id}": missing old virtualPath`);
-  }
-  const newRef = resolveVirtualPath(newAssetId);
-  if (typeof newRef !== "string" || newRef.length === 0) {
-    throw new Error(`[SceneV2] Unable to replace prefab asset ref "${newAssetId}": missing new virtualPath`);
+    throw new Error(`[SceneV2] Unable to replace prefab asset ref "${oldAsset.id}": missing old source ref`);
   }
   let result2 = replacePrefabAssetRefs(prefabFile, oldRef, newRef);
   if (oldRef !== oldAsset.id) {
@@ -718774,6 +718577,7 @@ function replacePrefabDependentAssetRef(prefabFile, oldAsset, newAssetId, resolv
 var init_prefabAssetRefs = __esm({
   "../../plugins/main/src/assets/prefab/prefabAssetRefs.ts"() {
     "use strict";
+    init_scene_file_v2();
   }
 });
 
@@ -718976,10 +718780,7 @@ function collectSnapshotComponentMetadata(input) {
   const componentStates = input.normalized?.components;
   const componentState = (input.sceneComponentId ? componentStates?.[input.sceneComponentId] : void 0) ?? (input.component?.id ? componentStates?.[input.component.id] : void 0);
   const metadata = {};
-  const refId = componentState?.refId ?? (typeof input.schema.script?.$ref === "string" ? input.resolveSourceAssetRefToDomainId(
-    input.schema.script.$ref,
-    `component "${input.component?.id ?? input.schema.type}" script`
-  ) : void 0);
+  const refId = componentState?.refId ?? (typeof input.schema.script?.$ref === "string" ? resolveRequiredSourceRef(input.schema.script.$ref) : void 0);
   if (refId)
     metadata.refId = refId;
   const scriptKey = componentState?.scriptKey ?? input.schema.script?.key;
@@ -719135,7 +718936,6 @@ function collectPrefabDomainInstanceBaseline(input) {
           schema: schema2,
           sceneComponentId,
           normalized,
-          resolveSourceAssetRefToDomainId: input.resolveSourceAssetRefToDomainId,
           convertSourceRefsToDomainRefs: input.convertSourceRefsToDomainRefs
         }),
         props: input.collectComponentProps(component2, schema2)
@@ -719469,13 +719269,7 @@ var init_PrefabAsset = __esm({
         });
       }
       replaceDependentAsset(assetInfo2, newAsset) {
-        const assetStore = this.root.assetStore;
-        this.prefabFile = replacePrefabDependentAssetRef(
-          this.prefabFile,
-          assetInfo2,
-          newAsset.id,
-          (assetId) => assetStore.getAssetVirtualPath?.(assetId)
-        );
+        this.prefabFile = replacePrefabDependentAssetRef(this.prefabFile, assetInfo2, newAsset.id);
         assetInfo2.id = newAsset.id;
         assetInfo2.name = newAsset.name;
         assetInfo2.type = newAsset.getMetaConfig().type;
@@ -719483,30 +719277,23 @@ var init_PrefabAsset = __esm({
         this._updateContent();
       }
       _createSourceSerializeContext(orderedEntityIds = []) {
-        const assetStore = this.root.assetStore;
         const normalized = this.root.domainStore?.getNormalizedState?.();
-        return new SerializeContext(
-          orderedEntityIds,
-          (assetId) => assetStore.getAssetVirtualPath?.(assetId),
-          (componentId) => {
-            const component2 = normalized?.components?.[componentId];
-            if (!component2)
-              return void 0;
-            return {
-              refId: component2.refId,
-              scriptKey: component2.scriptKey,
-              calls: component2.calls
-            };
-          }
-        );
+        return new SerializeContext(orderedEntityIds, (componentId) => {
+          const component2 = normalized?.components?.[componentId];
+          if (!component2)
+            return void 0;
+          return {
+            refId: component2.refId,
+            scriptKey: component2.scriptKey,
+            calls: component2.calls
+          };
+        });
       }
       _createSourceRefCodec() {
         const assetStore = this.root.assetStore;
         return createSourceRefCodec({
-          resolveAssetRef: (assetId) => assetStore.getAssetVirtualPath?.(assetId),
-          resolveSourceRef: (sourceRef) => assetStore.getAssetByVirtualPath?.(sourceRef)?.id,
-          resolveAssetKind: (sourceRef) => {
-            const type = assetStore.getAssetByVirtualPath?.(sourceRef)?.getMetaConfig?.()?.type;
+          resolveAssetKind: (assetId) => {
+            const type = assetStore.assets?.[assetId]?.getMetaConfig?.()?.type;
             return type === "Prefab" || type === "glTF" ? type : void 0;
           }
         });
@@ -719515,8 +719302,7 @@ var init_PrefabAsset = __esm({
         return this._createSourceSerializeContext().convertRefs(value);
       }
       _convertSourceRefsToDomainRefs(value) {
-        const codec2 = this._createSourceRefCodec();
-        return convertAssetRefsToDomainRefs(value, (sourceRef) => codec2.sourceToDomain(sourceRef, "prefab source"));
+        return convertAssetRefsToDomainRefs(value);
       }
       _componentSchemaToSourceRefs(component2) {
         const ctx = this._createSourceSerializeContext();
@@ -719537,10 +719323,6 @@ var init_PrefabAsset = __esm({
       }
       _componentScriptRefToSourceRef(ref) {
         const codec2 = this._createSourceRefCodec();
-        if (this.root.assetStore.getAssetByVirtualPath?.(ref)?.id) {
-          assertCanonicalSourceRef(ref, "prefab script");
-          return ref;
-        }
         return codec2.domainToSource(ref, "prefab script");
       }
       _findSourceComponentModel(sourceComponentId) {
@@ -719811,19 +719593,9 @@ var init_PrefabAsset = __esm({
         if (rootEntity)
           applyRootTransformOverride2(rootEntity, rootTransform);
         const sourceIdentityMap = this._assignSceneInstanceIds(prefabFile, rootIndex, options?.expectedRootId);
-        const getAssetByVirtualPath = (virtualPath) => this.root.assetStore.getAssetByVirtualPath?.(virtualPath);
         const rootsEntityModel = await entityManager.hydrateSourceV2LocalEntities(prefabFile, {
-          resolveSourceRef: (virtualPath) => {
-            const assetId = getAssetByVirtualPath(virtualPath)?.id;
-            if (typeof assetId !== "string" || assetId.length === 0) {
-              throw new Error(
-                `[SceneV2] Unable to resolve asset ref "${virtualPath}" while instantiating prefab "${this.id}". Source-v2 $ref must be a virtualPath, not an editor asset id.`
-              );
-            }
-            return assetId;
-          },
-          resolveAssetKind: (virtualPath) => {
-            const type = getAssetByVirtualPath(virtualPath)?.getMetaConfig?.()?.type;
+          resolveAssetKind: (assetId) => {
+            const type = this.root.assetStore.assets?.[assetId]?.getMetaConfig?.()?.type;
             return type === "Prefab" || type === "glTF" ? type : void 0;
           },
           resolvePrefabSourceFile: (assetId) => {
@@ -720082,15 +719854,15 @@ var init_PrefabAsset = __esm({
           sceneSourceComponentKeys: options?.sourceComponentKeyBySceneComponentId,
           allowMissingSceneChildSourceIds: options?.allowMissingSceneChildSourceIds,
           allowMissingSceneComponentSourceKeys: options?.allowMissingSceneComponentSourceKeys,
-          resolveInstanceAsset: (sourceRef, sourceEntityId) => {
-            const asset3 = this.root.assetStore.getAssetByVirtualPath?.(sourceRef);
+          resolveInstanceAsset: (assetId, sourceEntityId) => {
+            const asset3 = this.root.assetStore.assets?.[assetId];
             if (!asset3) {
-              throw new Error(`Prefab source entity "${sourceEntityId}" references missing instance asset "${sourceRef}".`);
+              throw new Error(`Prefab source entity "${sourceEntityId}" references missing instance asset "${assetId}".`);
             }
             const kind = asset3.getMetaConfig?.()?.type;
             if (kind !== "Prefab" && kind !== "glTF") {
               throw new Error(
-                `Prefab source entity "${sourceEntityId}" references unsupported instance asset "${sourceRef}" of type "${String(
+                `Prefab source entity "${sourceEntityId}" references unsupported instance asset "${assetId}" of type "${String(
                   kind
                 )}".`
               );
@@ -720102,7 +719874,6 @@ var init_PrefabAsset = __esm({
               ...kind === "Prefab" && typeof nestedPrefabFile?.root === "string" ? { sourceRootEntityId: nestedPrefabFile.root } : {}
             };
           },
-          resolveSourceAssetRefToDomainId: (sourceRef, context) => this._createSourceRefCodec().sourceToDomain(sourceRef, context),
           convertSourceRefsToDomainRefs: (value) => this._convertSourceRefsToDomainRefs(value),
           collectComponentProps: (component2, schema2) => this._collectSnapshotComponentProps(component2, schema2),
           combineLayers: (layer) => combineLayersByBitwise(layer)
@@ -720155,15 +719926,32 @@ var init_PrefabAsset = __esm({
           scale: { x: engineTransform.scale.x, y: engineTransform.scale.y, z: engineTransform.scale.z }
         } : void 0;
         const expectedBindingId = targetEntity.root.domainStore.getNormalizedState().entities[targetEntityId]?.instance?.bindingId;
+        const deferredInstanceBindings = [];
         const newEntityModel = await this.instantiate(
           entityManager,
           options?.resetRootTransform ? void 0 : rootTransform,
           {
             ...options?.undoable ? { undoable: true } : {},
-            expectedBindingId
+            expectedBindingId,
+            deferDomainBinding: true,
+            deferredInstanceBindings
           }
         );
         newEntityModel.convertToPrefabRefEntity();
+        const domainStore = entityManager.root?.domainStore ?? targetEntity.root.domainStore;
+        const latestTargetEntity = entityManager.entities.get(targetEntityId);
+        const latestTargetDomainEntity = domainStore.getNormalizedState().entities[targetEntityId];
+        if (!latestTargetEntity || !latestTargetDomainEntity?.instance) {
+          newEntityModel.destroy();
+          return null;
+        }
+        if (entityManager.isDomainScoped && !domainStore.state.entities[newEntityModel.id]) {
+          entityManager.registerEntityTreeInDomain(newEntityModel, null, void 0, {
+            ...rootTransform && !options?.resetRootTransform ? { transform: rootTransform } : {},
+            deferInstanceBinding: true
+          });
+        }
+        deferredInstanceBindings.splice(0).forEach((bindDeferredInstance) => bindDeferredInstance());
         if (options?.structuralDeltaMode) {
           entityManager.replaceEntity(targetEntityId, newEntityModel, { structuralDeltaMode: options.structuralDeltaMode });
         } else {
@@ -720248,7 +720036,7 @@ var init_PrefabAsset = __esm({
         for (const ref of findKeysInObject(this.prefabFile, ["$ref"])) {
           if (typeof ref !== "string" || ref === this.id)
             continue;
-          const asset3 = assetStore.getAssetByVirtualPath?.(ref);
+          const asset3 = assetStore.assets?.[ref];
           if (!asset3) {
             throw new Error(`[SceneV2] Unable to resolve prefab asset ref "${ref}" while collecting dependencies`);
           }
@@ -720264,13 +720052,7 @@ var init_PrefabAsset = __esm({
           id: asset3.id,
           name: asset3.name,
           type: asset3.getMetaConfig().type,
-          ref: (() => {
-            const ref = assetStore.getAssetVirtualPath?.(asset3.id);
-            if (typeof ref !== "string" || ref.length === 0) {
-              throw new Error(`[SceneV2] Unable to serialize prefab dependency ref "${asset3.id}": missing virtualPath`);
-            }
-            return ref;
-          })()
+          ref: asset3.id
         }));
       }
       _updateContent(options) {
@@ -724497,26 +724279,25 @@ var init_execute = __esm({
 function scriptComponentRefFromSchema(script) {
   if (!script?.$ref)
     return null;
+  assertSourceAssetRef(script.$ref, "script component");
   return {
     refId: script.$ref,
     ...script.key ? { key: script.key } : {}
   };
 }
-function scriptComponentRefToSchema(script, resolveAssetRef2) {
+function scriptComponentRefToSchema(script) {
   if (!script)
     return void 0;
-  const sourceRef = resolveAssetRef2(script.refId);
-  if (typeof sourceRef !== "string" || sourceRef.length === 0) {
-    throw new Error(`[SceneV2] Unable to serialize script asset ref "${script.refId}": missing virtualPath`);
-  }
+  assertSourceAssetRef(script.refId, "script component");
   return {
-    $ref: sourceRef,
+    $ref: script.refId,
     ...script.key ? { key: script.key } : {}
   };
 }
 var init_script_schema = __esm({
   "../../plugins/main/src/components/ScriptComponent/script-schema.ts"() {
     "use strict";
+    init_scene_file_v2();
   }
 });
 
@@ -724705,7 +724486,7 @@ var init_ScriptComponent = __esm({
             }
           }
         }
-        const script = scriptComponentRefToSchema(this.script, (refId) => this.root.assetStore.getAssetVirtualPath?.(refId));
+        const script = scriptComponentRefToSchema(this.script);
         if (script)
           data.script = script;
         return data;
@@ -739190,7 +738971,7 @@ var init_audio3 = __esm({
 // src/cli.ts
 var import_node_os2 = __toESM(require("node:os"));
 var import_node_path23 = __toESM(require("node:path"));
-var import_node_process3 = __toESM(require("node:process"));
+var import_node_process4 = __toESM(require("node:process"));
 
 // node_modules/commander/esm.mjs
 var import_index = __toESM(require_commander(), 1);
@@ -750393,8 +750174,8 @@ function buildDefaultScene3D() {
         mode: 1,
         color: { r: 0.05087608817155679, g: 0.05087608817155679, b: 0.05087608817155679, a: 1 },
         textureFillMode: 1,
-        skyMaterial: { $ref: "Internal/Material/SkyMat" },
-        skyMesh: { $ref: "Internal/Mesh/Sphere" }
+        skyMaterial: { $ref: "0000201" },
+        skyMesh: { $ref: "0000101" }
       },
       ambient: {
         ambientLight: null,
@@ -750733,6 +750514,118 @@ function registerExecCommand(program3) {
   });
 }
 
+// src/commands/migrate-source-v2.ts
+var import_node_process2 = __toESM(require("node:process"));
+init_scene_file_v2();
+init_node_fs();
+
+// src/domain-bridge/asset-virtual-path.ts
+init_sync_adapter();
+var STORAGE_ASSET_ROOT = "assets";
+function normalizeSourceVirtualPath2(value) {
+  return value.replace(/\\/g, "/").replace(/^\/+/, "");
+}
+function localAssetPathToSourceVirtualPath(localPath, assetType) {
+  const parts = normalizeSourceVirtualPath2(localPath).split("/").filter(Boolean);
+  if (parts[0] === STORAGE_ASSET_ROOT)
+    parts.shift();
+  if (parts.length === 0)
+    return "";
+  if (assetType !== "Folder") {
+    parts[parts.length - 1] = assetNameFromPath(localPath, assetType);
+  }
+  return parts.join("/");
+}
+function createManifestSourceVirtualPathIndex(manifest) {
+  const index2 = /* @__PURE__ */ new Map();
+  for (const [assetId, entry] of Object.entries(manifest.entries)) {
+    const virtualPath = localAssetPathToSourceVirtualPath(entry.path, entry.type);
+    if (!virtualPath)
+      continue;
+    index2.set(virtualPath, assetId);
+    index2.set(`/${virtualPath}`, assetId);
+  }
+  return index2;
+}
+
+// src/commands/migrate-source-v2.ts
+function decodeText2(raw) {
+  return new TextDecoder().decode(raw);
+}
+function projectPath(projectDir, relativePath2) {
+  return `${projectDir.replace(/\/+$/, "")}/${relativePath2.replace(/^\/+/, "")}`;
+}
+function walkRefs(value, visitor) {
+  if (value === null || typeof value !== "object")
+    return;
+  if (Array.isArray(value)) {
+    value.forEach((item) => walkRefs(item, visitor));
+    return;
+  }
+  const record2 = value;
+  if (typeof record2.$ref === "string") {
+    visitor(record2);
+    return;
+  }
+  Object.values(record2).forEach((child) => walkRefs(child, visitor));
+}
+async function migrateSourceV2Refs(projectDir, fs5) {
+  const manifestText = decodeText2(await fs5.readFile(projectPath(projectDir, ".galacean/manifest.json")));
+  const manifest = JSON.parse(manifestText);
+  const pathToId = createManifestSourceVirtualPathIndex(manifest);
+  const result2 = { migrated: 0, skipped: 0, errors: [] };
+  for (const entry of Object.values(manifest.entries)) {
+    if (entry.type === "Folder")
+      continue;
+    const filePath = projectPath(projectDir, entry.path);
+    let parsed;
+    try {
+      parsed = JSON.parse(decodeText2(await fs5.readFile(filePath)));
+    } catch {
+      result2.skipped++;
+      continue;
+    }
+    const replacements = [];
+    const fileErrors = [];
+    walkRefs(parsed, (record2) => {
+      const ref = record2.$ref;
+      if (manifest.entries[ref])
+        return;
+      const resolved = pathToId.get(ref);
+      if (resolved) {
+        replacements.push({ record: record2, nextRef: resolved });
+        return;
+      }
+      if (isValidSourceAssetRef(ref))
+        return;
+      fileErrors.push({ file: entry.path, ref, message: "unresolvable path ref" });
+    });
+    if (fileErrors.length) {
+      result2.errors.push(...fileErrors);
+      result2.skipped++;
+      continue;
+    }
+    if (replacements.length) {
+      replacements.forEach(({ record: record2, nextRef }) => {
+        record2.$ref = nextRef;
+      });
+      await fs5.writeFile(filePath, JSON.stringify(parsed, null, 2));
+      result2.migrated++;
+    } else {
+      result2.skipped++;
+    }
+  }
+  return result2;
+}
+function registerMigrateSourceV2Command(program3) {
+  program3.command("migrate-source-v2 [projectDir]").description("Migrate source-v2 $ref from virtualPath to asset id").action(async (projectDir) => {
+    const result2 = await migrateSourceV2Refs(projectDir ?? import_node_process2.default.cwd(), new NodeFs());
+    console.log(JSON.stringify(result2, null, 2));
+    if (result2.errors.length > 0)
+      import_node_process2.default.exitCode = 1;
+  });
+}
+
 // src/commands/preview.ts
 var import_node_path22 = __toESM(require("node:path"));
 var import_promises17 = require("node:fs/promises");
@@ -751487,7 +751380,7 @@ async function listenWithPortFallback(server, preferredPort) {
 // ../cli-preview/src/server/client-host.ts
 var import_promises16 = require("node:fs/promises");
 var import_node_path21 = __toESM(require("node:path"));
-var import_node_process2 = __toESM(require("node:process"));
+var import_node_process3 = __toESM(require("node:process"));
 var import_node_child_process2 = require("node:child_process");
 
 // ../cli-preview/src/shared/storage-adapter.ts
@@ -752001,12 +751894,12 @@ async function startClientHost(options) {
   const viteBin = await resolveViteBin(workspaceRoot);
   await (0, import_promises16.access)(configPath);
   const child = (0, import_node_child_process2.spawn)(
-    import_node_process2.default.execPath,
+    import_node_process3.default.execPath,
     [viteBin, "--config", configPath, "--host", host, "--port", String(port), "--strictPort", "--force"],
     {
       cwd: workspaceRoot,
       env: {
-        ...import_node_process2.default.env,
+        ...import_node_process3.default.env,
         CLI_PREVIEW_RUNTIME_HOST: host,
         CLI_PREVIEW_RUNTIME_PORT: String(options.runtimePort)
       },
@@ -752037,7 +751930,7 @@ async function startClientHost(options) {
   };
 }
 async function findWorkspaceRoot() {
-  const startDirs = [__dirname, import_node_process2.default.cwd()];
+  const startDirs = [__dirname, import_node_process3.default.cwd()];
   for (const startDir of startDirs) {
     let current = startDir;
     while (true) {
@@ -752262,14 +752155,14 @@ async function resolveClientDir() {
 }
 
 // src/cli-version.ts
-var import_node_fs4 = require("node:fs");
+var import_node_fs5 = require("node:fs");
 var import_meta3 = {};
 function readCliVersionFromPackageJson() {
-  const raw = (0, import_node_fs4.readFileSync)(new URL("../package.json", import_meta3.url), "utf-8");
+  const raw = (0, import_node_fs5.readFileSync)(new URL("../package.json", import_meta3.url), "utf-8");
   const parsed = JSON.parse(raw);
   return typeof parsed.version === "string" && parsed.version.length > 0 ? parsed.version : "0.0.0";
 }
-var CLI_VERSION = "2.0.0-alpha.26".length > 0 ? "2.0.0-alpha.26" : readCliVersionFromPackageJson();
+var CLI_VERSION = "2.0.0-alpha.27".length > 0 ? "2.0.0-alpha.27" : readCliVersionFromPackageJson();
 
 // src/cli.ts
 init_config();
@@ -752282,7 +752175,7 @@ program2.hook("preAction", async (thisCommand) => {
   const opts = thisCommand.optsWithGlobals();
   const configArg = opts.config ?? opts.c;
   const { config: config2 } = await loadConfig(configArg);
-  const token = opts.token ?? import_node_process3.default.env.GALACEAN_TOKEN ?? config2.token;
+  const token = opts.token ?? import_node_process4.default.env.GALACEAN_TOKEN ?? config2.token;
   thisCommand.setOptionValue("_config", config2);
   thisCommand.setOptionValue("_resolvedToken", token);
 });
@@ -752295,6 +752188,7 @@ function getToken2(opts) {
 registerCreateCommand(program2);
 registerExecCommand(program2);
 registerInvokeCommand(program2);
+registerMigrateSourceV2Command(program2);
 registerPreviewCommand(program2);
 registerBuildCommand(program2);
 program2.command("init <projectId>").description("Initialize a project from remote").option("-o, --output <dir>", "output directory").option("--outputDir <dir>", "output directory (alias)").option("-f, --force", "overwrite managed project files in a non-empty output directory").action(async (projectId, cmdOpts) => {
@@ -752312,7 +752206,7 @@ program2.command("init <projectId>").description("Initialize a project from remo
   });
 });
 program2.command("pull [projectDir]").description("Pull remote changes to local").action(async (projectDir) => {
-  const dir = projectDir ?? import_node_process3.default.cwd();
+  const dir = projectDir ?? import_node_process4.default.cwd();
   const globals = program2.optsWithGlobals();
   const serverUrl = await resolveServerUrl(globals, { projectDir: dir, required: true });
   const token = getToken2(globals);
@@ -752348,7 +752242,7 @@ program2.command("pull [projectDir]").description("Pull remote changes to local"
   }
 });
 program2.command("push [projectDir]").description("Push local changes to remote").option("--no-prune-remote", "keep remote assets that are not tracked by the current local manifest").action(async (projectDir, cmdOpts) => {
-  const dir = projectDir ?? import_node_process3.default.cwd();
+  const dir = projectDir ?? import_node_process4.default.cwd();
   const globals = program2.optsWithGlobals();
   const serverUrl = await resolveServerUrl(globals, { projectDir: dir, required: true });
   const token = getToken2(globals);
@@ -752363,7 +752257,7 @@ program2.command("push [projectDir]").description("Push local changes to remote"
   printPushResult(result2);
 });
 program2.command("watch [projectDir]").description("Watch local changes and auto-push").action(async (projectDir) => {
-  const dir = projectDir ?? import_node_process3.default.cwd();
+  const dir = projectDir ?? import_node_process4.default.cwd();
   const globals = program2.optsWithGlobals();
   const serverUrl = await resolveServerUrl(globals, { projectDir: dir, required: true });
   const token = getToken2(globals);
@@ -752388,8 +752282,8 @@ program2.command("watch [projectDir]").description("Watch local changes and auto
       handle2.close();
       resolve5();
     };
-    import_node_process3.default.on("SIGINT", shutdown);
-    import_node_process3.default.on("SIGTERM", shutdown);
+    import_node_process4.default.on("SIGINT", shutdown);
+    import_node_process4.default.on("SIGTERM", shutdown);
   });
 });
 var auth = program2.command("auth").description("Authentication management");
@@ -752405,9 +752299,9 @@ var asset2 = program2.command("asset").description("Asset management");
 registerAssetList(asset2);
 registerAssetInfo(asset2);
 registerAssetTree(asset2);
-program2.parseAsync(import_node_process3.default.argv).catch((err2) => {
+program2.parseAsync(import_node_process4.default.argv).catch((err2) => {
   console.error(err2.stack ?? err2.message ?? err2);
-  import_node_process3.default.exit(1);
+  import_node_process4.default.exit(1);
 });
 /*! Bundled license information: