Function loadPrefab

src/world/prefab.ts:71–90

(path: string)

// Load a single prefab file from disk, validate, migrate, and return it.
// Throws on parse or validation error.
export function loadPrefab(path: string): PrefabData {
  const text = readFile(path);
  if (!text || text.length === 0) {
    throw new Error('loadPrefab: file is empty or missing: ' + path);
  }

  let raw: PrefabData;
  try {
    raw = JSON.parse(text) as PrefabData;
  } catch (e) {
    throw new Error('loadPrefab: invalid JSON in ' + path + ': ' + (e as Error).message);
  }

  const migrated = migratePrefabData(raw);
  const check = validatePrefab(migrated);
  if (!check.ok) {
    throw new Error('loadPrefab: ' + path + '\n' + formatValidationErrors(check.errors));
  }
  return migrated;
}

// Recursively flatten a prefab into its leaf glb placements.
//