Add brush migration logic in migrateSceneDocument

src/document/migrate-scene-document.ts

@@ -1,4 +1,10 @@
-import { SCENE_DOCUMENT_VERSION, type SceneDocument, type WorldSettings } from "./scene-document";
+import { BOX_FACE_IDS, createBoxBrush, isBoxFaceId, type BoxBrushFaces, type BrushFace } from "./brushes";
+import {
+  FOUNDATION_SCENE_DOCUMENT_VERSION,
+  SCENE_DOCUMENT_VERSION,
+  type SceneDocument,
+  type WorldSettings
+} from "./scene-document";
 
 function isRecord(value: unknown): value is Record<string, unknown> {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -50,6 +56,99 @@ function expectEmptyCollection(value: unknown, label: string): Record<string, ne
   return {};
 }
 
+function expectOptionalString(value: unknown, label: string): string | undefined {
+  if (value === undefined) {
+    return undefined;
+  }
+
+  return expectString(value, label);
+}
+
+function expectBrushFace(value: unknown, label: string): BrushFace {
+  if (!isRecord(value)) {
+    throw new Error(`${label} must be an object.`);
+  }
+
+  const materialId = value.materialId;
+
+  if (materialId !== null && materialId !== undefined && typeof materialId !== "string") {
+    throw new Error(`${label}.materialId must be a string or null.`);
+  }
+
+  return {
+    materialId: materialId ?? null
+  };
+}
+
+function readVec3(value: unknown, label: string) {
+  if (!isRecord(value)) {
+    throw new Error(`${label} must be an object.`);
+  }
+
+  return {
+    x: expectFiniteNumber(value.x, `${label}.x`),
+    y: expectFiniteNumber(value.y, `${label}.y`),
+    z: expectFiniteNumber(value.z, `${label}.z`)
+  };
+}
+
+function readBoxBrushFaces(value: unknown, label: string): BoxBrushFaces {
+  if (!isRecord(value)) {
+    throw new Error(`${label} must be an object.`);
+  }
+
+  const extraFaceKeys = Object.keys(value).filter((faceId) => !isBoxFaceId(faceId));
+
+  if (extraFaceKeys.length > 0) {
+    throw new Error(`${label} contains unsupported face ids: ${extraFaceKeys.join(", ")}.`);
+  }
+
+  return {
+    posX: expectBrushFace(value.posX, `${label}.posX`),
+    negX: expectBrushFace(value.negX, `${label}.negX`),
+    posY: expectBrushFace(value.posY, `${label}.posY`),
+    negY: expectBrushFace(value.negY, `${label}.negY`),
+    posZ: expectBrushFace(value.posZ, `${label}.posZ`),
+    negZ: expectBrushFace(value.negZ, `${label}.negZ`)
+  };
+}
+
+function readBrushes(value: unknown): SceneDocument["brushes"] {
+  if (!isRecord(value)) {
+    throw new Error("brushes must be a record.");
+  }
+
+  const brushes: SceneDocument["brushes"] = {};
+
+  for (const [brushId, brushValue] of Object.entries(value)) {
+    if (!isRecord(brushValue)) {
+      throw new Error(`brushes.${brushId} must be an object.`);
+    }
+
+    if (brushValue.kind !== "box") {
+      throw new Error(`brushes.${brushId}.kind must be box.`);
+    }
+
+    const center = readVec3(brushValue.center, `brushes.${brushId}.center`);
+    const size = readVec3(brushValue.size, `brushes.${brushId}.size`);
+
+    if (size.x <= 0 || size.y <= 0 || size.z <= 0) {
+      throw new Error(`brushes.${brushId}.size values must be positive.`);
+    }
+
+    brushes[brushId] = createBoxBrush({
+      id: expectString(brushValue.id, `brushes.${brushId}.id`),
+      center,
+      size,
+      faces: readBoxBrushFaces(brushValue.faces, `brushes.${brushId}.faces`),
+      layerId: expectOptionalString(brushValue.layerId, `brushes.${brushId}.layerId`),
+      groupId: expectOptionalString(brushValue.groupId, `brushes.${brushId}.groupId`)
+    });
+  }
+
+  return brushes;
+}
+
 function readWorldSettings(value: unknown): WorldSettings {
   if (!isRecord(value)) {
     throw new Error("world must be an object.");
@@ -103,6 +202,21 @@ export function migrateSceneDocument(source: unknown): SceneDocument {
     throw new Error("Scene document must be a JSON object.");
   }
 
+  if (source.version === FOUNDATION_SCENE_DOCUMENT_VERSION) {
+    return {
+      version: SCENE_DOCUMENT_VERSION,
+      name: expectString(source.name, "name"),
+      world: readWorldSettings(source.world),
+      materials: expectEmptyCollection(source.materials, "materials"),
+      textures: expectEmptyCollection(source.textures, "textures"),
+      assets: expectEmptyCollection(source.assets, "assets"),
+      brushes: {},
+      modelInstances: expectEmptyCollection(source.modelInstances, "modelInstances"),
+      entities: expectEmptyCollection(source.entities, "entities"),
+      interactionLinks: expectEmptyCollection(source.interactionLinks, "interactionLinks")
+    };
+  }
+
   if (source.version !== SCENE_DOCUMENT_VERSION) {
     throw new Error(`Unsupported scene document version: ${String(source.version)}.`);
   }
@@ -114,7 +228,7 @@ export function migrateSceneDocument(source: unknown): SceneDocument {
     materials: expectEmptyCollection(source.materials, "materials"),
     textures: expectEmptyCollection(source.textures, "textures"),
     assets: expectEmptyCollection(source.assets, "assets"),
-    brushes: expectEmptyCollection(source.brushes, "brushes"),
+    brushes: readBrushes(source.brushes),
     modelInstances: expectEmptyCollection(source.modelInstances, "modelInstances"),
     entities: expectEmptyCollection(source.entities, "entities"),
     interactionLinks: expectEmptyCollection(source.interactionLinks, "interactionLinks")