unity-agentic-tools 0.3.2 → 0.3.3

package/dist/cli.js

@@ -2299,7 +2299,7 @@ var require_package = __commonJS((exports2, module2) => {
   module2.exports = {
     name: "unity-agentic-tools",
     packageManager: "bun@latest",
-    version: "0.3.2",
+    version: "0.3.3",
     description: "Fast, token-efficient Unity YAML parser for AI agents",
     exports: {
       ".": {
@@ -3358,188 +3358,61 @@ function resolve_enum_fields(fields, project_path) {
     }
   } catch {}
 }
-
-// src/editor/yaml-fields.ts
-var PRIMITIVE_DEFAULTS = {
-  int: "0",
-  float: "0",
-  double: "0",
-  bool: "0",
-  string: "",
-  byte: "0",
-  sbyte: "0",
-  short: "0",
-  ushort: "0",
-  uint: "0",
-  long: "0",
-  ulong: "0",
-  char: "0",
-  Int32: "0",
-  Single: "0",
-  Double: "0",
-  Boolean: "0",
-  String: "",
-  Byte: "0",
-  SByte: "0",
-  Int16: "0",
-  UInt16: "0",
-  UInt32: "0",
-  Int64: "0",
-  UInt64: "0",
-  Char: "0"
-};
-var STRUCT_DEFAULTS = {
-  Vector2: "{x: 0, y: 0}",
-  Vector3: "{x: 0, y: 0, z: 0}",
-  Vector4: "{x: 0, y: 0, z: 0, w: 0}",
-  Vector2Int: "{x: 0, y: 0}",
-  Vector3Int: "{x: 0, y: 0, z: 0}",
-  Quaternion: "{x: 0, y: 0, z: 0, w: 1}",
-  Color: "{r: 0, g: 0, b: 0, a: 0}",
-  Color32: "{r: 0, g: 0, b: 0, a: 0}",
-  Rect: `serializedVersion: 2
-    x: 0
-    y: 0
-    width: 0
-    height: 0`,
-  RectInt: "{x: 0, y: 0, width: 0, height: 0}",
-  RectOffset: "{m_Left: 0, m_Right: 0, m_Top: 0, m_Bottom: 0}",
-  Matrix4x4: "{e00: 1, e01: 0, e02: 0, e03: 0, e10: 0, e11: 1, e12: 0, e13: 0, e20: 0, e21: 0, e22: 1, e23: 0, e30: 0, e31: 0, e32: 0, e33: 1}",
-  LayerMask: `serializedVersion: 2
-    m_Bits: 0`
-};
-var VERSION_GATED_STRUCT_DEFAULTS = {
-  Hash128: { value: `serializedVersion: 2
-    Hash: 00000000000000000000000000000000`, min_major: 2021, min_minor: 1 },
-  RenderingLayerMask: { value: `serializedVersion: 2
-    m_Bits: 0`, min_major: 6000, min_minor: 0 }
-};
-var BLOCK_STRUCT_DEFAULTS = {
-  Bounds: `m_Center: {x: 0, y: 0, z: 0}
-    m_Extent: {x: 0, y: 0, z: 0}`,
-  BoundsInt: `m_Position: {x: 0, y: 0, z: 0}
-    m_Size: {x: 0, y: 0, z: 0}`
-};
-var OBJECT_REF_TYPES = new Set([
-  "GameObject",
-  "Transform",
-  "RectTransform",
-  "Material",
-  "Texture",
-  "Texture2D",
-  "Texture3D",
-  "RenderTexture",
-  "Sprite",
-  "AudioClip",
-  "VideoClip",
-  "Mesh",
-  "Shader",
-  "ComputeShader",
-  "AnimationClip",
-  "AnimatorController",
-  "RuntimeAnimatorController",
-  "PhysicMaterial",
-  "PhysicsMaterial",
-  "PhysicsMaterial2D",
-  "Font",
-  "TMP_FontAsset",
-  "Object",
-  "Component",
-  "Behaviour",
-  "MonoBehaviour",
-  "ScriptableObject",
-  "Rigidbody",
-  "Rigidbody2D",
-  "Collider",
-  "Collider2D",
-  "Camera",
-  "Light",
-  "Canvas",
-  "CanvasGroup",
-  "EventSystem",
-  "AudioSource",
-  "ParticleSystem",
-  "TextAsset",
-  "TerrainData"
-]);
-function version_at_least(version, min_major, min_minor) {
-  if (!version)
-    return false;
-  if (version.major > min_major)
-    return true;
-  if (version.major === min_major)
-    return version.minor >= min_minor;
-  return false;
-}
-function yaml_default_for_type(csharp_type, version) {
-  if (csharp_type.endsWith("?")) {
-    return null;
-  }
-  if (csharp_type in PRIMITIVE_DEFAULTS) {
-    return PRIMITIVE_DEFAULTS[csharp_type];
-  }
-  if (csharp_type in STRUCT_DEFAULTS) {
-    return STRUCT_DEFAULTS[csharp_type];
-  }
-  if (csharp_type in VERSION_GATED_STRUCT_DEFAULTS) {
-    const gated = VERSION_GATED_STRUCT_DEFAULTS[csharp_type];
-    if (version_at_least(version, gated.min_major, gated.min_minor)) {
-      return gated.value;
-    }
-    return null;
-  }
-  if (csharp_type in BLOCK_STRUCT_DEFAULTS) {
-    return BLOCK_STRUCT_DEFAULTS[csharp_type];
-  }
-  if (csharp_type.endsWith("[]")) {
-    return "[]";
-  }
-  if (csharp_type.startsWith("List<") && csharp_type.endsWith(">")) {
-    return "[]";
-  }
-  if (OBJECT_REF_TYPES.has(csharp_type)) {
-    return "{fileID: 0}";
-  }
-  return "{fileID: 0}";
-}
-function generate_field_yaml(fields, version, indent = "  ") {
-  const lines = [];
-  for (const field of fields) {
-    if (field.hasSerializeReference) {
-      const t = field.typeName;
-      if (t.endsWith("[]") || t.startsWith("List<") && t.endsWith(">")) {
-        lines.push(`${indent}${field.name}: []`);
-      } else {
-        lines.push(`${indent}${field.name}:`);
-        lines.push(`${indent}  rid: 0`);
+function build_type_lookup(project_path) {
+  let extractFn = null;
+  try {
+    const { getNativeExtractSerializedFields: getNativeExtractSerializedFields2 } = (init_scanner(), __toCommonJS(exports_scanner));
+    extractFn = getNativeExtractSerializedFields2();
+  } catch {}
+  if (!extractFn)
+    return () => null;
+  const assetsDir = path.join(project_path, "Assets");
+  const csIndex = new Map;
+  try {
+    const { readdirSync: readdirSync3 } = require("fs");
+    const entries = readdirSync3(assetsDir, { recursive: true, withFileTypes: false });
+    for (const entry of entries) {
+      if (typeof entry === "string" && entry.endsWith(".cs")) {
+        const basename3 = entry.substring(entry.lastIndexOf("/") + 1).replace(/\.cs$/, "");
+        if (!csIndex.has(basename3)) {
+          csIndex.set(basename3, path.join(assetsDir, entry));
+        }
       }
-      continue;
     }
-    const default_value = yaml_default_for_type(field.typeName, version);
-    if (default_value === null) {
-      continue;
+  } catch {}
+  if (csIndex.size === 0)
+    return () => null;
+  const cache = new Map;
+  return (typeName) => {
+    if (cache.has(typeName))
+      return cache.get(typeName) ?? null;
+    const shortName = typeName.includes(".") ? typeName.substring(typeName.lastIndexOf(".") + 1) : typeName;
+    const csPath = csIndex.get(shortName);
+    if (!csPath || !import_fs6.existsSync(csPath)) {
+      cache.set(typeName, null);
+      return null;
     }
-    if (default_value.includes(`
-`)) {
-      lines.push(`${indent}${field.name}:`);
-      for (const sub_line of default_value.split(`
-`)) {
-        lines.push(`${indent}${sub_line}`);
+    try {
+      const typeInfos = extractFn(csPath);
+      if (!typeInfos || typeInfos.length === 0) {
+        cache.set(typeName, null);
+        return null;
       }
-    } else {
-      lines.push(`${indent}${field.name}: ${default_value}`);
+      const match = typeInfos.find((t) => t.name === shortName);
+      if (match && match.fields && match.fields.length > 0) {
+        resolve_enum_fields(match.fields, project_path);
+        cache.set(typeName, match.fields);
+        return match.fields;
+      }
+      cache.set(typeName, null);
+      return null;
+    } catch {
+      cache.set(typeName, null);
+      return null;
     }
-  }
-  return lines.length > 0 ? `
-` + lines.join(`
-`) + `
-` : `
-`;
+  };
 }
 
-// src/editor/unity-document.ts
-var import_fs7 = require("fs");
-
 // src/editor/unity-block.ts
 var HEADER_PATTERN = /^--- !u!(\d+) &(-?\d+)(\s+stripped)?/;
 function parse_header(raw) {
@@ -3635,10 +3508,36 @@ class UnityBlock {
     const old_raw = this._raw;
     const effective_ref = object_reference && object_reference !== "{fileID: 0}" ? object_reference : undefined;
     if (!path2.includes(".") && !path2.includes("Array")) {
-      const prop_pattern = new RegExp(`(^\\s*${escape_regex(path2)}:\\s*)(.*)$`, "m");
-      if (prop_pattern.test(this._raw)) {
+      const prop_pattern = new RegExp(`(^\\s*${escape_regex(path2)}:[ \\t]*)(.*)$`, "m");
+      const match = this._raw.match(prop_pattern);
+      if (match && match.index !== undefined) {
         const replacement_value = effective_ref ?? yaml_quote_if_needed(value);
-        this._raw = this._raw.replace(prop_pattern, (_match, prefix) => prefix + replacement_value);
+        const current_inline = match[2];
+        if (current_inline.trim() === "") {
+          const key_indent = (match[0].match(/^[ \t]*/)?.[0] || "").length;
+          const after = match.index + match[0].length;
+          let end = after;
+          const rest = this._raw.slice(after);
+          const rest_lines = rest.split(`
+`);
+          for (let i = 1;i < rest_lines.length; i++) {
+            const line = rest_lines[i];
+            if (line.trim() === "") {
+              end += 1 + line.length;
+              continue;
+            }
+            const line_indent = (line.match(/^[ \t]*/)?.[0] || "").length;
+            if (line_indent > key_indent) {
+              end += 1 + line.length;
+            } else {
+              break;
+            }
+          }
+          const prefix = match[1].trimEnd() + " ";
+          this._raw = this._raw.slice(0, match.index) + prefix + replacement_value + this._raw.slice(end);
+        } else {
+          this._raw = this._raw.replace(prop_pattern, (_match, prefix) => prefix + replacement_value);
+        }
       } else {
         const insert_value = effective_ref ?? yaml_quote_if_needed(value);
         this._insert_property(path2, insert_value);
@@ -3718,6 +3617,11 @@ class UnityBlock {
     if (parent_pattern.test(this._raw)) {
       return;
     }
+    const alt = parent.startsWith("m_") ? parent.slice(2) : "m_" + parent;
+    const alt_pattern = new RegExp(`^[ \\t]*${escape_regex(alt)}:`, "m");
+    if (alt_pattern.test(this._raw)) {
+      return;
+    }
     const struct_block = `  ${parent}:
     ${child}: ${value}`;
     const eci_pattern = /^([ \t]*m_EditorClassIdentifier:[ \t]*[^\n]*)/m;
@@ -4020,81 +3924,359 @@ ${element_indent2}- ${value}`);
     }
     return null;
   }
-  _resolve_block_style_path(segments, value) {
-    const lines = this._raw.split(`
-`);
-    let search_start = 0;
-    let search_end = lines.length;
-    for (let seg = 0;seg < segments.length - 1; seg++) {
-      const segment = segments[seg];
-      let parent_idx = -1;
-      let parent_indent = -1;
-      for (let i = search_start;i < search_end; i++) {
-        const match = lines[i].match(new RegExp(`^(\\s*)${escape_regex(segment)}:\\s*(.*)$`));
-        if (match) {
-          const trailing = match[2].trim();
-          if (trailing === "") {
-            parent_idx = i;
-            parent_indent = match[1].length;
-            break;
-          }
-          for (let j = i + 1;j < search_end; j++) {
-            if (lines[j].trim() === "")
-              continue;
-            const nextLeading = lines[j].match(/^(\s*)/);
-            if (nextLeading && nextLeading[1].length > match[1].length) {
-              parent_idx = i;
-              parent_indent = match[1].length;
-            }
-            break;
-          }
-          if (parent_idx !== -1)
-            break;
-        }
+  _resolve_block_style_path(segments, value) {
+    const lines = this._raw.split(`
+`);
+    let search_start = 0;
+    let search_end = lines.length;
+    for (let seg = 0;seg < segments.length - 1; seg++) {
+      const segment = segments[seg];
+      let parent_idx = -1;
+      let parent_indent = -1;
+      for (let i = search_start;i < search_end; i++) {
+        const match = lines[i].match(new RegExp(`^(\\s*)${escape_regex(segment)}:\\s*(.*)$`));
+        if (match) {
+          const trailing = match[2].trim();
+          if (trailing === "") {
+            parent_idx = i;
+            parent_indent = match[1].length;
+            break;
+          }
+          for (let j = i + 1;j < search_end; j++) {
+            if (lines[j].trim() === "")
+              continue;
+            const nextLeading = lines[j].match(/^(\s*)/);
+            if (nextLeading && nextLeading[1].length > match[1].length) {
+              parent_idx = i;
+              parent_indent = match[1].length;
+            }
+            break;
+          }
+          if (parent_idx !== -1)
+            break;
+        }
+      }
+      if (parent_idx === -1)
+        return null;
+      let child_indent = -1;
+      for (let i = parent_idx + 1;i < search_end; i++) {
+        if (lines[i].trim() === "")
+          continue;
+        const leading_spaces = lines[i].match(/^(\s*)/);
+        if (leading_spaces) {
+          const indent = leading_spaces[1].length;
+          if (indent > parent_indent) {
+            child_indent = indent;
+            break;
+          }
+        }
+        break;
+      }
+      if (child_indent === -1)
+        return null;
+      search_start = parent_idx + 1;
+      for (let i = parent_idx + 1;i < search_end; i++) {
+        if (lines[i].trim() === "")
+          continue;
+        const leading_spaces = lines[i].match(/^(\s*)/);
+        if (leading_spaces && leading_spaces[1].length < child_indent) {
+          search_end = i;
+          break;
+        }
+      }
+    }
+    const final_prop = segments[segments.length - 1];
+    for (let i = search_start;i < search_end; i++) {
+      const match = lines[i].match(new RegExp(`^(\\s*${escape_regex(final_prop)}:\\s*).+$`));
+      if (match) {
+        lines[i] = match[1] + value;
+        return lines.join(`
+`);
+      }
+    }
+    return null;
+  }
+}
+
+// src/editor/yaml-fields.ts
+var PRIMITIVE_DEFAULTS = {
+  int: "0",
+  float: "0",
+  double: "0",
+  bool: "0",
+  string: "",
+  byte: "0",
+  sbyte: "0",
+  short: "0",
+  ushort: "0",
+  uint: "0",
+  long: "0",
+  ulong: "0",
+  char: "0",
+  Int32: "0",
+  Single: "0",
+  Double: "0",
+  Boolean: "0",
+  String: "",
+  Byte: "0",
+  SByte: "0",
+  Int16: "0",
+  UInt16: "0",
+  UInt32: "0",
+  Int64: "0",
+  UInt64: "0",
+  Char: "0"
+};
+var STRUCT_DEFAULTS = {
+  Vector2: "{x: 0, y: 0}",
+  Vector3: "{x: 0, y: 0, z: 0}",
+  Vector4: "{x: 0, y: 0, z: 0, w: 0}",
+  Vector2Int: "{x: 0, y: 0}",
+  Vector3Int: "{x: 0, y: 0, z: 0}",
+  Quaternion: "{x: 0, y: 0, z: 0, w: 1}",
+  Color: "{r: 0, g: 0, b: 0, a: 0}",
+  Color32: "{r: 0, g: 0, b: 0, a: 0}",
+  Rect: `serializedVersion: 2
+    x: 0
+    y: 0
+    width: 0
+    height: 0`,
+  RectInt: "{x: 0, y: 0, width: 0, height: 0}",
+  RectOffset: "{m_Left: 0, m_Right: 0, m_Top: 0, m_Bottom: 0}",
+  Matrix4x4: "{e00: 1, e01: 0, e02: 0, e03: 0, e10: 0, e11: 1, e12: 0, e13: 0, e20: 0, e21: 0, e22: 1, e23: 0, e30: 0, e31: 0, e32: 0, e33: 1}",
+  LayerMask: `serializedVersion: 2
+    m_Bits: 0`
+};
+var VERSION_GATED_STRUCT_DEFAULTS = {
+  Hash128: { value: `serializedVersion: 2
+    Hash: 00000000000000000000000000000000`, min_major: 2021, min_minor: 1 },
+  RenderingLayerMask: { value: `serializedVersion: 2
+    m_Bits: 0`, min_major: 6000, min_minor: 0 }
+};
+var BLOCK_STRUCT_DEFAULTS = {
+  Bounds: `m_Center: {x: 0, y: 0, z: 0}
+    m_Extent: {x: 0, y: 0, z: 0}`,
+  BoundsInt: `m_Position: {x: 0, y: 0, z: 0}
+    m_Size: {x: 0, y: 0, z: 0}`
+};
+var OBJECT_REF_TYPES = new Set([
+  "GameObject",
+  "Transform",
+  "RectTransform",
+  "Material",
+  "Texture",
+  "Texture2D",
+  "Texture3D",
+  "RenderTexture",
+  "Sprite",
+  "AudioClip",
+  "VideoClip",
+  "Mesh",
+  "Shader",
+  "ComputeShader",
+  "AnimationClip",
+  "AnimatorController",
+  "RuntimeAnimatorController",
+  "PhysicMaterial",
+  "PhysicsMaterial",
+  "PhysicsMaterial2D",
+  "Font",
+  "TMP_FontAsset",
+  "Object",
+  "Component",
+  "Behaviour",
+  "MonoBehaviour",
+  "ScriptableObject",
+  "Rigidbody",
+  "Rigidbody2D",
+  "Collider",
+  "Collider2D",
+  "Camera",
+  "Light",
+  "Canvas",
+  "CanvasGroup",
+  "EventSystem",
+  "AudioSource",
+  "ParticleSystem",
+  "TextAsset",
+  "TerrainData"
+]);
+function version_at_least(version, min_major, min_minor) {
+  if (!version)
+    return false;
+  if (version.major > min_major)
+    return true;
+  if (version.major === min_major)
+    return version.minor >= min_minor;
+  return false;
+}
+function yaml_default_for_type(csharp_type, version) {
+  if (csharp_type.endsWith("?")) {
+    return null;
+  }
+  if (csharp_type in PRIMITIVE_DEFAULTS) {
+    return PRIMITIVE_DEFAULTS[csharp_type];
+  }
+  if (csharp_type in STRUCT_DEFAULTS) {
+    return STRUCT_DEFAULTS[csharp_type];
+  }
+  if (csharp_type in VERSION_GATED_STRUCT_DEFAULTS) {
+    const gated = VERSION_GATED_STRUCT_DEFAULTS[csharp_type];
+    if (version_at_least(version, gated.min_major, gated.min_minor)) {
+      return gated.value;
+    }
+    return null;
+  }
+  if (csharp_type in BLOCK_STRUCT_DEFAULTS) {
+    return BLOCK_STRUCT_DEFAULTS[csharp_type];
+  }
+  if (csharp_type.endsWith("[]")) {
+    return "[]";
+  }
+  if (csharp_type.startsWith("List<") && csharp_type.endsWith(">")) {
+    return "[]";
+  }
+  if (OBJECT_REF_TYPES.has(csharp_type)) {
+    return "{fileID: 0}";
+  }
+  return "{fileID: 0}";
+}
+function generate_field_yaml(fields, version, indent = "  ", type_lookup) {
+  const lines = [];
+  for (const field of fields) {
+    if (field.hasSerializeReference) {
+      const t = field.typeName;
+      if (t.endsWith("[]") || t.startsWith("List<") && t.endsWith(">")) {
+        lines.push(`${indent}${field.name}: []`);
+      } else {
+        lines.push(`${indent}${field.name}:`);
+        lines.push(`${indent}  rid: 0`);
       }
-      if (parent_idx === -1)
-        return null;
-      let child_indent = -1;
-      for (let i = parent_idx + 1;i < search_end; i++) {
-        if (lines[i].trim() === "")
-          continue;
-        const leading_spaces = lines[i].match(/^(\s*)/);
-        if (leading_spaces) {
-          const indent = leading_spaces[1].length;
-          if (indent > parent_indent) {
-            child_indent = indent;
-            break;
-          }
+      continue;
+    }
+    const default_value = yaml_default_for_type(field.typeName, version);
+    if (default_value === null) {
+      continue;
+    }
+    if (default_value === "{fileID: 0}" && type_lookup) {
+      const struct_fields = type_lookup(field.typeName);
+      if (struct_fields && struct_fields.length > 0) {
+        lines.push(`${indent}${field.name}:`);
+        const nested = generate_field_yaml(struct_fields, version, indent + "  ", type_lookup);
+        const nested_lines = nested.slice(1).replace(/\n$/, "").split(`
+`);
+        for (const nl of nested_lines) {
+          lines.push(nl);
         }
-        break;
+        continue;
       }
-      if (child_indent === -1)
-        return null;
-      search_start = parent_idx + 1;
-      for (let i = parent_idx + 1;i < search_end; i++) {
-        if (lines[i].trim() === "")
-          continue;
-        const leading_spaces = lines[i].match(/^(\s*)/);
-        if (leading_spaces && leading_spaces[1].length < child_indent) {
-          search_end = i;
-          break;
-        }
+    }
+    if (default_value.includes(`
+`)) {
+      lines.push(`${indent}${field.name}:`);
+      for (const sub_line of default_value.split(`
+`)) {
+        lines.push(`${indent}${sub_line}`);
       }
+    } else {
+      lines.push(`${indent}${field.name}: ${default_value}`);
     }
-    const final_prop = segments[segments.length - 1];
-    for (let i = search_start;i < search_end; i++) {
-      const match = lines[i].match(new RegExp(`^(\\s*${escape_regex(final_prop)}:\\s*).+$`));
-      if (match) {
-        lines[i] = match[1] + value;
-        return lines.join(`
-`);
+  }
+  return lines.length > 0 ? `
+` + lines.join(`
+`) + `
+` : `
+`;
+}
+function json_value_to_yaml_lines(value, indent = "  ") {
+  if (value === null || value === undefined) {
+    return [""];
+  }
+  if (typeof value === "string") {
+    return [yaml_quote_if_needed(value)];
+  }
+  if (typeof value === "number" || typeof value === "boolean") {
+    return [String(value)];
+  }
+  if (Array.isArray(value)) {
+    if (value.length === 0)
+      return ["[]"];
+    const lines = [];
+    for (const item of value) {
+      if (is_scalar(item) || is_empty_collection(item)) {
+        const scalar = json_value_to_yaml_lines(item);
+        lines.push(`${indent}- ${scalar[0]}`);
+      } else if (is_flow_mappable(item)) {
+        lines.push(`${indent}- ${to_flow_mapping(item)}`);
+      } else {
+        const child_lines = json_value_to_yaml_lines(item, indent + "  ");
+        lines.push(`${indent}- ${child_lines[0].trimStart()}`);
+        for (let i = 1;i < child_lines.length; i++) {
+          lines.push(child_lines[i]);
+        }
+      }
+    }
+    return lines;
+  }
+  if (typeof value === "object") {
+    const entries = Object.entries(value);
+    if (entries.length === 0)
+      return ["{}"];
+    const lines = [];
+    for (const [key, val] of entries) {
+      if (is_scalar(val) || is_empty_collection(val)) {
+        const scalar = json_value_to_yaml_lines(val);
+        lines.push(`${indent}${key}: ${scalar[0]}`);
+      } else if (is_flow_mappable(val)) {
+        lines.push(`${indent}${key}: ${to_flow_mapping(val)}`);
+      } else {
+        const child_indent = Array.isArray(val) ? indent : indent + "  ";
+        lines.push(`${indent}${key}:`);
+        const child_lines = json_value_to_yaml_lines(val, child_indent);
+        for (const cl of child_lines) {
+          lines.push(cl);
+        }
       }
     }
-    return null;
+    return lines;
   }
+  return [String(value)];
+}
+function is_scalar(value) {
+  return value === null || value === undefined || typeof value === "string" || typeof value === "number" || typeof value === "boolean";
+}
+function is_empty_collection(value) {
+  if (Array.isArray(value))
+    return value.length === 0;
+  if (typeof value === "object" && value !== null)
+    return Object.keys(value).length === 0;
+  return false;
+}
+function is_flow_mappable(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value))
+    return false;
+  const entries = Object.entries(value);
+  if (entries.length === 0)
+    return false;
+  return entries.every(([, v]) => is_scalar(v) || is_empty_collection(v));
+}
+function to_flow_mapping(obj) {
+  const parts = Object.entries(obj).map(([k, v]) => {
+    if (v === null || v === undefined)
+      return `${k}: `;
+    if (typeof v === "string")
+      return `${k}: ${yaml_quote_if_needed(v)}`;
+    if (Array.isArray(v) && v.length === 0)
+      return `${k}: []`;
+    if (typeof v === "object" && v !== null && Object.keys(v).length === 0)
+      return `${k}: {}`;
+    return `${k}: ${String(v)}`;
+  });
+  return `{${parts.join(", ")}}`;
 }
 
 // src/editor/unity-document.ts
+var import_fs7 = require("fs");
 class UnityDocument {
   file_path;
   _header;
@@ -5085,8 +5267,8 @@ function addComponentToGameObject(doc, gameObjectId, componentId) {
 `);
   goBlock.replace_raw(raw);
 }
-function createMonoBehaviourYAML(componentId, gameObjectId, scriptGuid, fields, version, scriptFileId = 11500000) {
-  const field_yaml = fields && fields.length > 0 ? generate_field_yaml(fields, version) : `
+function createMonoBehaviourYAML(componentId, gameObjectId, scriptGuid, fields, version, scriptFileId = 11500000, type_lookup) {
+  const field_yaml = fields && fields.length > 0 ? generate_field_yaml(fields, version, "  ", type_lookup) : `
 `;
   const has_serialize_ref = fields?.some((f) => f.hasSerializeReference) ?? false;
   const references_section = has_serialize_ref ? `  references:
@@ -5744,6 +5926,170 @@ PrefabImporter:
     prefab_instance_id: prefabInstanceId
   };
 }
+function createPrefabInstance(options) {
+  const { scene_path, prefab_path, name, parent, position } = options;
+  const pathError = validate_file_path(scene_path, "write");
+  if (pathError) {
+    return { success: false, file_path: scene_path, error: pathError };
+  }
+  if (!scene_path.endsWith(".unity")) {
+    return { success: false, file_path: scene_path, error: "Scene path must be a .unity file" };
+  }
+  if (!prefab_path.endsWith(".prefab")) {
+    return { success: false, file_path: scene_path, error: "Prefab path must be a .prefab file" };
+  }
+  if (!import_fs8.existsSync(scene_path)) {
+    return { success: false, file_path: scene_path, error: `Scene file not found: ${scene_path}` };
+  }
+  if (!import_fs8.existsSync(prefab_path)) {
+    return { success: false, file_path: scene_path, error: `Prefab file not found: ${prefab_path}` };
+  }
+  const metaPath = prefab_path + ".meta";
+  const sourceGuid = extractGuidFromMeta(metaPath);
+  if (!sourceGuid) {
+    return { success: false, file_path: scene_path, error: `Could not find or read .meta file for prefab: ${metaPath}` };
+  }
+  let prefabDoc;
+  try {
+    prefabDoc = UnityDocument.from_file(prefab_path);
+  } catch (err) {
+    return { success: false, file_path: scene_path, error: `Failed to read prefab: ${err instanceof Error ? err.message : String(err)}` };
+  }
+  const rootInfo = prefabDoc.find_prefab_root();
+  if (!rootInfo) {
+    return { success: false, file_path: scene_path, error: "Could not find root GameObject in source prefab" };
+  }
+  let doc;
+  try {
+    doc = UnityDocument.from_file(scene_path);
+  } catch (err) {
+    return { success: false, file_path: scene_path, error: `Failed to read scene: ${err instanceof Error ? err.message : String(err)}` };
+  }
+  let parentTransformIdStr = "0";
+  if (parent !== undefined) {
+    if (typeof parent === "number") {
+      const parentIdStr = String(parent);
+      const parentBlock = doc.find_by_file_id(parentIdStr);
+      if (!parentBlock) {
+        return { success: false, file_path: scene_path, error: `Parent with fileID ${parent} not found. Provide a GameObject or Transform fileID.` };
+      }
+      if (parentBlock.is_stripped) {
+        return { success: false, file_path: scene_path, error: `Parent with fileID ${parent} is a stripped block (inside a PrefabInstance). Cannot parent to stripped transforms.` };
+      }
+      if (parentBlock.class_id === 4) {
+        parentTransformIdStr = parentIdStr;
+      } else if (parentBlock.class_id === 1) {
+        const compMatch = parentBlock.raw.match(/m_Component:\s*\n\s*-\s*component:\s*\{fileID:\s*(\d+)\}/);
+        if (compMatch) {
+          parentTransformIdStr = compMatch[1];
+        } else {
+          return { success: false, file_path: scene_path, error: `Parent with fileID ${parent} has no Transform component.` };
+        }
+      } else {
+        return { success: false, file_path: scene_path, error: `Parent with fileID ${parent} is not a GameObject or Transform.` };
+      }
+    } else {
+      const foundResult = findTransformIdByName(doc, parent);
+      if (foundResult === null) {
+        return { success: false, file_path: scene_path, error: `Parent GameObject "${parent}" not found` };
+      }
+      if (typeof foundResult === "object") {
+        return { success: false, file_path: scene_path, error: foundResult.error };
+      }
+      parentTransformIdStr = foundResult;
+    }
+  }
+  const prefabInstanceId = doc.generate_file_id();
+  const strippedGoId = doc.generate_file_id();
+  const strippedTransformId = doc.generate_file_id();
+  const instanceName = name || path3.basename(prefab_path, ".prefab");
+  const pos = position ?? { x: 0, y: 0, z: 0 };
+  const rootGoFileId = rootInfo.game_object.file_id;
+  const rootTransformFileId = rootInfo.transform.file_id;
+  const yaml = `--- !u!1 &${strippedGoId} stripped
+GameObject:
+  m_CorrespondingSourceObject: {fileID: ${rootGoFileId}, guid: ${sourceGuid}, type: 3}
+  m_PrefabInstance: {fileID: ${prefabInstanceId}}
+  m_PrefabAsset: {fileID: 0}
+--- !u!4 &${strippedTransformId} stripped
+Transform:
+  m_CorrespondingSourceObject: {fileID: ${rootTransformFileId}, guid: ${sourceGuid}, type: 3}
+  m_PrefabInstance: {fileID: ${prefabInstanceId}}
+  m_PrefabAsset: {fileID: 0}
+--- !u!1001 &${prefabInstanceId}
+PrefabInstance:
+  m_ObjectHideFlags: 0
+  serializedVersion: 2
+  m_Modification:
+    m_TransformParent: {fileID: ${parentTransformIdStr}}
+    m_Modifications:
+    - target: {fileID: ${rootGoFileId}, guid: ${sourceGuid}, type: 3}
+      propertyPath: m_Name
+      value: ${instanceName}
+      objectReference: {fileID: 0}
+    - target: {fileID: ${rootTransformFileId}, guid: ${sourceGuid}, type: 3}
+      propertyPath: m_LocalPosition.x
+      value: ${pos.x}
+      objectReference: {fileID: 0}
+    - target: {fileID: ${rootTransformFileId}, guid: ${sourceGuid}, type: 3}
+      propertyPath: m_LocalPosition.y
+      value: ${pos.y}
+      objectReference: {fileID: 0}
+    - target: {fileID: ${rootTransformFileId}, guid: ${sourceGuid}, type: 3}
+      propertyPath: m_LocalPosition.z
+      value: ${pos.z}
+      objectReference: {fileID: 0}
+    - target: {fileID: ${rootTransformFileId}, guid: ${sourceGuid}, type: 3}
+      propertyPath: m_LocalRotation.w
+      value: 1
+      objectReference: {fileID: 0}
+    - target: {fileID: ${rootTransformFileId}, guid: ${sourceGuid}, type: 3}
+      propertyPath: m_LocalRotation.x
+      value: 0
+      objectReference: {fileID: 0}
+    - target: {fileID: ${rootTransformFileId}, guid: ${sourceGuid}, type: 3}
+      propertyPath: m_LocalRotation.y
+      value: 0
+      objectReference: {fileID: 0}
+    - target: {fileID: ${rootTransformFileId}, guid: ${sourceGuid}, type: 3}
+      propertyPath: m_LocalRotation.z
+      value: 0
+      objectReference: {fileID: 0}
+    - target: {fileID: ${rootTransformFileId}, guid: ${sourceGuid}, type: 3}
+      propertyPath: m_LocalEulerAnglesHint.x
+      value: 0
+      objectReference: {fileID: 0}
+    - target: {fileID: ${rootTransformFileId}, guid: ${sourceGuid}, type: 3}
+      propertyPath: m_LocalEulerAnglesHint.y
+      value: 0
+      objectReference: {fileID: 0}
+    - target: {fileID: ${rootTransformFileId}, guid: ${sourceGuid}, type: 3}
+      propertyPath: m_LocalEulerAnglesHint.z
+      value: 0
+      objectReference: {fileID: 0}
+    m_RemovedComponents: []
+    m_RemovedGameObjects: []
+    m_AddedGameObjects: []
+    m_AddedComponents: []
+  m_SourcePrefab: {fileID: 100100000, guid: ${sourceGuid}, type: 3}
+`;
+  doc.append_raw(yaml);
+  if (parentTransformIdStr !== "0") {
+    doc.add_child_to_parent(parentTransformIdStr, strippedTransformId);
+  }
+  try {
+    doc.save();
+  } catch (err) {
+    return { success: false, file_path: scene_path, error: `Failed to save scene: ${err instanceof Error ? err.message : String(err)}` };
+  }
+  return {
+    success: true,
+    file_path: scene_path,
+    prefab_instance_id: prefabInstanceId,
+    game_object_id: strippedGoId,
+    transform_id: strippedTransformId
+  };
+}
 function createScriptableObject(options) {
   const { output_path, script } = options;
   const project_path = options.project_path || find_unity_project_root(path3.dirname(output_path)) || undefined;
@@ -5789,7 +6135,8 @@ function createScriptableObject(options) {
     } catch {}
   }
   const baseName = path3.basename(output_path, ".asset");
-  const field_yaml = resolved.fields && resolved.fields.length > 0 ? generate_field_yaml(resolved.fields, version) : `
+  const type_lookup = project_path ? build_type_lookup(project_path) : undefined;
+  const field_yaml = resolved.fields && resolved.fields.length > 0 ? generate_field_yaml(resolved.fields, version, "  ", type_lookup) : `
 `;
   let assetYaml = `%YAML 1.1
 %TAG !u! tag:unity3d.com,2011:
@@ -5809,8 +6156,58 @@ MonoBehaviour:
     const doc = UnityDocument.from_string(assetYaml);
     const block = doc.blocks[0];
     if (block) {
+      const complex_entries = [];
       for (const [key, val] of Object.entries(options.initial_values)) {
-        block.set_property(key, val);
+        if (val === null || val === undefined || typeof val === "string" || typeof val === "number" || typeof val === "boolean") {
+          block.set_property(key, String(val ?? ""));
+        } else if (Array.isArray(val) && val.length === 0) {
+          block.set_property(key, "[]");
+        } else if (typeof val === "object" && val !== null && !Array.isArray(val) && Object.keys(val).length === 0) {
+          block.set_property(key, "{}");
+        } else {
+          complex_entries.push([key, val]);
+        }
+      }
+      if (complex_entries.length > 0) {
+        let raw = block.raw;
+        for (const [key, val] of complex_entries) {
+          const yaml_lines = json_value_to_yaml_lines(val, "    ");
+          const key_pattern = new RegExp(`^([ \\t]*${key}:)[^\\n]*$`, "m");
+          const key_match = raw.match(key_pattern);
+          if (key_match && key_match.index !== undefined) {
+            const key_indent = key_match[0].match(/^[ \t]*/)?.[0].length ?? 0;
+            const after_key = key_match.index + key_match[0].length;
+            let end = after_key;
+            const remaining = raw.slice(after_key);
+            const remaining_lines = remaining.split(`
+`);
+            for (let i = 1;i < remaining_lines.length; i++) {
+              const line = remaining_lines[i];
+              if (line.trim() === "") {
+                end += 1 + line.length;
+                continue;
+              }
+              const line_indent = line.match(/^[ \t]*/)?.[0].length ?? 0;
+              if (line_indent > key_indent) {
+                end += 1 + line.length;
+              } else {
+                break;
+              }
+            }
+            const block_yaml = `  ${key}:
+${yaml_lines.join(`
+`)}`;
+            raw = raw.slice(0, key_match.index) + block_yaml + raw.slice(end);
+          } else {
+            const block_yaml = `  ${key}:
+${yaml_lines.join(`
+`)}`;
+            raw = raw.trimEnd() + `
+` + block_yaml + `
+`;
+          }
+        }
+        block.replace_raw(raw);
       }
       assetYaml = doc.serialize();
     }
@@ -6083,7 +6480,8 @@ function addComponent(options) {
     if (resolved.path?.endsWith(".dll") && resolved.class_name) {
       scriptFileId = compute_dll_script_file_id(resolved.namespace ?? "", resolved.class_name);
     }
-    componentYAML = createMonoBehaviourYAML(componentId, gameObjectId, resolved.guid, resolved.fields, version, scriptFileId);
+    const type_lookup_comp = project_path ? build_type_lookup(project_path) : undefined;
+    componentYAML = createMonoBehaviourYAML(componentId, gameObjectId, resolved.guid, resolved.fields, version, scriptFileId, type_lookup_comp);
     scriptGuid = resolved.guid;
     scriptPath = resolved.path || undefined;
     extractionError = resolved.extraction_error;
@@ -8150,11 +8548,15 @@ function applyManagedReference(doc, block, file_path, field_path, typeInfo, appe
   const refEntry = `    - rid: ${nextRid}
       type: {class: ${typeInfo.class_name}, ns: ${typeInfo.namespace}, asm: ${typeInfo.assembly}}
       data: ${dataBlock}`;
-  const refIdsPattern = /(\s*RefIds:\s*\n)/;
+  const refIdsBlockPattern = /(\s*RefIds:\s*\n)/;
+  const refIdsEmptyPattern = /(\s*RefIds:)[ \t]*\[\]/;
   const referencesPattern = /(\s*references:\s*\n\s*version:\s*\d+\s*\n)/;
-  if (refIdsPattern.test(raw)) {
-    raw = raw.replace(refIdsPattern, `$1${refEntry}
+  if (refIdsBlockPattern.test(raw)) {
+    raw = raw.replace(refIdsBlockPattern, `$1${refEntry}
 `);
+  } else if (refIdsEmptyPattern.test(raw)) {
+    raw = raw.replace(refIdsEmptyPattern, `$1
+${refEntry}`);
   } else if (referencesPattern.test(raw)) {
     raw = raw.replace(referencesPattern, `$1    RefIds:
 ${refEntry}
@@ -8167,8 +8569,23 @@ ${refEntry}
 ${refEntry}
 `;
   }
-  if (!append) {
-    const fieldRidPattern = new RegExp(`(${field_path.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}:\\s*\\n\\s*rid:[ \\t]*)\\d+`, "m");
+  const escaped_field = field_path.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  if (append) {
+    const fieldLineMatch = raw.match(new RegExp(`^([ \\t]*)${escaped_field}:`, "m"));
+    const fieldIndent = fieldLineMatch ? fieldLineMatch[1] : "  ";
+    const ridEntry = `
+${fieldIndent}  - rid: ${nextRid}`;
+    const emptyArrayPattern = new RegExp(`(${escaped_field}:)[ \\t]*\\[\\]`, "m");
+    if (emptyArrayPattern.test(raw)) {
+      raw = raw.replace(emptyArrayPattern, `$1${ridEntry}`);
+    } else {
+      const lastRidPattern = new RegExp(`(^[ \\t]*${escaped_field}:[\\s\\S]*?- rid: \\d+)`, "m");
+      if (lastRidPattern.test(raw)) {
+        raw = raw.replace(lastRidPattern, `$1${ridEntry}`);
+      }
+    }
+  } else {
+    const fieldRidPattern = new RegExp(`(${escaped_field}:\\s*\\n\\s*rid:[ \\t]*)\\d+`, "m");
     if (fieldRidPattern.test(raw)) {
       raw = raw.replace(fieldRidPattern, `$1${nextRid}`);
     }
@@ -9297,6 +9714,36 @@ function build_create_command() {
     if (!result.success)
       process.exitCode = 1;
   });
+  cmd.command("prefab-instance <scene_file> <prefab_path>").description("Instantiate a prefab into a scene file").option("-n, --name <name>", "Instance name (defaults to prefab filename)").option("-p, --parent <name|id>", "Parent GameObject name or Transform fileID").option("--position <x,y,z>", "Local position (default: 0,0,0)").option("-j, --json", "Output as JSON").action((scene_file, prefab_path_arg, options) => {
+    let position;
+    if (options.position) {
+      const parts = options.position.split(",").map(Number);
+      if (parts.length !== 3 || parts.some(isNaN)) {
+        console.log(JSON.stringify({
+          success: false,
+          error: "--position must be three comma-separated numbers, e.g. 1,2,3"
+        }, null, 2));
+        process.exitCode = 1;
+        return;
+      }
+      position = { x: parts[0], y: parts[1], z: parts[2] };
+    }
+    let parent;
+    if (options.parent) {
+      const asNumber = parseInt(options.parent, 10);
+      parent = isNaN(asNumber) ? options.parent : asNumber;
+    }
+    const result = createPrefabInstance({
+      scene_path: scene_file,
+      prefab_path: prefab_path_arg,
+      name: options.name,
+      parent,
+      position
+    });
+    console.log(JSON.stringify(result, null, 2));
+    if (!result.success)
+      process.exitCode = 1;
+  });
   cmd.command("scriptable-object <output_path> <script>").description("Create a new ScriptableObject .asset file").option("-p, --project <path>", "Unity project path (for script GUID lookup)").option("--set <json>", `Initial field values as JSON object (e.g. '{"damage": "10", "targetScope": "1"}')`).option("-j, --json", "Output as JSON").action((output_path, script, options) => {
     let initial_values;
     if (options.set) {