wadi-mcp 0.1.31 → 0.1.32

package/dist/server.mjs

@@ -14927,12 +14927,12 @@ var init_util = __esm({
 function flattenError2(error53, mapper = (issue3) => issue3.message) {
   const fieldErrors = {};
   const formErrors = [];
-  for (const sub of error53.issues) {
-    if (sub.path.length > 0) {
-      fieldErrors[sub.path[0]] = fieldErrors[sub.path[0]] || [];
-      fieldErrors[sub.path[0]].push(mapper(sub));
+  for (const sub2 of error53.issues) {
+    if (sub2.path.length > 0) {
+      fieldErrors[sub2.path[0]] = fieldErrors[sub2.path[0]] || [];
+      fieldErrors[sub2.path[0]].push(mapper(sub2));
     } else {
-      formErrors.push(mapper(sub));
+      formErrors.push(mapper(sub2));
     }
   }
   return { formErrors, fieldErrors };
@@ -25307,13 +25307,13 @@ function _promise(Class3, innerType) {
 }
 // @__NO_SIDE_EFFECTS__
 function _custom2(Class3, fn, _params) {
-  const norm = normalizeParams2(_params);
-  norm.abort ?? (norm.abort = true);
+  const norm2 = normalizeParams2(_params);
+  norm2.abort ?? (norm2.abort = true);
   const schema = new Class3({
     type: "custom",
     check: "custom",
     fn,
-    ...norm
+    ...norm2
   });
   return schema;
 }
@@ -29624,7 +29624,20 @@ var init_houseConfig = __esm({
       rise_height: positive().optional(),
       step_rise: positive(),
       step_tread: positive(),
-      step_width: positive(),
+      // BOX MODEL (preferred): give a `width` (X) × `length` (Y) rectangle and the
+      // WHOLE staircase — flights + turn landings — is packed to fit INSIDE it.
+      // (start_x,start_y) is then the box's min corner, NOT the first step, and each
+      // flight's width is DERIVED from the box: two switchback lanes =
+      // (lateral − flight_gap)/2, or the full box for a single flight. `direction`
+      // picks the run axis (N/S → run along length/Y; E/W → run along width/X). The
+      // model errors if the box is too small for even the tightest split. Omit both
+      // to use the legacy `step_width` + `max_run` form below.
+      width: positive().optional(),
+      length: positive().optional(),
+      // Legacy per-step width (required by the old form; derived from the box in the
+      // box model). The expanded single-flight staircases the renderer consumes always
+      // carry it.
+      step_width: positive().optional(),
       // The direction the stair EXTENDS from its top — the whole assembly fills the
       // allocated box from (start_x,start_y) going this way for up to `max_run`.
       direction: side,
@@ -95426,7 +95439,7 @@ var require_three = __commonJS({
        * @param {Color} cross - The cross line color.
        * @return {CameraHelper} A reference to this helper.
        */
-      setColors(frustum, cone, up, target, cross) {
+      setColors(frustum, cone, up, target, cross2) {
         const geometry = this.geometry;
         const colorAttribute = geometry.getAttribute("color");
         colorAttribute.setXYZ(0, frustum.r, frustum.g, frustum.b);
@@ -95469,16 +95482,16 @@ var require_three = __commonJS({
         colorAttribute.setXYZ(37, up.r, up.g, up.b);
         colorAttribute.setXYZ(38, target.r, target.g, target.b);
         colorAttribute.setXYZ(39, target.r, target.g, target.b);
-        colorAttribute.setXYZ(40, cross.r, cross.g, cross.b);
-        colorAttribute.setXYZ(41, cross.r, cross.g, cross.b);
-        colorAttribute.setXYZ(42, cross.r, cross.g, cross.b);
-        colorAttribute.setXYZ(43, cross.r, cross.g, cross.b);
-        colorAttribute.setXYZ(44, cross.r, cross.g, cross.b);
-        colorAttribute.setXYZ(45, cross.r, cross.g, cross.b);
-        colorAttribute.setXYZ(46, cross.r, cross.g, cross.b);
-        colorAttribute.setXYZ(47, cross.r, cross.g, cross.b);
-        colorAttribute.setXYZ(48, cross.r, cross.g, cross.b);
-        colorAttribute.setXYZ(49, cross.r, cross.g, cross.b);
+        colorAttribute.setXYZ(40, cross2.r, cross2.g, cross2.b);
+        colorAttribute.setXYZ(41, cross2.r, cross2.g, cross2.b);
+        colorAttribute.setXYZ(42, cross2.r, cross2.g, cross2.b);
+        colorAttribute.setXYZ(43, cross2.r, cross2.g, cross2.b);
+        colorAttribute.setXYZ(44, cross2.r, cross2.g, cross2.b);
+        colorAttribute.setXYZ(45, cross2.r, cross2.g, cross2.b);
+        colorAttribute.setXYZ(46, cross2.r, cross2.g, cross2.b);
+        colorAttribute.setXYZ(47, cross2.r, cross2.g, cross2.b);
+        colorAttribute.setXYZ(48, cross2.r, cross2.g, cross2.b);
+        colorAttribute.setXYZ(49, cross2.r, cross2.g, cross2.b);
         colorAttribute.needsUpdate = true;
         return this;
       }
@@ -116060,11 +116073,11 @@ No matching component was found for:
       return reconciler.flushSyncFromReconciler(fn);
     }
     function createSubs(callback, subs) {
-      const sub = {
+      const sub2 = {
         callback
       };
-      subs.add(sub);
-      return () => void subs.delete(sub);
+      subs.add(sub2);
+      return () => void subs.delete(sub2);
     }
     var globalEffects = /* @__PURE__ */ new Set();
     var globalAfterEffects = /* @__PURE__ */ new Set();
@@ -131121,11 +131134,11 @@ No matching component was found for:
       return reconciler.flushSyncFromReconciler(fn);
     }
     function createSubs(callback, subs) {
-      const sub = {
+      const sub2 = {
         callback
       };
-      subs.add(sub);
-      return () => void subs.delete(sub);
+      subs.add(sub2);
+      return () => void subs.delete(sub2);
     }
     var globalEffects = /* @__PURE__ */ new Set();
     var globalAfterEffects = /* @__PURE__ */ new Set();
@@ -134039,8 +134052,8 @@ var require_triangle_9e5a8229_cjs_prod = __commonJS({
       if (arePointsCollinear(points)) return false;
       var p2p1 = mv1.subVectors(p2, p1);
       var p3p1 = mv2.subVectors(p3, p1);
-      var cross = p3p1.cross(p2p1);
-      return cross > 0;
+      var cross2 = p3p1.cross(p2p1);
+      return cross2 > 0;
     }
     var triangle = /* @__PURE__ */ Object.freeze({
       __proto__: null,
@@ -134292,7 +134305,7 @@ var require_vector2_49e42f03_cjs_prod = __commonJS({
     function addValue(a, n3) {
       return [a[0] + n3, a[1] + n3];
     }
-    function sub(a, b) {
+    function sub2(a, b) {
       return [a[0] - b[0], a[1] - b[1]];
     }
     function subValue(a, n3) {
@@ -134319,7 +134332,7 @@ var require_vector2_49e42f03_cjs_prod = __commonJS({
       one,
       add,
       addValue,
-      sub,
+      sub: sub2,
       subValue,
       scale,
       dot: dot2,
@@ -134335,7 +134348,7 @@ var require_vector2_49e42f03_cjs_prod = __commonJS({
     exports2.lengthSqr = lengthSqr;
     exports2.one = one;
     exports2.scale = scale;
-    exports2.sub = sub;
+    exports2.sub = sub2;
     exports2.subValue = subValue;
     exports2.vector2 = vector2;
     exports2.zero = zero;
@@ -134358,7 +134371,7 @@ var require_vector3_4bbdb053_cjs_prod = __commonJS({
     function addValue(a, n3) {
       return [a[0] + n3, a[1] + n3, a[2] + n3];
     }
-    function sub(a, b) {
+    function sub2(a, b) {
       return [a[0] - b[0], a[1] - b[1], a[2] - b[2]];
     }
     function subValue(a, n3) {
@@ -134370,7 +134383,7 @@ var require_vector3_4bbdb053_cjs_prod = __commonJS({
     function dot2(a, b) {
       return a[0] * b[0] + a[1] * b[1] + a[2] * b[2];
     }
-    function cross(a, b) {
+    function cross2(a, b) {
       var x = a[1] * b[2] - a[2] * b[1];
       var y = a[2] * b[0] - a[0] * b[2];
       var z2 = a[0] * b[1] - a[1] * b[0];
@@ -134391,25 +134404,25 @@ var require_vector3_4bbdb053_cjs_prod = __commonJS({
       one,
       add,
       addValue,
-      sub,
+      sub: sub2,
       subValue,
       scale,
       dot: dot2,
-      cross,
+      cross: cross2,
       lengthSqr,
       length,
       distance
     });
     exports2.add = add;
     exports2.addValue = addValue;
-    exports2.cross = cross;
+    exports2.cross = cross2;
     exports2.distance = distance;
     exports2.dot = dot2;
     exports2.length = length;
     exports2.lengthSqr = lengthSqr;
     exports2.one = one;
     exports2.scale = scale;
-    exports2.sub = sub;
+    exports2.sub = sub2;
     exports2.subValue = subValue;
     exports2.vector3 = vector3;
     exports2.zero = zero;
@@ -136124,8 +136137,8 @@ var require_triangle_33ffdfef_cjs_dev = __commonJS({
       if (arePointsCollinear(points)) return false;
       var p2p1 = mv1.subVectors(p2, p1);
       var p3p1 = mv2.subVectors(p3, p1);
-      var cross = p3p1.cross(p2p1);
-      return cross > 0;
+      var cross2 = p3p1.cross(p2p1);
+      return cross2 > 0;
     }
     var triangle = /* @__PURE__ */ Object.freeze({
       __proto__: null,
@@ -136377,7 +136390,7 @@ var require_vector2_f44fd63e_cjs_dev = __commonJS({
     function addValue(a, n3) {
       return [a[0] + n3, a[1] + n3];
     }
-    function sub(a, b) {
+    function sub2(a, b) {
       return [a[0] - b[0], a[1] - b[1]];
     }
     function subValue(a, n3) {
@@ -136404,7 +136417,7 @@ var require_vector2_f44fd63e_cjs_dev = __commonJS({
       one,
       add,
       addValue,
-      sub,
+      sub: sub2,
       subValue,
       scale,
       dot: dot2,
@@ -136420,7 +136433,7 @@ var require_vector2_f44fd63e_cjs_dev = __commonJS({
     exports2.lengthSqr = lengthSqr;
     exports2.one = one;
     exports2.scale = scale;
-    exports2.sub = sub;
+    exports2.sub = sub2;
     exports2.subValue = subValue;
     exports2.vector2 = vector2;
     exports2.zero = zero;
@@ -136443,7 +136456,7 @@ var require_vector3_5e723d1a_cjs_dev = __commonJS({
     function addValue(a, n3) {
       return [a[0] + n3, a[1] + n3, a[2] + n3];
     }
-    function sub(a, b) {
+    function sub2(a, b) {
       return [a[0] - b[0], a[1] - b[1], a[2] - b[2]];
     }
     function subValue(a, n3) {
@@ -136455,7 +136468,7 @@ var require_vector3_5e723d1a_cjs_dev = __commonJS({
     function dot2(a, b) {
       return a[0] * b[0] + a[1] * b[1] + a[2] * b[2];
     }
-    function cross(a, b) {
+    function cross2(a, b) {
       var x = a[1] * b[2] - a[2] * b[1];
       var y = a[2] * b[0] - a[0] * b[2];
       var z2 = a[0] * b[1] - a[1] * b[0];
@@ -136476,25 +136489,25 @@ var require_vector3_5e723d1a_cjs_dev = __commonJS({
       one,
       add,
       addValue,
-      sub,
+      sub: sub2,
       subValue,
       scale,
       dot: dot2,
-      cross,
+      cross: cross2,
       lengthSqr,
       length,
       distance
     });
     exports2.add = add;
     exports2.addValue = addValue;
-    exports2.cross = cross;
+    exports2.cross = cross2;
     exports2.distance = distance;
     exports2.dot = dot2;
     exports2.length = length;
     exports2.lengthSqr = lengthSqr;
     exports2.one = one;
     exports2.scale = scale;
-    exports2.sub = sub;
+    exports2.sub = sub2;
     exports2.subValue = subValue;
     exports2.vector3 = vector3;
     exports2.zero = zero;
@@ -164912,7 +164925,7 @@ var require_MarchingCubes = __commonJS({
           }
           return numtris;
         }
-        function posnormtriv(pos, norm, colors, o1, o2, o3) {
+        function posnormtriv(pos, norm2, colors, o1, o2, o3) {
           const c = scope.count * 3;
           scope.positionArray[c + 0] = pos[o1];
           scope.positionArray[c + 1] = pos[o1 + 1];
@@ -164924,9 +164937,9 @@ var require_MarchingCubes = __commonJS({
           scope.positionArray[c + 7] = pos[o3 + 1];
           scope.positionArray[c + 8] = pos[o3 + 2];
           if (scope.material.flatShading === true) {
-            const nx = (norm[o1 + 0] + norm[o2 + 0] + norm[o3 + 0]) / 3;
-            const ny = (norm[o1 + 1] + norm[o2 + 1] + norm[o3 + 1]) / 3;
-            const nz = (norm[o1 + 2] + norm[o2 + 2] + norm[o3 + 2]) / 3;
+            const nx = (norm2[o1 + 0] + norm2[o2 + 0] + norm2[o3 + 0]) / 3;
+            const ny = (norm2[o1 + 1] + norm2[o2 + 1] + norm2[o3 + 1]) / 3;
+            const nz = (norm2[o1 + 2] + norm2[o2 + 2] + norm2[o3 + 2]) / 3;
             scope.normalArray[c + 0] = nx;
             scope.normalArray[c + 1] = ny;
             scope.normalArray[c + 2] = nz;
@@ -164937,15 +164950,15 @@ var require_MarchingCubes = __commonJS({
             scope.normalArray[c + 7] = ny;
             scope.normalArray[c + 8] = nz;
           } else {
-            scope.normalArray[c + 0] = norm[o1 + 0];
-            scope.normalArray[c + 1] = norm[o1 + 1];
-            scope.normalArray[c + 2] = norm[o1 + 2];
-            scope.normalArray[c + 3] = norm[o2 + 0];
-            scope.normalArray[c + 4] = norm[o2 + 1];
-            scope.normalArray[c + 5] = norm[o2 + 2];
-            scope.normalArray[c + 6] = norm[o3 + 0];
-            scope.normalArray[c + 7] = norm[o3 + 1];
-            scope.normalArray[c + 8] = norm[o3 + 2];
+            scope.normalArray[c + 0] = norm2[o1 + 0];
+            scope.normalArray[c + 1] = norm2[o1 + 1];
+            scope.normalArray[c + 2] = norm2[o1 + 2];
+            scope.normalArray[c + 3] = norm2[o2 + 0];
+            scope.normalArray[c + 4] = norm2[o2 + 1];
+            scope.normalArray[c + 5] = norm2[o2 + 2];
+            scope.normalArray[c + 6] = norm2[o3 + 0];
+            scope.normalArray[c + 7] = norm2[o3 + 1];
+            scope.normalArray[c + 8] = norm2[o3 + 2];
           }
           if (scope.enableUvs) {
             const d = scope.count * 2;
@@ -193390,7 +193403,7 @@ var require_TeapotGeometry = __commonJS({
         const vert = [];
         const sdir = [];
         const tdir = [];
-        const norm = new THREE.Vector3();
+        const norm2 = new THREE.Vector3();
         let tcoord;
         let sstep, tstep;
         let vertPerRow;
@@ -193475,12 +193488,12 @@ var require_TeapotGeometry = __commonJS({
                 }
                 vsdir.fromArray(sdir);
                 vtdir.fromArray(tdir);
-                norm.crossVectors(vtdir, vsdir);
-                norm.normalize();
+                norm2.crossVectors(vtdir, vsdir);
+                norm2.normalize();
                 if (vert[0] === 0 && vert[1] === 0) {
                   normOut.set(0, vert[2] > maxHeight2 ? 1 : -1, 0);
                 } else {
-                  normOut.set(norm.x, norm.z, -norm.y);
+                  normOut.set(norm2.x, norm2.z, -norm2.y);
                 }
                 vertices[vertCount++] = trueSize * vert[0];
                 vertices[vertCount++] = trueSize * (vert[2] - maxHeight2);
@@ -232411,7 +232424,7 @@ var require_lottie = __commonJS({
           return 0;
         }
         var add = sum;
-        function sub(a, b) {
+        function sub2(a, b) {
           var tOfA = typeof a;
           var tOfB = typeof b;
           if (isNumerable(tOfA, a) && isNumerable(tOfB, b)) {
@@ -232514,7 +232527,7 @@ var require_lottie = __commonJS({
           return a % b;
         }
         var $bm_sum = sum;
-        var $bm_sub = sub;
+        var $bm_sub = sub2;
         var $bm_mul = mul;
         var $bm_div = div;
         var $bm_mod = mod;
@@ -240714,26 +240727,26 @@ var require_opentype = __commonJS({
         }
         return void 0;
       };
-      Substitution.prototype.add = function(feature, sub, script, language) {
+      Substitution.prototype.add = function(feature, sub2, script, language) {
         if (/ss\d\d/.test(feature)) {
-          return this.addSingle(feature, sub, script, language);
+          return this.addSingle(feature, sub2, script, language);
         }
         switch (feature) {
           case "aalt":
           case "salt":
-            if (typeof sub.by === "number") {
-              return this.addSingle(feature, sub, script, language);
+            if (typeof sub2.by === "number") {
+              return this.addSingle(feature, sub2, script, language);
             }
-            return this.addAlternate(feature, sub, script, language);
+            return this.addAlternate(feature, sub2, script, language);
           case "dlig":
           case "liga":
           case "rlig":
-            return this.addLigature(feature, sub, script, language);
+            return this.addLigature(feature, sub2, script, language);
           case "ccmp":
-            if (sub.by instanceof Array) {
-              return this.addMultiple(feature, sub, script, language);
+            if (sub2.by instanceof Array) {
+              return this.addMultiple(feature, sub2, script, language);
             }
-            return this.addLigature(feature, sub, script, language);
+            return this.addLigature(feature, sub2, script, language);
         }
         return void 0;
       };
@@ -297708,11 +297721,11 @@ var require_LightProbeGenerator = __commonJS({
             }
           }
         }
-        const norm = 4 * Math.PI / totalWeight;
+        const norm2 = 4 * Math.PI / totalWeight;
         for (let j = 0; j < 9; j++) {
-          shCoefficients[j].x *= norm;
-          shCoefficients[j].y *= norm;
-          shCoefficients[j].z *= norm;
+          shCoefficients[j].x *= norm2;
+          shCoefficients[j].y *= norm2;
+          shCoefficients[j].z *= norm2;
         }
         return new THREE.LightProbe(sh);
       },
@@ -297773,11 +297786,11 @@ var require_LightProbeGenerator = __commonJS({
             }
           }
         }
-        const norm = 4 * Math.PI / totalWeight;
+        const norm2 = 4 * Math.PI / totalWeight;
         for (let j = 0; j < 9; j++) {
-          shCoefficients[j].x *= norm;
-          shCoefficients[j].y *= norm;
-          shCoefficients[j].z *= norm;
+          shCoefficients[j].x *= norm2;
+          shCoefficients[j].y *= norm2;
+          shCoefficients[j].z *= norm2;
         }
         return new THREE.LightProbe(sh);
       }
@@ -369769,7 +369782,7 @@ __export(FurnitureItem_exports, {
 function ItemGLB(props) {
   const { src, dimensions, offset, corrRotation, corrScale, rig, cx, cz, baseY, yawDeg, userScale, unitsScale } = props;
   const gltf = (0, import_drei.useGLTF)(src);
-  const { node, seatX, seatY, seatZ, norm } = (0, import_react3.useMemo)(() => {
+  const { node, seatX, seatY, seatZ, norm: norm2 } = (0, import_react3.useMemo)(() => {
     const clone3 = gltf.scene.clone(true);
     if (offset) clone3.position.set(offset[0], offset[1], offset[2]);
     if (corrRotation) {
@@ -369795,7 +369808,7 @@ function ItemGLB(props) {
       norm: targetHorizUnits / nativeHoriz
     };
   }, [gltf.scene, offset, corrRotation, corrScale, rig, dimensions, unitsScale]);
-  return /* @__PURE__ */ React.createElement("group", { position: [cx, baseY, cz], rotation: [0, MathUtils.degToRad(yawDeg ?? 0), 0] }, /* @__PURE__ */ React.createElement("group", { scale: norm * (userScale ?? 1) }, /* @__PURE__ */ React.createElement("group", { position: [seatX, seatY, seatZ] }, /* @__PURE__ */ React.createElement("primitive", { object: node }))));
+  return /* @__PURE__ */ React.createElement("group", { position: [cx, baseY, cz], rotation: [0, MathUtils.degToRad(yawDeg ?? 0), 0] }, /* @__PURE__ */ React.createElement("group", { scale: norm2 * (userScale ?? 1) }, /* @__PURE__ */ React.createElement("group", { position: [seatX, seatY, seatZ] }, /* @__PURE__ */ React.createElement("primitive", { object: node }))));
 }
 function GhostBox({ dimensions, cx, cz, baseY, yawDeg, userScale, unitsScale, loading }) {
   const s = unitsScale * (userScale ?? 1);
@@ -370177,6 +370190,9 @@ function stripMulti(sc) {
   return rest;
 }
 function expandStaircase(sc, slabThickness, floorBelowHeight, floorOwnHeight) {
+  if (sc.width != null && sc.length != null) {
+    return expandStaircaseBox(sc, slabThickness, floorBelowHeight, floorOwnHeight);
+  }
   const up = (sc.climb ?? "down") === "up";
   const tread = n(sc.step_tread);
   const riser = n(sc.step_rise);
@@ -370247,7 +370263,7 @@ function expandStaircase(sc, slabThickness, floorBelowHeight, floorOwnHeight) {
       if (t < numFlights - 1) {
         items.push({
           isStair: false,
-          o: { type: "floor_slab", x: landingX, y: even ? flightRun : 0, width: landingWidth, length: landingDepth, thickness: landingThickness, z_offset: zTopFlight - landingThickness }
+          o: { type: "floor_slab", x: landingX, y: even ? flightRun : -landingDepth, width: landingWidth, length: landingDepth, thickness: landingThickness, z_offset: zTopFlight - landingThickness }
         });
       }
       zCur = zTopFlight;
@@ -370260,7 +370276,7 @@ function expandStaircase(sc, slabThickness, floorBelowHeight, floorOwnHeight) {
       if (t < numFlights - 1) {
         items.push({
           isStair: false,
-          o: { type: "floor_slab", x: landingX, y: even ? flightRun : 0, width: landingWidth, length: landingDepth, thickness: landingThickness, z_offset: zBottom - landingThickness }
+          o: { type: "floor_slab", x: landingX, y: even ? flightRun : -landingDepth, width: landingWidth, length: landingDepth, thickness: landingThickness, z_offset: zBottom - landingThickness }
         });
       }
       zCur = zBottom;
@@ -370285,6 +370301,114 @@ function expandStaircase(sc, slabThickness, floorBelowHeight, floorOwnHeight) {
     return o;
   });
 }
+function expandStaircaseBox(sc, slabThickness, floorBelowHeight, floorOwnHeight) {
+  const up = (sc.climb ?? "down") === "up";
+  const tread = n(sc.step_tread);
+  const riser = n(sc.step_rise);
+  const direction = sc.direction ?? "south";
+  const runAlongY = direction === "south" || direction === "north";
+  const boxW = n(sc.width);
+  const boxL = n(sc.length);
+  const runBudget = runAlongY ? boxL : boxW;
+  const lateralExtent = runAlongY ? boxW : boxL;
+  const name = sc.name ?? "Stair";
+  const defaultRise = up ? floorOwnHeight : floorBelowHeight;
+  const riseHeight = typeof sc.rise_height === "number" && sc.rise_height > 0 ? sc.rise_height : defaultRise;
+  const totalSteps = Math.max(1, Math.round(riseHeight / riser));
+  const anchorZ = sc.z_offset !== void 0 ? n(sc.z_offset) : slabThickness;
+  const gap = typeof sc.flight_gap === "number" && sc.flight_gap > 0 ? sc.flight_gap : 0;
+  const laneWidth = (lateralExtent - gap) / 2;
+  const landingDepth = typeof sc.landing_depth === "number" && sc.landing_depth > 0 ? sc.landing_depth : Math.max(1, laneWidth);
+  const landingThickness = typeof sc.landing_thickness === "number" ? sc.landing_thickness : riser;
+  const flightRunFor = (nf) => (Math.ceil(totalSteps / nf) - 1) * tread;
+  const reserveFor = (_nf) => 2 * landingDepth;
+  let numFlights = 0;
+  for (let nf = 1; nf <= totalSteps; nf++) {
+    if (nf >= 2 && Math.ceil(totalSteps / nf) < 2) break;
+    if (flightRunFor(nf) + reserveFor(nf) <= runBudget + 1e-6) {
+      numFlights = nf;
+      break;
+    }
+  }
+  if (numFlights === 0) {
+    const minLen = tread + 2 * landingDepth;
+    throw new Error(
+      `staircase "${name}" doesn't fit its box along ${runAlongY ? "length (Y)" : "width (X)"}: need at least ${Math.ceil(minLen)} (one ${tread}-unit tread + a bottom approach + a turn landing, ${landingDepth} each), but only ${Math.floor(runBudget)} is allocated. Enlarge the box or reduce landing_depth.`
+    );
+  }
+  const nLanes = numFlights >= 2 ? 2 : 1;
+  const stairWidth = nLanes === 2 ? laneWidth : lateralExtent;
+  if (!(stairWidth > 0)) {
+    throw new Error(
+      `staircase "${name}" doesn't fit its box across the stairs: the ${Math.floor(lateralExtent)}-unit side leaves no room for ${nLanes === 2 ? "two lanes" : "a flight"} past flight_gap ${gap}.`
+    );
+  }
+  const perFlight = Math.ceil(totalSteps / numFlights);
+  const risersFor = (t) => Math.max(0, Math.min(perFlight, totalSteps - t * perFlight));
+  const flightRun = Math.max(1, perFlight - 1) * tread;
+  const nearOffset = landingDepth;
+  const anti = sc.turn === "anticlockwise";
+  const laneA = anti ? stairWidth + gap : 0;
+  const laneB = anti ? 0 : stairWidth + gap;
+  const landingWidth = nLanes === 2 ? 2 * stairWidth + gap : stairWidth;
+  const items = [];
+  const stepFields = { step_rise: riser, step_tread: tread, step_width: stairWidth };
+  let zCur = 0;
+  for (let t = 0; t < numFlights; t++) {
+    const risers = risersFor(t);
+    if (risers <= 0) break;
+    const treads = Math.max(1, risers - 1);
+    const even = t % 2 === 0;
+    const lane = even ? laneA : laneB;
+    const run = treads * tread;
+    if (up) {
+      const zBottomFlight = zCur;
+      const zTopFlight = zCur + risers * riser;
+      items.push({
+        isStair: true,
+        o: even ? { type: "staircase", direction: "south", start_x: lane, start_y: nearOffset, num_steps: treads, ...stepFields, z_offset: zBottomFlight } : { type: "staircase", direction: "north", start_x: lane, start_y: nearOffset + flightRun, num_steps: treads, ...stepFields, z_offset: zBottomFlight }
+      });
+      {
+        const ly = even ? nearOffset + flightRun : nearOffset - landingDepth;
+        items.push({ isStair: false, o: { type: "floor_slab", x: 0, y: ly, width: landingWidth, length: landingDepth, thickness: landingThickness, z_offset: zTopFlight - landingThickness } });
+      }
+      zCur = zTopFlight;
+    } else {
+      const zBottom = zCur - risers * riser;
+      items.push({
+        isStair: true,
+        o: even ? { type: "staircase", direction: "north", start_x: lane, start_y: nearOffset + run, num_steps: treads, ...stepFields, z_offset: zBottom } : { type: "staircase", direction: "south", start_x: lane, start_y: nearOffset + flightRun - run, num_steps: treads, ...stepFields, z_offset: zBottom }
+      });
+      {
+        const ly = even ? nearOffset + flightRun : nearOffset - landingDepth;
+        items.push({ isStair: false, o: { type: "floor_slab", x: 0, y: ly, width: landingWidth, length: landingDepth, thickness: landingThickness, z_offset: zBottom - landingThickness } });
+      }
+      zCur = zBottom;
+    }
+  }
+  const rotated = items.map((it) => ({ ...it, o: rotateObject(it.o, direction) }));
+  const R = ROT[direction];
+  let minX = Infinity, minY = Infinity;
+  for (const [cx, cy] of [[0, 0], [lateralExtent, 0], [0, runBudget], [lateralExtent, runBudget]]) {
+    const [rx, ry] = R.m(cx, cy);
+    if (rx < minX) minX = rx;
+    if (ry < minY) minY = ry;
+  }
+  const dx = n(sc.start_x) - minX;
+  const dy = n(sc.start_y) - minY;
+  let fi = 0, li = 0;
+  return rotated.map(({ o, isStair }) => {
+    if (typeof o.x === "number") o.x += dx;
+    if (typeof o.y === "number") o.y += dy;
+    if (typeof o.start_x === "number") o.start_x += dx;
+    if (typeof o.start_y === "number") o.start_y += dy;
+    o.z_offset = n(o.z_offset) + anchorZ;
+    if (sc.layer !== void 0) o.layer = sc.layer;
+    if (isStair && sc.material !== void 0) o.material = sc.material;
+    o.name = isStair ? `${name}_F${++fi}` : `${name}_L${++li}`;
+    return o;
+  });
+}
 function flip180(d) {
   return d === "south" ? "north" : d === "north" ? "south" : d === "east" ? "west" : "east";
 }
@@ -370474,27 +370598,6 @@ function expandRoomWalls(houseConfig, wallThickness, opts, _depth = 0) {
           if (typeof r2.y === "number") r2.y = r2.y - ot / 2;
           if (typeof r2.width === "number") r2.width = r2.width + ot;
           if (typeof r2.length === "number") r2.length = r2.length + ot;
-        } else if (o.type === "roof") {
-          const segs = r2.segments;
-          if (Array.isArray(segs)) {
-            const half = t / 2;
-            for (const s of segs) {
-              const st = s.start;
-              const en = s.end;
-              if (Array.isArray(st) && Array.isArray(en) && typeof st[0] === "number" && typeof st[1] === "number" && typeof en[0] === "number" && typeof en[1] === "number") {
-                const dx = en[0] - st[0];
-                const dy = en[1] - st[1];
-                const len = Math.hypot(dx, dy);
-                if (len > 0) {
-                  const ux = dx / len;
-                  const uy = dy / len;
-                  s.start = [st[0] - ux * half, st[1] - uy * half];
-                  s.end = [en[0] + ux * half, en[1] + uy * half];
-                }
-              }
-              if (typeof s.width === "number") s.width = s.width + t;
-            }
-          }
         }
       }
     }
@@ -370699,16 +370802,16 @@ function rotateSide(side2, cos, sin) {
   return ry >= 0 ? "south" : "north";
 }
 function placeComponent(objs, dx, dy, dz, deg, wallThickness) {
-  const norm = (deg % 360 + 360) % 360;
-  const rad = norm * Math.PI / 180;
+  const norm2 = (deg % 360 + 360) % 360;
+  const rad = norm2 * Math.PI / 180;
   const clean = (v) => Math.round(v * 1e12) / 1e12;
   const cos = clean(Math.cos(rad));
   const sin = clean(Math.sin(rad));
-  const swap = norm === 90 || norm === 270;
+  const swap = norm2 === 90 || norm2 === 270;
   const rp = (x, y) => [x * cos + y * sin, -x * sin + y * cos];
   return objs.map((o) => {
     const n3 = { ...o };
-    if (norm !== 0) {
+    if (norm2 !== 0) {
       if (BOX_TYPES.has(n3.type)) {
         const w = typeof n3.width === "number" ? n3.width : wallThickness;
         const l = typeof n3.length === "number" ? n3.length : wallThickness;
@@ -370732,7 +370835,7 @@ function placeComponent(objs, dx, dy, dz, deg, wallThickness) {
         for (const [k, v] of Object.entries(n3.wall_heights)) wh[isSide(k) ? rotateSide(k, cos, sin) : k] = v;
         n3.wall_heights = wh;
       }
-      if (n3.type === "item" || n3.type === "model") n3.rotation = (((typeof n3.rotation === "number" ? n3.rotation : 0) + norm) % 360 + 360) % 360;
+      if (n3.type === "item" || n3.type === "model") n3.rotation = (((typeof n3.rotation === "number" ? n3.rotation : 0) + norm2) % 360 + 360) % 360;
     }
     if (typeof n3.x === "number") n3.x += dx;
     if (typeof n3.y === "number") n3.y += dy;
@@ -372782,8 +372885,8 @@ var ZodError = class _ZodError extends Error {
   constructor(issues) {
     super();
     this.issues = [];
-    this.addIssue = (sub) => {
-      this.issues = [...this.issues, sub];
+    this.addIssue = (sub2) => {
+      this.issues = [...this.issues, sub2];
     };
     this.addIssues = (subs = []) => {
       this.issues = [...this.issues, ...subs];
@@ -372850,13 +372953,13 @@ var ZodError = class _ZodError extends Error {
   flatten(mapper = (issue3) => issue3.message) {
     const fieldErrors = {};
     const formErrors = [];
-    for (const sub of this.issues) {
-      if (sub.path.length > 0) {
-        const firstEl = sub.path[0];
+    for (const sub2 of this.issues) {
+      if (sub2.path.length > 0) {
+        const firstEl = sub2.path[0];
         fieldErrors[firstEl] = fieldErrors[firstEl] || [];
-        fieldErrors[firstEl].push(mapper(sub));
+        fieldErrors[firstEl].push(mapper(sub2));
       } else {
-        formErrors.push(mapper(sub));
+        formErrors.push(mapper(sub2));
       }
     }
     return { formErrors, fieldErrors };
@@ -377156,12 +377259,12 @@ var $ZodRealError = $constructor("$ZodError", initializer, { Parent: Error });
 function flattenError(error53, mapper = (issue3) => issue3.message) {
   const fieldErrors = {};
   const formErrors = [];
-  for (const sub of error53.issues) {
-    if (sub.path.length > 0) {
-      fieldErrors[sub.path[0]] = fieldErrors[sub.path[0]] || [];
-      fieldErrors[sub.path[0]].push(mapper(sub));
+  for (const sub2 of error53.issues) {
+    if (sub2.path.length > 0) {
+      fieldErrors[sub2.path[0]] = fieldErrors[sub2.path[0]] || [];
+      fieldErrors[sub2.path[0]].push(mapper(sub2));
     } else {
-      formErrors.push(mapper(sub));
+      formErrors.push(mapper(sub2));
     }
   }
   return { formErrors, fieldErrors };
@@ -379566,13 +379669,13 @@ function _array(Class3, element, params) {
   });
 }
 function _custom(Class3, fn, _params) {
-  const norm = normalizeParams(_params);
-  norm.abort ?? (norm.abort = true);
+  const norm2 = normalizeParams(_params);
+  norm2.abort ?? (norm2.abort = true);
   const schema = new Class3({
     type: "custom",
     check: "custom",
     fn,
-    ...norm
+    ...norm2
   });
   return schema;
 }
@@ -405189,6 +405292,8 @@ var Roof = {
   name: "name",
   parapet_height: "parapet_height",
   parapet_thickness: "parapet_thickness",
+  purlin_pitch: "purlin_pitch",
+  rafter_pitch: "rafter_pitch",
   roof_type: "roof_type",
   segments: "segments",
   slab_thickness: "slab_thickness",
@@ -405256,7 +405361,9 @@ var Segment = {
   sx: "sx",
   sy: "sy",
   tie_beam_count: "tie_beam_count",
-  width: "width"
+  width: "width",
+  width_left: "width_left",
+  width_right: "width_right"
 };
 var SelectInput = {
   $type: "SelectInput",
@@ -405311,6 +405418,8 @@ var SpiralStaircase = {
 };
 var Staircase = {
   $type: "Staircase",
+  box_length: "box_length",
+  box_width: "box_width",
   climb: "climb",
   direction: "direction",
   enabled: "enabled",
@@ -406594,6 +406703,14 @@ var WadiAstReflection = class extends AbstractAstReflection {
           name: Roof.parapet_thickness,
           optional: true
         },
+        purlin_pitch: {
+          name: Roof.purlin_pitch,
+          optional: true
+        },
+        rafter_pitch: {
+          name: Roof.rafter_pitch,
+          optional: true
+        },
         roof_type: {
           name: Roof.roof_type
         },
@@ -406834,7 +406951,16 @@ var WadiAstReflection = class extends AbstractAstReflection {
           optional: true
         },
         width: {
-          name: Segment.width
+          name: Segment.width,
+          optional: true
+        },
+        width_left: {
+          name: Segment.width_left,
+          optional: true
+        },
+        width_right: {
+          name: Segment.width_right,
+          optional: true
         }
       },
       superTypes: []
@@ -406996,6 +407122,14 @@ var WadiAstReflection = class extends AbstractAstReflection {
     Staircase: {
       name: Staircase.$type,
       properties: {
+        box_length: {
+          name: Staircase.box_length,
+          optional: true
+        },
+        box_width: {
+          name: Staircase.box_width,
+          optional: true
+        },
         climb: {
           name: Staircase.climb,
           optional: true
@@ -407052,7 +407186,8 @@ var WadiAstReflection = class extends AbstractAstReflection {
           name: Staircase.step_tread
         },
         step_width: {
-          name: Staircase.step_width
+          name: Staircase.step_width,
+          optional: true
         },
         turn: {
           name: Staircase.turn,
@@ -413264,6 +413399,52 @@ var WadiGrammar = () => loadedWadiGrammar ?? (loadedWadiGrammar = loadGrammarFro
             "$type": "Keyword",
             "value": ")"
           },
+          {
+            "$type": "Group",
+            "elements": [
+              {
+                "$type": "Keyword",
+                "value": "box"
+              },
+              {
+                "$type": "Keyword",
+                "value": "("
+              },
+              {
+                "$type": "Assignment",
+                "feature": "box_width",
+                "operator": "=",
+                "terminal": {
+                  "$type": "RuleCall",
+                  "rule": {
+                    "$ref": "#/rules@17"
+                  },
+                  "arguments": []
+                }
+              },
+              {
+                "$type": "Keyword",
+                "value": ","
+              },
+              {
+                "$type": "Assignment",
+                "feature": "box_length",
+                "operator": "=",
+                "terminal": {
+                  "$type": "RuleCall",
+                  "rule": {
+                    "$ref": "#/rules@17"
+                  },
+                  "arguments": []
+                }
+              },
+              {
+                "$type": "Keyword",
+                "value": ")"
+              }
+            ],
+            "cardinality": "?"
+          },
           {
             "$type": "Keyword",
             "value": "step"
@@ -413301,20 +413482,26 @@ var WadiGrammar = () => loadedWadiGrammar ?? (loadedWadiGrammar = loadGrammarFro
             }
           },
           {
-            "$type": "Keyword",
-            "value": ","
-          },
-          {
-            "$type": "Assignment",
-            "feature": "step_width",
-            "operator": "=",
-            "terminal": {
-              "$type": "RuleCall",
-              "rule": {
-                "$ref": "#/rules@17"
+            "$type": "Group",
+            "elements": [
+              {
+                "$type": "Keyword",
+                "value": ","
               },
-              "arguments": []
-            }
+              {
+                "$type": "Assignment",
+                "feature": "step_width",
+                "operator": "=",
+                "terminal": {
+                  "$type": "RuleCall",
+                  "rule": {
+                    "$ref": "#/rules@17"
+                  },
+                  "arguments": []
+                }
+              }
+            ],
+            "cardinality": "?"
           },
           {
             "$type": "Keyword",
@@ -415153,6 +415340,50 @@ var WadiGrammar = () => loadedWadiGrammar ?? (loadedWadiGrammar = loadGrammarFro
             ],
             "cardinality": "?"
           },
+          {
+            "$type": "Group",
+            "elements": [
+              {
+                "$type": "Keyword",
+                "value": "rafter_pitch"
+              },
+              {
+                "$type": "Assignment",
+                "feature": "rafter_pitch",
+                "operator": "=",
+                "terminal": {
+                  "$type": "RuleCall",
+                  "rule": {
+                    "$ref": "#/rules@17"
+                  },
+                  "arguments": []
+                }
+              }
+            ],
+            "cardinality": "?"
+          },
+          {
+            "$type": "Group",
+            "elements": [
+              {
+                "$type": "Keyword",
+                "value": "purlin_pitch"
+              },
+              {
+                "$type": "Assignment",
+                "feature": "purlin_pitch",
+                "operator": "=",
+                "terminal": {
+                  "$type": "RuleCall",
+                  "rule": {
+                    "$ref": "#/rules@17"
+                  },
+                  "arguments": []
+                }
+              }
+            ],
+            "cardinality": "?"
+          },
           {
             "$type": "RuleCall",
             "rule": {
@@ -415438,20 +415669,75 @@ var WadiGrammar = () => loadedWadiGrammar ?? (loadedWadiGrammar = loadGrammarFro
             "value": ")"
           },
           {
-            "$type": "Keyword",
-            "value": "width"
-          },
-          {
-            "$type": "Assignment",
-            "feature": "width",
-            "operator": "=",
-            "terminal": {
-              "$type": "RuleCall",
-              "rule": {
-                "$ref": "#/rules@17"
+            "$type": "Alternatives",
+            "elements": [
+              {
+                "$type": "Group",
+                "elements": [
+                  {
+                    "$type": "Keyword",
+                    "value": "width"
+                  },
+                  {
+                    "$type": "Assignment",
+                    "feature": "width",
+                    "operator": "=",
+                    "terminal": {
+                      "$type": "RuleCall",
+                      "rule": {
+                        "$ref": "#/rules@17"
+                      },
+                      "arguments": []
+                    }
+                  }
+                ]
               },
-              "arguments": []
-            }
+              {
+                "$type": "Group",
+                "elements": [
+                  {
+                    "$type": "Keyword",
+                    "value": "widths"
+                  },
+                  {
+                    "$type": "Keyword",
+                    "value": "("
+                  },
+                  {
+                    "$type": "Assignment",
+                    "feature": "width_left",
+                    "operator": "=",
+                    "terminal": {
+                      "$type": "RuleCall",
+                      "rule": {
+                        "$ref": "#/rules@17"
+                      },
+                      "arguments": []
+                    }
+                  },
+                  {
+                    "$type": "Keyword",
+                    "value": ","
+                  },
+                  {
+                    "$type": "Assignment",
+                    "feature": "width_right",
+                    "operator": "=",
+                    "terminal": {
+                      "$type": "RuleCall",
+                      "rule": {
+                        "$ref": "#/rules@17"
+                      },
+                      "arguments": []
+                    }
+                  },
+                  {
+                    "$type": "Keyword",
+                    "value": ")"
+                  }
+                ]
+              }
+            ]
           },
           {
             "$type": "Group",
@@ -416551,9 +416837,14 @@ function staircase(s) {
     start_y: put("start_y", s.start_y, 0),
     step_rise: put("step_rise", s.step_rise, 1),
     step_tread: put("step_tread", s.step_tread, 1),
-    step_width: put("step_width", s.step_width, 1),
     direction: s.direction
   };
+  if (s.box_width !== void 0 && s.box_length !== void 0) {
+    o.width = put("width", s.box_width, 1);
+    o.length = put("length", s.box_length, 1);
+  }
+  const sw = put("step_width", s.step_width, 1);
+  if (sw !== void 0) o.step_width = sw;
   if (s.name) o.name = unquote2(s.name);
   if (s.climb) o.climb = s.climb;
   const rh = put("rise_height", s.rise_height, 1);
@@ -416780,6 +417071,18 @@ function roof(r2) {
   const gwt = put("gable_wall_thickness", r2.gable_wall_thickness);
   if (gwt !== void 0) o.gable_wall_thickness = gwt;
   if (r2.framing) o.framing = jsonObject(r2.framing);
+  if (r2.rafter_pitch !== void 0 || r2.purlin_pitch !== void 0) {
+    const framing = o.framing ?? {};
+    const setPitch = (key, e, ph) => {
+      if (e === void 0) return;
+      const { value, formula } = fieldAndFormula(e, ph);
+      framing[key] = value;
+      if (formula) formulas[`framing.${key}`] = formula;
+    };
+    setPitch("rafter_spacing_in", r2.rafter_pitch, 36);
+    setPitch("purlin_spacing_in", r2.purlin_pitch, 12);
+    o.framing = framing;
+  }
   if (r2.segments.length) o.segments = r2.segments.map(roofSegment);
   if (r2.trusses.length) o.trusses = r2.trusses.map(roofTruss);
   applyCommon(o, formulas, r2);
@@ -416790,9 +417093,25 @@ function roofSegment(s) {
   const seg = {
     id: unquote2(s.id),
     start: [put("start_x", s.sx, 0), put("start_y", s.sy, 0)],
-    end: [put("end_x", s.ex, 0), put("end_y", s.ey, 0)],
-    width: put("width", s.width, 1)
+    end: [put("end_x", s.ex, 0), put("end_y", s.ey, 0)]
   };
+  if (s.width !== void 0) {
+    seg.width = put("width", s.width, 1);
+  } else if (s.width_left !== void 0 && s.width_right !== void 0) {
+    const wl = put("width_left", s.width_left, 1) ?? 1;
+    const wr = put("width_right", s.width_right, 1) ?? 1;
+    seg.width_left = wl;
+    seg.width_right = wr;
+    seg.width = wl + wr;
+    const lf = formulas.width_left, rf = formulas.width_right;
+    if (lf || rf) {
+      const lExpr = lf ? `(${lf.replace(/^=\s*/, "")})` : String(wl);
+      const rExpr = rf ? `(${rf.replace(/^=\s*/, "")})` : String(wr);
+      formulas.width = `= ${lExpr} + ${rExpr}`;
+    }
+  } else {
+    seg.width = 1;
+  }
   if (s.shed_high_side) seg.shed_high_side = s.shed_high_side;
   if (s.start_endpoint) seg.start_endpoint = s.start_endpoint;
   if (s.end_endpoint) seg.end_endpoint = s.end_endpoint;
@@ -417336,7 +417655,26 @@ function isLeafEndpoint(entries, segmentId, which) {
   if (!entry) return true;
   return !entry.isJoint;
 }
-function ringBeamMembersForRect(rect, z2, segmentId) {
+function insetQuad(rect, d) {
+  if (!(d > 0)) return [rect[0], rect[1], rect[2], rect[3]];
+  const cx = (rect[0][0] + rect[1][0] + rect[2][0] + rect[3][0]) / 4;
+  const cy = (rect[0][1] + rect[1][1] + rect[2][1] + rect[3][1]) / 4;
+  const ax = [rect[1][0] - rect[0][0], rect[1][1] - rect[0][1]];
+  const bx = [rect[3][0] - rect[0][0], rect[3][1] - rect[0][1]];
+  const al = Math.hypot(ax[0], ax[1]) || 1, bl = Math.hypot(bx[0], bx[1]) || 1;
+  const ua = [ax[0] / al, ax[1] / al];
+  const ub = [bx[0] / bl, bx[1] / bl];
+  const move = (p) => {
+    const dx = p[0] - cx, dy = p[1] - cy;
+    let a = dx * ua[0] + dy * ua[1];
+    let b = dx * ub[0] + dy * ub[1];
+    a -= Math.sign(a) * Math.min(d, Math.abs(a));
+    b -= Math.sign(b) * Math.min(d, Math.abs(b));
+    return [cx + a * ua[0] + b * ub[0], cy + a * ua[1] + b * ub[1]];
+  };
+  return [move(rect[0]), move(rect[1]), move(rect[2]), move(rect[3])];
+}
+function ringBeamMembersForRect(rect, z2, segmentId, inset = 0) {
   const out = [];
   const labels = [
     "right",
@@ -417344,9 +417682,10 @@ function ringBeamMembersForRect(rect, z2, segmentId) {
     "left",
     "back"
   ];
+  const r2 = insetQuad(rect, inset);
   for (let i2 = 0; i2 < 4; i2++) {
-    const a = rect[i2];
-    const b = rect[(i2 + 1) % 4];
+    const a = r2[i2];
+    const b = r2[(i2 + 1) % 4];
     out.push({
       id: `${segmentId}.ring_beam.${labels[i2]}`,
       start: [a[0], a[1], z2],
@@ -417369,6 +417708,11 @@ function slopeAngleRad(spec, crossHalf) {
   return Math.atan(spec.ridge_h / crossHalf);
 }
 function resolvePitch(seg, cfg, crossHalf) {
+  if (seg.width_left != null && seg.width_right != null && seg.width_left > 0 && seg.width_right > 0) {
+    const L = seg.width_left, R = seg.width_right;
+    const ridgeH2 = resolveRise(seg.slope_override ?? cfg.slope, crossHalf);
+    return { ridgeH: ridgeH2, ridgeShift: (R - L) / 2, leftPitchTan: ridgeH2 / L, rightPitchTan: ridgeH2 / R };
+  }
   const left = seg.slope_left_override ?? cfg.slope_left;
   const right = seg.slope_right_override ?? cfg.slope_right;
   if (left && right) {
@@ -417426,7 +417770,7 @@ function derivePitchedRoof(cfg, opts) {
   for (const seg of cfg.segments) {
     const alongLen = segmentLength(seg);
     if (alongLen === 0) continue;
-    const crossHalf = seg.width / 2;
+    const crossHalf = seg.width_left != null && seg.width_right != null ? (seg.width_left + seg.width_right) / 2 : seg.width / 2;
     const { ridgeH, ridgeShift, leftPitchTan, rightPitchTan } = resolvePitch(seg, cfg, crossHalf);
     const asym = ridgeShift !== 0;
     if (!(ridgeH > 0)) {
@@ -417598,7 +417942,8 @@ function derivePitchedRoof(cfg, opts) {
       );
     }
     const rect = segmentRect(seg);
-    for (const rb of ringBeamMembersForRect(rect, opts.wallTopZ, seg.id)) {
+    const ringInset = (opts.wallThickness ?? 0) / 2;
+    for (const rb of ringBeamMembersForRect(rect, opts.wallTopZ, seg.id, ringInset)) {
       if (startRes === "open" && rb.id.endsWith(".back")) continue;
       if (endRes === "open" && rb.id.endsWith(".front")) continue;
       members.push(rb);
@@ -417916,7 +418261,7 @@ function deriveShedRoof(cfg, opts) {
     const leftN = [-unit[1], unit[0]];
     const highIsLeft = highSide === "left";
     const rect = segmentRect(seg);
-    for (const rb of ringBeamMembersForRect(rect, opts.wallTopZ, seg.id)) {
+    for (const rb of ringBeamMembersForRect(rect, opts.wallTopZ, seg.id, (opts.wallThickness ?? 0) / 2)) {
       if (startIsLeaf && rb.id.endsWith(".back")) continue;
       if (endIsLeaf && rb.id.endsWith(".front")) continue;
       const isHighEave = highIsLeft && rb.id.endsWith(".left") || !highIsLeft && rb.id.endsWith(".right");
@@ -418082,8 +418427,8 @@ function resolveJoints(cfg, spec, opts) {
     if (segmentLength(segA) === 0 || segmentLength(segB) === 0) continue;
     const uA = segmentUnitVector(segA);
     const uB = segmentUnitVector(segB);
-    const cross = uA[0] * uB[1] - uA[1] * uB[0];
-    if (Math.abs(cross) < 1e-9) continue;
+    const cross2 = uA[0] * uB[1] - uA[1] * uB[0];
+    if (Math.abs(cross2) < 1e-9) continue;
     const insideA = insideSideMultiplier(segA, segB);
     const insideB = insideSideMultiplier(segB, segA);
     const wallA = offsetLine(segA, insideA * segA.width / 2);
@@ -419038,6 +419383,13 @@ function computeMergedV2Spec(config3, opts = {}) {
         merged.members.push(...spec.members);
         merged.planes.push(...spec.planes);
         merged.trusses.push(...spec.trusses);
+        merged.framing = {
+          ring_beam_size_in: framing.ring_beam_size_in,
+          ridge_size_in: framing.ridge_size_in,
+          rafter_size_in: framing.rafter_size_in,
+          purlin_size_in: framing.purlin_size_in,
+          wall_thickness_u: wallThickness
+        };
       } catch (e) {
         const name = obj.name;
         const label = name ? `roof "${name}"` : "roof";
@@ -423944,9 +424296,9 @@ var Line$1 = class Line2 extends Shape2 {
       return;
     }
     if (args.length === 1 && args[0] instanceof Object && args[0].name === "line") {
-      let { pt, norm } = args[0];
+      let { pt, norm: norm2 } = args[0];
       this.pt = new Flatten.Point(pt);
-      this.norm = new Flatten.Vector(norm);
+      this.norm = new Flatten.Vector(norm2);
       return;
     }
     if (args.length === 2) {
@@ -430325,6 +430677,27 @@ function legendSvg(x, y) {
   lines.push(`</g>`);
   return lines.join("");
 }
+function sectionBubble(x, y, letter, color) {
+  return `<circle cx="${x.toFixed(1)}" cy="${y.toFixed(1)}" r="9" fill="#ffffff" stroke="${color}" stroke-width="1.4" /><text x="${x.toFixed(1)}" y="${(y + 3.5).toFixed(1)}" text-anchor="middle" font-size="11" font-weight="700" fill="${color}">${escapeXml(letter)}</text>`;
+}
+function detailMarker(x, y, side2, text, color, flip) {
+  const tx = flip ? x - 12 : x + 12;
+  const anchor = flip ? "end" : "start";
+  return `<circle cx="${x.toFixed(1)}" cy="${y.toFixed(1)}" r="8" fill="${color}" stroke="#ffffff" stroke-width="1" /><text x="${x.toFixed(1)}" y="${(y + 3).toFixed(1)}" text-anchor="middle" font-size="9" font-weight="700" fill="#ffffff">${escapeXml(side2)}</text><text x="${tx.toFixed(1)}" y="${(y + 3).toFixed(1)}" text-anchor="${anchor}" font-size="9" font-weight="600" fill="none" stroke="#ffffff" stroke-width="3" stroke-linejoin="round">${escapeXml(text)}</text><text x="${tx.toFixed(1)}" y="${(y + 3).toFixed(1)}" text-anchor="${anchor}" font-size="9" font-weight="600" fill="${color}">${escapeXml(text)}</text>`;
+}
+function faceTag(x, y, label) {
+  const common2 = `x="${x.toFixed(1)}" y="${(y + 4).toFixed(1)}" text-anchor="middle" font-size="12" font-weight="800"`;
+  return `<text ${common2} fill="none" stroke="#ffffff" stroke-width="3.5" stroke-linejoin="round">${escapeXml(label)}</text><text ${common2} fill="#334155">${escapeXml(label)}</text>`;
+}
+function polyCentroid(verts) {
+  let sx = 0, sy = 0;
+  for (const v of verts) {
+    sx += v[0];
+    sy += v[1];
+  }
+  const n3 = verts.length || 1;
+  return [sx / n3, sy / n3];
+}
 function renderTopViewPanel(spec, opts) {
   const { width, height } = opts;
   const padding = opts.padding ?? 20;
@@ -430368,9 +430741,58 @@ function renderTopViewPanel(spec, opts) {
       let deg = Math.atan2(dy, dx) * 180 / Math.PI;
       if (deg > 90) deg -= 180;
       else if (deg < -90) deg += 180;
-      body.push(
-        `<text x="${lx.toFixed(1)}" y="${ly.toFixed(1)}" text-anchor="middle" dominant-baseline="middle" font-size="10" font-weight="700" fill="#b91c1c" paint-order="stroke" stroke="#ffffff" stroke-width="3" stroke-linejoin="round" transform="rotate(${deg.toFixed(1)} ${lx.toFixed(1)} ${ly.toFixed(1)})">ridge ${escapeXml(formatDimension(lenW))}</text>`
-      );
+      const ridgeCommon = `x="${lx.toFixed(1)}" y="${ly.toFixed(1)}" text-anchor="middle" dominant-baseline="middle" font-size="10" font-weight="700" transform="rotate(${deg.toFixed(1)} ${lx.toFixed(1)} ${ly.toFixed(1)})"`;
+      const ridgeLabel = `ridge ${escapeXml(formatDimension(lenW))}`;
+      body.push(`<text ${ridgeCommon} fill="none" stroke="#ffffff" stroke-width="3" stroke-linejoin="round">${ridgeLabel}</text>`);
+      body.push(`<text ${ridgeCommon} fill="#b91c1c">${ridgeLabel}</text>`);
+    }
+    if (opts.markers) {
+      const mk = opts.markers;
+      const cx = (bounds.x_min + bounds.x_max) / 2;
+      const cy = (bounds.y_min + bounds.y_max) / 2;
+      const spanX = bounds.x_max - bounds.x_min || 1;
+      const spanY = bounds.y_max - bounds.y_min || 1;
+      const SECT = "#7c3aed", EAVE = "#0e7490";
+      for (const s of mk.sections) {
+        const p1 = s.axis === "x" ? toSvg(s.coord, bounds.y_min) : toSvg(bounds.x_min, s.coord);
+        const p2 = s.axis === "x" ? toSvg(s.coord, bounds.y_max) : toSvg(bounds.x_max, s.coord);
+        let ux = p2[0] - p1[0], uy = p2[1] - p1[1];
+        const ul = Math.hypot(ux, uy) || 1;
+        ux /= ul;
+        uy /= ul;
+        const e1 = [p1[0] - ux * 18, p1[1] - uy * 18];
+        const e2 = [p2[0] + ux * 18, p2[1] + uy * 18];
+        body.push(`<line x1="${e1[0].toFixed(1)}" y1="${e1[1].toFixed(1)}" x2="${e2[0].toFixed(1)}" y2="${e2[1].toFixed(1)}" stroke="${SECT}" stroke-width="1.3" stroke-dasharray="12 3 3 3" />`);
+        body.push(sectionBubble(e1[0], e1[1], s.label, SECT));
+        body.push(sectionBubble(e2[0], e2[1], s.label, SECT));
+      }
+      for (const e of mk.eaves) {
+        for (const side2 of e.sides) {
+          let wx = cx, wy = cy;
+          if (side2 === "N") {
+            wy = bounds.y_min + spanY * 0.05;
+          } else if (side2 === "S") {
+            wy = bounds.y_max - spanY * 0.05;
+          } else if (side2 === "W") {
+            wx = bounds.x_min + spanX * 0.05;
+          } else if (side2 === "E") {
+            wx = bounds.x_max - spanX * 0.05;
+          }
+          const [sx, sy] = toSvg(wx, wy);
+          const flip = side2 === "E";
+          body.push(detailMarker(sx, sy, side2, `${e.label} eave`, EAVE, flip));
+        }
+      }
+      for (const f2 of mk.faces) {
+        for (const id of f2.planeIds) {
+          const pl = spec.planes.find((p) => p.id === id);
+          if (!pl) continue;
+          const [cxw, cyw] = polyCentroid(pl.vertices);
+          const [fx, fy] = toSvg(cxw, cyw);
+          body.push(faceTag(fx, fy, f2.label));
+        }
+      }
+      body.push(`<text x="10" y="${(height - 8).toFixed(1)}" font-size="9" fill="#475569"><tspan fill="${SECT}" font-weight="700">A</tspan>\u2013A section cut \xB7 <tspan fill="${EAVE}" font-weight="700">\u25CF</tspan> eave detail \xB7 <tspan fill="#334155" font-weight="800">F#</tspan> roof face</text>`);
     }
   } else {
     body.push(`<text x="${(width / 2).toFixed(1)}" y="${(height / 2).toFixed(1)}" text-anchor="middle" font-size="11" fill="#94a3b8">(empty roof spec)</text>`);
@@ -430386,8 +430808,11 @@ function escapeXml(s) {
 }
 
 // ../editor/src/svg2d/roof/v2/perspectivePanel.ts
+init_format();
 var COS30 = Math.cos(30 * Math.PI / 180);
 var SIN30 = Math.sin(30 * Math.PI / 180);
+var DIM_COLOR = "#b91c1c";
+var WIT_COLOR = "#e59aa0";
 function iso(p) {
   return [(p[0] - p[1]) * COS30, p[2] - (p[0] + p[1]) * SIN30];
 }
@@ -430414,11 +430839,99 @@ function frameWidth(role) {
   if (role === "pani_patti" || role === "eave_L_channel" || role === "corner_double_angle") return 1;
   return 1.6;
 }
+function buildFrameDimensions(spec) {
+  const lines = [];
+  const labels = [];
+  const ring = spec.members.filter((m) => m.role === "ring_beam");
+  const src = ring.length ? ring : spec.members;
+  if (!src.length) return { lines, labels };
+  let aX = Infinity, bX = -Infinity, aY = Infinity, bY = -Infinity, loZ = Infinity;
+  for (const m of src) for (const p of [m.start, m.end]) {
+    if (p[0] < aX) aX = p[0];
+    if (p[0] > bX) bX = p[0];
+    if (p[1] < aY) aY = p[1];
+    if (p[1] > bY) bY = p[1];
+    if (p[2] < loZ) loZ = p[2];
+  }
+  const baseZ = ring.length ? ring[0].start[2] : loZ;
+  let apexZ = -Infinity;
+  for (const m of spec.members) for (const p of [m.start, m.end]) if (p[2] > apexZ) apexZ = p[2];
+  for (const t of spec.trusses) if (t.apex[2] > apexZ) apexZ = t.apex[2];
+  if (!isFinite(apexZ)) apexZ = baseZ;
+  const boxW = bX - aX, boxL = bY - aY, rise = apexZ - baseZ;
+  const off = Math.max(0.12 * Math.max(boxW, boxL), 12);
+  const addDim = (a, b, text) => {
+    lines.push({ a, b, color: DIM_COLOR, w: 1, tick: true });
+    labels.push({ at: [(a[0] + b[0]) / 2, (a[1] + b[1]) / 2, (a[2] + b[2]) / 2], text });
+  };
+  const addWit = (a, b) => lines.push({ a, b, color: WIT_COLOR, w: 0.5, dash: "3 2", tick: false });
+  {
+    const dy = aY - off;
+    addDim([aX, dy, baseZ], [bX, dy, baseZ], formatDimension(boxW));
+    addWit([aX, aY, baseZ], [aX, dy, baseZ]);
+    addWit([bX, aY, baseZ], [bX, dy, baseZ]);
+  }
+  {
+    const dx = aX - off;
+    addDim([dx, aY, baseZ], [dx, bY, baseZ], formatDimension(boxL));
+    addWit([aX, aY, baseZ], [dx, aY, baseZ]);
+    addWit([aX, bY, baseZ], [dx, bY, baseZ]);
+  }
+  {
+    const cx = aX - off, cy = aY - off;
+    addDim([cx, cy, baseZ], [cx, cy, apexZ], formatDimension(rise));
+    addWit([aX, aY, baseZ], [cx, cy, baseZ]);
+  }
+  if (spec.trusses.length > 1) {
+    const cen = spec.trusses.map((t) => [
+      (t.bottom_left[0] + t.bottom_right[0]) / 2,
+      (t.bottom_left[1] + t.bottom_right[1]) / 2
+    ]);
+    const spanX = Math.max(...cen.map((c) => c[0])) - Math.min(...cen.map((c) => c[0]));
+    const spanY = Math.max(...cen.map((c) => c[1])) - Math.min(...cen.map((c) => c[1]));
+    const axis = spanX >= spanY ? 0 : 1;
+    const pos = cen.map((c) => c[axis]).sort((p, q) => p - q);
+    if (axis === 1) {
+      const dx = bX + off;
+      const marks = [aY, ...pos, bY];
+      for (let i2 = 0; i2 + 1 < marks.length; i2++) {
+        const g = Math.abs(marks[i2 + 1] - marks[i2]);
+        if (g < 0.5) continue;
+        addDim([dx, marks[i2], baseZ], [dx, marks[i2 + 1], baseZ], formatDimension(g));
+      }
+      for (const mk of marks) addWit([bX, mk, baseZ], [dx, mk, baseZ]);
+    } else {
+      const dy = bY + off;
+      const marks = [aX, ...pos, bX];
+      for (let i2 = 0; i2 + 1 < marks.length; i2++) {
+        const g = Math.abs(marks[i2 + 1] - marks[i2]);
+        if (g < 0.5) continue;
+        addDim([marks[i2], dy, baseZ], [marks[i2 + 1], dy, baseZ], formatDimension(g));
+      }
+      for (const mk of marks) addWit([mk, bY, baseZ], [mk, dy, baseZ]);
+    }
+  }
+  return { lines, labels };
+}
+function haloText(x, y, text, opts) {
+  const size = opts.size ?? 10;
+  const weight = opts.weight ?? 600;
+  const halo = opts.halo ?? 3;
+  const xf = x.toFixed(1), yf = y.toFixed(1);
+  const rot = opts.rotate != null ? ` transform="rotate(${opts.rotate.toFixed(1)} ${xf} ${yf})"` : "";
+  const mid2 = opts.middle ? ` dominant-baseline="middle"` : "";
+  const base = `x="${xf}" y="${yf}" text-anchor="middle"${mid2} font-size="${size}" font-weight="${weight}"${rot}`;
+  return `<text ${base} fill="none" stroke="#fdfcfa" stroke-width="${halo}" stroke-linejoin="round">${text}</text>
+<text ${base} fill="${opts.fill}">${text}</text>
+`;
+}
 function v2PerspectivePanel(x0, y0, width, height, spec, opts = {}) {
+  const doDim = opts.dimensions === true;
   const titleH = opts.title ? 40 : 0;
-  const innerPad = 20;
+  const innerPad = doDim ? 40 : 20;
   const drawW = width - 2 * innerPad;
   const drawH = height - titleH - 2 * innerPad;
+  const dim = doDim ? buildFrameDimensions(spec) : { lines: [], labels: [] };
   let minIx = Infinity, maxIx = -Infinity;
   let minIy = Infinity, maxIy = -Infinity;
   const consider = (p) => {
@@ -430433,6 +430946,10 @@ function v2PerspectivePanel(x0, y0, width, height, spec, opts = {}) {
     consider(m.start);
     consider(m.end);
   }
+  for (const wl of dim.lines) {
+    consider(wl.a);
+    consider(wl.b);
+  }
   if (!isFinite(minIx)) return "";
   const isoW = maxIx - minIx || 1;
   const isoH = maxIy - minIy || 1;
@@ -430466,12 +430983,218 @@ function v2PerspectivePanel(x0, y0, width, height, spec, opts = {}) {
     const members = t.members ?? buildTrussMembers(t);
     for (const m of members) svg += line2(m);
   }
+  if (doDim) {
+    const pc = [x0 + width / 2, y0 + height / 2];
+    for (const wl of dim.lines) {
+      const [x1, y1] = toSvg(wl.a);
+      const [x2, y2] = toSvg(wl.b);
+      svg += `<line x1="${x1.toFixed(2)}" y1="${y1.toFixed(2)}" x2="${x2.toFixed(2)}" y2="${y2.toFixed(2)}" stroke="${wl.color}" stroke-width="${wl.w}"${wl.dash ? ` stroke-dasharray="${wl.dash}"` : ""} stroke-linecap="round"/>
+`;
+      if (wl.tick) {
+        let ux = x2 - x1, uy = y2 - y1;
+        const d = Math.hypot(ux, uy) || 1;
+        ux /= d;
+        uy /= d;
+        const px = -uy * 4, py = ux * 4;
+        for (const [tx, ty] of [[x1, y1], [x2, y2]]) {
+          svg += `<line x1="${(tx - px).toFixed(2)}" y1="${(ty - py).toFixed(2)}" x2="${(tx + px).toFixed(2)}" y2="${(ty + py).toFixed(2)}" stroke="${wl.color}" stroke-width="${wl.w}"/>
+`;
+        }
+      }
+    }
+    for (const lb of dim.labels) {
+      const [mx, my] = toSvg(lb.at);
+      let dx = mx - pc[0], dy = my - pc[1];
+      const d = Math.hypot(dx, dy) || 1;
+      dx /= d;
+      dy /= d;
+      const lx = mx + dx * 12, ly = my + dy * 12;
+      svg += haloText(lx, ly + 3, lb.text, { fill: DIM_COLOR, size: 11, weight: 700 });
+    }
+    const majorEnds = [];
+    for (const t of spec.trusses) majorEnds.push(t.apex);
+    for (const mm of spec.members) {
+      if (mm.role === "ridge" || mm.role === "hip" || mm.role === "valley" || mm.role === "ring_beam") {
+        majorEnds.push(mm.start);
+        majorEnds.push(mm.end);
+      }
+    }
+    const segNodes = (m) => {
+      const d = [m.end[0] - m.start[0], m.end[1] - m.start[1], m.end[2] - m.start[2]];
+      const len2 = d[0] * d[0] + d[1] * d[1] + d[2] * d[2];
+      const len = Math.sqrt(len2);
+      if (len < 1e-6) return [0, 1];
+      const raw = [];
+      for (const p of majorEnds) {
+        const t = ((p[0] - m.start[0]) * d[0] + (p[1] - m.start[1]) * d[1] + (p[2] - m.start[2]) * d[2]) / len2;
+        if (t <= 0.02 || t >= 0.98) continue;
+        const proj = [m.start[0] + t * d[0], m.start[1] + t * d[1], m.start[2] + t * d[2]];
+        if (Math.hypot(p[0] - proj[0], p[1] - proj[1], p[2] - proj[2]) < 1) raw.push(t);
+      }
+      raw.sort((a, b) => a - b);
+      const mid2 = [];
+      for (const t of raw) if (!mid2.length || (t - mid2[mid2.length - 1]) * len > 2) mid2.push(t);
+      return [0, ...mid2, 1];
+    };
+    const lerp3 = (a, b, t) => [a[0] + (b[0] - a[0]) * t, a[1] + (b[1] - a[1]) * t, a[2] + (b[2] - a[2]) * t];
+    for (const m of spec.members) {
+      if (m.role !== "ridge" && m.role !== "hip" && m.role !== "valley") continue;
+      const L = Math.hypot(m.end[0] - m.start[0], m.end[1] - m.start[1], m.end[2] - m.start[2]);
+      if (L < 1) continue;
+      const col = FRAME_STROKES[m.role] ?? "#334155";
+      const nodes = segNodes(m);
+      for (let k = 1; k < nodes.length - 1; k++) {
+        const [nx0, ny0] = toSvg(lerp3(m.start, m.end, nodes[k]));
+        const [ex, ey] = toSvg(m.end);
+        const [sx, sy] = toSvg(m.start);
+        let ux = ex - sx, uy = ey - sy;
+        const ul = Math.hypot(ux, uy) || 1;
+        ux /= ul;
+        uy /= ul;
+        svg += `<line x1="${(nx0 + uy * 4).toFixed(1)}" y1="${(ny0 - ux * 4).toFixed(1)}" x2="${(nx0 - uy * 4).toFixed(1)}" y2="${(ny0 + ux * 4).toFixed(1)}" stroke="${col}" stroke-width="1.2"/>
+`;
+      }
+      for (let k = 0; k + 1 < nodes.length; k++) {
+        const segLen = (nodes[k + 1] - nodes[k]) * L;
+        if (segLen < 1) continue;
+        const [x1, y1] = toSvg(lerp3(m.start, m.end, nodes[k]));
+        const [x2, y2] = toSvg(lerp3(m.start, m.end, nodes[k + 1]));
+        const mx = (x1 + x2) / 2, my = (y1 + y2) / 2;
+        let deg = Math.atan2(y2 - y1, x2 - x1) * 180 / Math.PI;
+        if (deg > 90) deg -= 180;
+        else if (deg < -90) deg += 180;
+        let nx = -(y2 - y1), ny = x2 - x1;
+        const nl = Math.hypot(nx, ny) || 1;
+        nx /= nl;
+        ny /= nl;
+        if (ny > 0) {
+          nx = -nx;
+          ny = -ny;
+        }
+        const lx = mx + nx * 8, ly = my + ny * 8;
+        svg += haloText(lx, ly, formatDimension(segLen), { fill: col, size: 10, weight: 600, middle: true, rotate: deg });
+      }
+    }
+    const eaves = spec.members.filter((m) => m.role === "pani_patti");
+    if (eaves.length) {
+      let rminX = Infinity, rmaxX = -Infinity, rminY = Infinity, rmaxY = -Infinity, wallTopZ = -Infinity;
+      for (const m of spec.members) if (m.role === "ring_beam") for (const p of [m.start, m.end]) {
+        if (p[0] < rminX) rminX = p[0];
+        if (p[0] > rmaxX) rmaxX = p[0];
+        if (p[1] < rminY) rminY = p[1];
+        if (p[1] > rmaxY) rmaxY = p[1];
+        if (p[2] > wallTopZ) wallTopZ = p[2];
+      }
+      const halfWall = (spec.framing?.wall_thickness_u ?? 0) / 2;
+      rminX -= halfWall;
+      rmaxX += halfWall;
+      rminY -= halfWall;
+      rmaxY += halfWall;
+      const cx0 = (rminX + rmaxX) / 2, cy0 = (rminY + rmaxY) / 2;
+      const front = eaves.map((m) => ({ m, key: (m.start[0] + m.end[0]) / 2 + (m.start[1] + m.end[1]) / 2 })).sort((a, b) => b.key - a.key).slice(0, 2).map((s) => s.m);
+      const EAVE = "#0e7490";
+      for (const m of front) {
+        const L = Math.hypot(m.end[0] - m.start[0], m.end[1] - m.start[1], m.end[2] - m.start[2]);
+        const [x1, y1] = toSvg(m.start), [x2, y2] = toSvg(m.end);
+        const mx = (x1 + x2) / 2, my = (y1 + y2) / 2;
+        let deg = Math.atan2(y2 - y1, x2 - x1) * 180 / Math.PI;
+        if (deg > 90) deg -= 180;
+        else if (deg < -90) deg += 180;
+        let tx = mx - pc[0], ty = my - pc[1];
+        const tl = Math.hypot(tx, ty) || 1;
+        const lx = mx - tx / tl * 12, ly = my - ty / tl * 12;
+        svg += haloText(lx, ly, `eave ${formatDimension(L)}`, { fill: EAVE, size: 10, weight: 700, middle: true, rotate: deg });
+        const vertical = Math.abs(m.start[0] - m.end[0]) < 1;
+        const s = lerp3(m.start, m.end, 0.28);
+        let inward, oh;
+        if (vertical) {
+          const X = m.start[0];
+          const wallX = X > cx0 ? rmaxX : rminX;
+          oh = Math.abs(X - wallX);
+          inward = [wallX, s[1], s[2]];
+        } else {
+          const Y = m.start[1];
+          const wallY = Y > cy0 ? rmaxY : rminY;
+          oh = Math.abs(Y - wallY);
+          inward = [s[0], wallY, s[2]];
+        }
+        const [ex, ey] = toSvg(s), [ix, iy] = toSvg(inward);
+        svg += `<line x1="${ex.toFixed(1)}" y1="${ey.toFixed(1)}" x2="${ix.toFixed(1)}" y2="${iy.toFixed(1)}" stroke="${EAVE}" stroke-width="1"/>
+`;
+        for (const [tx2, ty2] of [[ex, ey], [ix, iy]]) {
+          let ux = ix - ex, uy = iy - ey;
+          const ul = Math.hypot(ux, uy) || 1;
+          ux /= ul;
+          uy /= ul;
+          svg += `<line x1="${(tx2 - uy * 3).toFixed(1)}" y1="${(ty2 + ux * 3).toFixed(1)}" x2="${(tx2 + uy * 3).toFixed(1)}" y2="${(ty2 - ux * 3).toFixed(1)}" stroke="${EAVE}" stroke-width="1"/>
+`;
+        }
+        const [wx, wy] = toSvg([inward[0], inward[1], wallTopZ]);
+        svg += `<line x1="${ix.toFixed(1)}" y1="${iy.toFixed(1)}" x2="${wx.toFixed(1)}" y2="${wy.toFixed(1)}" stroke="${EAVE}" stroke-width="0.5" stroke-dasharray="2 2"/>
+`;
+        const omx = (ex + ix) / 2, omy = (ey + iy) / 2;
+        svg += haloText(omx, omy - 4, `\u21A4 ${formatDimension(oh)}`, { fill: EAVE, size: 9, weight: 600, halo: 2.5 });
+      }
+    }
+    svg += `<text x="${(x0 + 12).toFixed(1)}" y="${(y0 + height - 12).toFixed(1)}" text-anchor="start" font-size="9" fill="#b91c1c">red = overall + truss spacing \xB7 brown = ridge &amp; hip segments \xB7 <tspan fill="#0e7490">teal = front eave length + overhang from wall</tspan></text>
+`;
+  }
   svg += `</g>
 `;
   return svg;
 }
 
+// ../editor/src/svg2d/roof/v2/panelDraw.ts
+function escapeXml2(s) {
+  return s.replace(
+    /[<>&'"]/g,
+    (c) => c === "<" ? "&lt;" : c === ">" ? "&gt;" : c === "&" ? "&amp;" : c === "'" ? "&#39;" : "&quot;"
+  );
+}
+function dimLineH(x1, x2, y, label) {
+  const lo = Math.min(x1, x2), hi = Math.max(x1, x2);
+  return `<line x1="${lo.toFixed(1)}" y1="${y.toFixed(1)}" x2="${hi.toFixed(1)}" y2="${y.toFixed(1)}" stroke="#334155" stroke-width="0.8"/>
+<line x1="${lo.toFixed(1)}" y1="${(y - 3).toFixed(1)}" x2="${lo.toFixed(1)}" y2="${(y + 3).toFixed(1)}" stroke="#334155" stroke-width="0.8"/>
+<line x1="${hi.toFixed(1)}" y1="${(y - 3).toFixed(1)}" x2="${hi.toFixed(1)}" y2="${(y + 3).toFixed(1)}" stroke="#334155" stroke-width="0.8"/>
+<text x="${((lo + hi) / 2).toFixed(1)}" y="${(y - 4).toFixed(1)}" text-anchor="middle" font-size="10" fill="#334155">${escapeXml2(label)}</text>
+`;
+}
+function dimLineV(y1, y2, x, label) {
+  const lo = Math.min(y1, y2), hi = Math.max(y1, y2);
+  return `<line x1="${x.toFixed(1)}" y1="${lo.toFixed(1)}" x2="${x.toFixed(1)}" y2="${hi.toFixed(1)}" stroke="#334155" stroke-width="0.8"/>
+<line x1="${(x - 3).toFixed(1)}" y1="${lo.toFixed(1)}" x2="${(x + 3).toFixed(1)}" y2="${lo.toFixed(1)}" stroke="#334155" stroke-width="0.8"/>
+<line x1="${(x - 3).toFixed(1)}" y1="${hi.toFixed(1)}" x2="${(x + 3).toFixed(1)}" y2="${hi.toFixed(1)}" stroke="#334155" stroke-width="0.8"/>
+<text x="${(x + 4).toFixed(1)}" y="${((lo + hi) / 2).toFixed(1)}" text-anchor="middle" dominant-baseline="middle" font-size="10" fill="#334155" transform="rotate(-90 ${(x + 4).toFixed(1)} ${((lo + hi) / 2).toFixed(1)})">${escapeXml2(label)}</text>
+`;
+}
+function panelFrame(x0, y0, width, height, titleH, title, cls) {
+  const cx = x0 + width / 2;
+  return `<g class="${cls}">
+<rect x="${x0}" y="${y0}" width="${width}" height="${height}" fill="#fdfcfa" stroke="#333" stroke-width="1"/>
+<rect x="${x0}" y="${y0}" width="${width}" height="${titleH}" fill="#f2ede4" stroke="#333" stroke-width="1"/>
+<text x="${cx}" y="${y0 + 26}" text-anchor="middle" font-size="14" font-weight="600" fill="#222">${escapeXml2(title)}</text>
+`;
+}
+function keyPlanDisc(cx, cy, r2, letter, fill, stroke, textColor) {
+  return `<circle cx="${cx.toFixed(1)}" cy="${cy.toFixed(1)}" r="${r2}" fill="${fill}" stroke="${stroke}" stroke-width="1.5"/><text x="${cx.toFixed(1)}" y="${(cy + r2 * 0.36).toFixed(1)}" text-anchor="middle" font-size="${Math.round(r2 * 1.1)}" font-weight="700" fill="${textColor}">${escapeXml2(letter)}</text>`;
+}
+function keyPlanTag(xRight, yTop, label, fill, textColor) {
+  const w = 12 + label.length * 8;
+  const x = xRight - w;
+  return `<rect x="${x.toFixed(1)}" y="${yTop.toFixed(1)}" width="${w}" height="22" rx="5" fill="${fill}" stroke="#334155" stroke-width="0.9"/><text x="${(x + w / 2).toFixed(1)}" y="${(yTop + 15.5).toFixed(1)}" text-anchor="middle" font-size="13" font-weight="800" fill="${textColor}">${escapeXml2(label)}</text>`;
+}
+function sectionFtLabel(s) {
+  if (!s) return null;
+  const inch = (ft) => {
+    const totalIn = Math.round(ft * 12);
+    if (totalIn % 12 === 0 && totalIn >= 12) return `${totalIn / 12}'`;
+    return `${totalIn}"`;
+  };
+  return `${inch(s[0])}\xD7${inch(s[1])}`;
+}
+
 // ../editor/src/svg2d/roof/v2/sectionPanel.ts
+init_format();
 function planePolygonSectionSegments(poly, cutAxis, cutCoord) {
   if (poly.length < 3) return [];
   const idx = cutAxis === "x" ? 0 : 1;
@@ -430508,6 +431231,26 @@ function planePolygonSectionSegments(poly, cutAxis, cutCoord) {
   }
   return segs;
 }
+function trussMembers(t) {
+  if (t.members && t.members.length) return t.members;
+  return (t.kind === "mono_pitch" ? buildMonoPitchTrussMembers : buildFinkTrussMembers)(t);
+}
+function trussForSection(spec, cutAxis) {
+  const horIdx = cutAxis === "x" ? 1 : 0;
+  let best = null;
+  let bestScore = 0.7;
+  for (const t of spec.trusses) {
+    const dx = t.bottom_right[0] - t.bottom_left[0];
+    const dy = t.bottom_right[1] - t.bottom_left[1];
+    const len = Math.hypot(dx, dy) || 1;
+    const along = Math.abs((horIdx === 0 ? dx : dy) / len);
+    if (along > bestScore) {
+      bestScore = along;
+      best = t;
+    }
+  }
+  return best;
+}
 var PLANE_STROKES = {
   slope: "#8B4513",
   hip_face: "#8B4513",
@@ -430518,8 +431261,10 @@ var PLANE_STROKES = {
 function v2SectionPanel(x0, y0, width, height, spec, opts) {
   const titleH = opts.title ? 40 : 0;
   const innerPad = 20;
-  const drawW = width - 2 * innerPad;
-  const drawH = height - titleH - 2 * innerPad;
+  const dimL = opts.dimensions ? 46 : 0;
+  const dimB = opts.dimensions ? 58 : 0;
+  const drawW = width - 2 * innerPad - dimL;
+  const drawH = height - titleH - 2 * innerPad - dimB;
   const allSegs = [];
   for (const p of spec.planes) {
     if (p.role === "parapet") continue;
@@ -430547,7 +431292,7 @@ function v2SectionPanel(x0, y0, width, height, spec, opts) {
   const horSpan = maxH - minH || 1;
   const zSpan = maxZ - minZ || 1;
   const scale = Math.min(drawW / horSpan, drawH / zSpan);
-  const offX = x0 + innerPad + (drawW - horSpan * scale) / 2 - minH * scale;
+  const offX = x0 + innerPad + dimL + (drawW - horSpan * scale) / 2 - minH * scale;
   const offY = y0 + titleH + innerPad + (drawH - zSpan * scale) / 2 + maxZ * scale;
   const toSvg = (p) => [
     offX + p[horIdx] * scale,
@@ -430561,6 +431306,7 @@ function v2SectionPanel(x0, y0, width, height, spec, opts) {
     svg += `<text x="${x0 + width / 2}" y="${y0 + 24}" text-anchor="middle" font-size="14" font-weight="bold" fill="#222">${opts.title}</text>
 `;
   }
+  if (opts.keyLabel) svg += keyPlanDisc(x0 + width - 26, y0 + 20, 13, opts.keyLabel, "#ffffff", "#7c3aed", "#7c3aed");
   if (opts.wallTopZ != null) {
     const [x1, y1] = toSvg([minH, minH, opts.wallTopZ]);
     const [x2, y2] = toSvg([maxH, maxH, opts.wallTopZ]);
@@ -430593,6 +431339,66 @@ function v2SectionPanel(x0, y0, width, height, spec, opts) {
     const color = MEMBER_MARK_COLORS[m.role] ?? "#334155";
     const half = 3;
     svg += `<rect x="${(sx - half).toFixed(2)}" y="${(sy - half).toFixed(2)}" width="${(half * 2).toFixed(2)}" height="${(half * 2).toFixed(2)}" fill="${color}" stroke="#111" stroke-width="0.4"/>
+`;
+  }
+  if (opts.overlayTruss) {
+    const t = trussForSection(spec, opts.cutAxis);
+    if (t) {
+      const kindLabel = (t.kind ?? "fink") === "mono_pitch" ? "mono-pitch" : "fink";
+      for (const m of trussMembers(t)) {
+        const isChord = m.role === "truss_top_chord" || m.role === "truss_bottom_chord";
+        const [x1, y1] = toSvg(m.start);
+        const [x2, y2] = toSvg(m.end);
+        svg += `<line x1="${x1.toFixed(2)}" y1="${y1.toFixed(2)}" x2="${x2.toFixed(2)}" y2="${y2.toFixed(2)}" stroke="${isChord ? "#7c2d12" : "#b45309"}" stroke-width="${isChord ? 1.8 : 1}" stroke-dasharray="${isChord ? "6 3" : "3 3"}" stroke-linecap="round"/>
+`;
+      }
+      svg += `<text x="${(x0 + width - 12).toFixed(1)}" y="${(y0 + height - 12).toFixed(1)}" text-anchor="end" font-size="9" fill="#7c2d12">\u2014 \u2014 ${kindLabel} truss profile at this bay (see truss drawing for member lengths)</text>
+`;
+    }
+  }
+  if (opts.dimensions) {
+    const hz = (h, z2) => {
+      const p = [0, 0, z2];
+      p[horIdx] = h;
+      return p;
+    };
+    const ringHs = [];
+    for (const m of spec.members) if (m.role === "ring_beam") ringHs.push(m.start[horIdx], m.end[horIdx]);
+    const half = (spec.framing?.wall_thickness_u ?? 0) / 2;
+    const eMinH = minH, eMaxH = maxH;
+    const rMinH = (ringHs.length ? Math.min(...ringHs) : eMinH) - half;
+    const rMaxH = (ringHs.length ? Math.max(...ringHs) : eMaxH) + half;
+    let segMinZ = Infinity, segMaxZ = -Infinity;
+    for (const { seg: [a, b] } of allSegs) for (const p of [a, b]) {
+      if (p[2] < segMinZ) segMinZ = p[2];
+      if (p[2] > segMaxZ) segMaxZ = p[2];
+    }
+    const eaveZ = isFinite(segMinZ) ? segMinZ : minZ;
+    const ridgeZ = isFinite(segMaxZ) ? segMaxZ : maxZ;
+    const wtZ = opts.wallTopZ ?? eaveZ;
+    const EAVE = "#0e7490";
+    const el = toSvg(hz(eMinH, eaveZ)), er = toSvg(hz(eMaxH, eaveZ));
+    svg += `<line x1="${el[0].toFixed(1)}" y1="${el[1].toFixed(1)}" x2="${er[0].toFixed(1)}" y2="${er[1].toFixed(1)}" stroke="${EAVE}" stroke-width="1" stroke-dasharray="4 2"/>
+`;
+    const drop = wtZ - eaveZ + Math.max((ridgeZ - eaveZ) * 0.18, 8);
+    for (const h of [rMinH, rMaxH]) {
+      const a = toSvg(hz(h, wtZ)), b = toSvg(hz(h, wtZ - drop));
+      svg += `<line x1="${a[0].toFixed(1)}" y1="${a[1].toFixed(1)}" x2="${b[0].toFixed(1)}" y2="${b[1].toFixed(1)}" stroke="#8a6a3f" stroke-width="1.4"/>
+`;
+    }
+    const wallBottomY = toSvg(hz(rMinH, wtZ - drop))[1];
+    const y1 = Math.max(el[1], wallBottomY) + 22;
+    const y2 = y1 + 22;
+    const sx = (h) => toSvg(hz(h, eaveZ))[0];
+    if (rMinH - eMinH > 0.5) svg += dimLineH(sx(eMinH), sx(rMinH), y1, formatDimension(rMinH - eMinH));
+    if (eMaxH - rMaxH > 0.5) svg += dimLineH(sx(rMaxH), sx(eMaxH), y1, formatDimension(eMaxH - rMaxH));
+    svg += dimLineH(sx(rMinH), sx(rMaxH), y1, `wall ${formatDimension(rMaxH - rMinH)}`);
+    svg += dimLineH(sx(eMinH), sx(eMaxH), y2, `eave ${formatDimension(eMaxH - eMinH)}`);
+    if (ridgeZ - wtZ > 0.5) {
+      const riseX = Math.min(el[0], er[0]) - 26;
+      svg += dimLineV(toSvg(hz(eMinH, wtZ))[1], toSvg(hz(eMinH, ridgeZ))[1], riseX, `rise ${formatDimension(ridgeZ - wtZ)}`);
+    }
+    svg += `<text x="${(x0 + 12).toFixed(1)}" y="${(y0 + height - 12).toFixed(1)}" text-anchor="start" font-size="9" fill="${EAVE}">\u2014 \u2014 eave datum \xB7 brown = wall</text>
 `;
   }
   svg += `</g>
@@ -430745,7 +431551,7 @@ function groupFaces(spec) {
     (a, b) => b.geom.uMax - b.geom.uMin - (a.geom.uMax - a.geom.uMin)
   );
 }
-function v2FacePanel(x0, y0, width, height, group) {
+function v2FacePanel(x0, y0, width, height, group, keyLabel) {
   const titleH = 40;
   const innerPad = 30;
   const drawW = width - 2 * innerPad;
@@ -430770,8 +431576,9 @@ function v2FacePanel(x0, y0, width, height, group) {
 `;
   svg += `<rect x="${x0}" y="${y0}" width="${width}" height="${titleH}" fill="#f2ede4" stroke="#333" stroke-width="1"/>
 `;
-  svg += `<text x="${x0 + width / 2}" y="${y0 + 26}" text-anchor="middle" font-size="14" font-weight="600" fill="#222">${escapeXml2(title)}</text>
+  svg += `<text x="${x0 + width / 2}" y="${y0 + 26}" text-anchor="middle" font-size="14" font-weight="600" fill="#222">${escapeXml3(title)}</text>
 `;
+  if (keyLabel) svg += keyPlanTag(x0 + width - 12, y0 + 9, keyLabel, "#eef2f7", "#334155");
   const outlinePts = g.uv.map(toSvg).map(([x, y]) => `${x.toFixed(1)},${y.toFixed(1)}`).join(" ");
   svg += `<polygon points="${outlinePts}" fill="#f5e0c9" stroke="#5a2e0b" stroke-width="1.5" fill-opacity="0.5"/>
 `;
@@ -430874,10 +431681,523 @@ function buildTitle(group) {
   const ids = group.planes.map((p) => p.id).join(", ");
   return `${first2.role.toUpperCase()}S (${shape}, ${n3} identical) \u2014 ${ids}`;
 }
-function escapeXml2(s) {
+function escapeXml3(s) {
   return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
 }
 
+// ../editor/src/svg2d/roof/v2/trussPanel.ts
+init_format();
+function escapeXml4(s) {
+  return s.replace(
+    /[<>&'"]/g,
+    (c) => c === "<" ? "&lt;" : c === ">" ? "&gt;" : c === "&" ? "&amp;" : c === "'" ? "&#39;" : "&quot;"
+  );
+}
+var len3 = (a, b) => Math.hypot(a[0] - b[0], a[1] - b[1], a[2] - b[2]);
+function trussMembers2(t) {
+  if (t.members && t.members.length) return t.members;
+  return (t.kind === "mono_pitch" ? buildMonoPitchTrussMembers : buildFinkTrussMembers)(
+    { ...t, id: t.id, source_segment_id: t.source_segment_id }
+  );
+}
+function trussGeom(t) {
+  const bl = t.bottom_left, br = t.bottom_right;
+  const span = Math.hypot(br[0] - bl[0], br[1] - bl[1]);
+  const rise = t.apex[2] - bl[2];
+  return { span, rise, kind: t.kind ?? "fink" };
+}
+function groupTrusses(spec) {
+  const groups = /* @__PURE__ */ new Map();
+  for (const t of spec.trusses) {
+    const g = trussGeom(t);
+    const r2 = (x) => Math.round(x * 10) / 10;
+    const sig = `${g.kind}|${r2(g.span)}|${r2(g.rise)}`;
+    const existing = groups.get(sig);
+    if (existing) {
+      existing.count += 1;
+    } else {
+      groups.set(sig, { signature: sig, rep: t, members: trussMembers2(t), geom: g, count: 1 });
+    }
+  }
+  return [...groups.values()].sort((a, b) => b.geom.span - a.geom.span);
+}
+function v2TrussPanel(x0, y0, width, height, group) {
+  const titleH = 40;
+  const innerPad = 34;
+  const drawW = width - 2 * innerPad;
+  const drawH = height - titleH - 2 * innerPad - 20;
+  const t = group.rep;
+  const bl = t.bottom_left;
+  const br = t.bottom_right;
+  const { span, rise, kind } = group.geom;
+  const dx = br[0] - bl[0], dy = br[1] - bl[1];
+  const horiz = Math.hypot(dx, dy) || 1;
+  const ux = dx / horiz, uy = dy / horiz;
+  const baseZ = bl[2];
+  const toUV = (p) => [
+    (p[0] - bl[0]) * ux + (p[1] - bl[1]) * uy,
+    p[2] - baseZ
+  ];
+  const scale = Math.min(drawW / (span || 1), drawH / (rise || 1)) * 0.8;
+  const cx = x0 + width / 2;
+  const cy = y0 + titleH + innerPad + drawH / 2;
+  const toSvg = (uv) => [
+    cx + (uv[0] - span / 2) * scale,
+    cy - (uv[1] - rise / 2) * scale
+  ];
+  const pitchDeg = Math.atan2(rise, span / 2) * 180 / Math.PI;
+  const nice = kind === "mono_pitch" ? "MONO-PITCH TRUSS" : "FINK TRUSS";
+  const title = `${nice} \u2014 Elevation${group.count > 1 ? `  (\xD7 ${group.count} identical)` : ""}`;
+  let svg = `<g class="v2-truss-panel">
+`;
+  svg += `<rect x="${x0}" y="${y0}" width="${width}" height="${height}" fill="#fdfcfa" stroke="#333" stroke-width="1"/>
+`;
+  svg += `<rect x="${x0}" y="${y0}" width="${width}" height="${titleH}" fill="#f2ede4" stroke="#333" stroke-width="1"/>
+`;
+  svg += `<text x="${cx}" y="${y0 + 26}" text-anchor="middle" font-size="14" font-weight="600" fill="#222">${escapeXml4(title)}</text>
+`;
+  const isChord = (m) => m.role === "truss_top_chord" || m.role === "truss_bottom_chord";
+  for (const m of group.members) {
+    const [x1, y1] = toSvg(toUV(m.start));
+    const [x2, y2] = toSvg(toUV(m.end));
+    const stroke = isChord(m) ? "#5a2e0b" : "#b45309";
+    const sw = isChord(m) ? 2.2 : 1.2;
+    svg += `<line x1="${x1.toFixed(1)}" y1="${y1.toFixed(1)}" x2="${x2.toFixed(1)}" y2="${y2.toFixed(1)}" stroke="${stroke}" stroke-width="${sw}" stroke-linecap="round"/>
+`;
+  }
+  const seen = /* @__PURE__ */ new Set();
+  for (const m of group.members) {
+    const L = len3(m.start, m.end);
+    if (L < 1) continue;
+    const a = toSvg(toUV(m.start));
+    const b = toSvg(toUV(m.end));
+    const mx = (a[0] + b[0]) / 2, my = (a[1] + b[1]) / 2;
+    let deg = Math.atan2(b[1] - a[1], b[0] - a[0]) * 180 / Math.PI;
+    if (deg > 90) deg -= 180;
+    else if (deg < -90) deg += 180;
+    let nx = -(b[1] - a[1]), ny = b[0] - a[0];
+    const nl = Math.hypot(nx, ny) || 1;
+    nx /= nl;
+    ny /= nl;
+    if (ny > 0) {
+      nx = -nx;
+      ny = -ny;
+    }
+    const lx = mx + nx * 9, ly = my + ny * 9;
+    const key = `${Math.round(L)}|${Math.round(Math.abs(deg))}`;
+    if (seen.has(key) && isChord(m) === false) continue;
+    seen.add(key);
+    svg += `<text x="${lx.toFixed(1)}" y="${ly.toFixed(1)}" text-anchor="middle" dominant-baseline="middle" font-size="10" fill="#7c2d12" transform="rotate(${deg.toFixed(1)} ${lx.toFixed(1)} ${ly.toFixed(1)})">${formatDimension(L)}</text>
+`;
+  }
+  const blS = toSvg(toUV(bl));
+  const brS = toSvg(toUV(br));
+  const spanY = Math.max(blS[1], brS[1]) + 26;
+  svg += dimLineH2(blS[0], brS[0], spanY, `span ${formatDimension(span)}`);
+  svg += `<line x1="${blS[0].toFixed(1)}" y1="${blS[1].toFixed(1)}" x2="${blS[0].toFixed(1)}" y2="${spanY.toFixed(1)}" stroke="#94a3b8" stroke-width="0.5"/>
+`;
+  svg += `<line x1="${brS[0].toFixed(1)}" y1="${brS[1].toFixed(1)}" x2="${brS[0].toFixed(1)}" y2="${spanY.toFixed(1)}" stroke="#94a3b8" stroke-width="0.5"/>
+`;
+  const apexS = toSvg(toUV(t.apex));
+  const baseAtApex = toSvg([span / 2, 0]);
+  const riseX = apexS[0] + (kind === "mono_pitch" ? 22 : Math.min(brS[0] - apexS[0] + 22, 40));
+  svg += dimLineV2(apexS[1], baseAtApex[1], riseX, `rise ${formatDimension(rise)}`);
+  svg += `<line x1="${apexS[0].toFixed(1)}" y1="${apexS[1].toFixed(1)}" x2="${riseX.toFixed(1)}" y2="${apexS[1].toFixed(1)}" stroke="#94a3b8" stroke-width="0.5" stroke-dasharray="2 2"/>
+`;
+  svg += `<line x1="${baseAtApex[0].toFixed(1)}" y1="${baseAtApex[1].toFixed(1)}" x2="${riseX.toFixed(1)}" y2="${baseAtApex[1].toFixed(1)}" stroke="#94a3b8" stroke-width="0.5" stroke-dasharray="2 2"/>
+`;
+  svg += `<text x="${cx}" y="${(y0 + titleH + 18).toFixed(1)}" text-anchor="middle" font-size="13" font-weight="600" fill="#8B4513">TOP-CHORD PITCH: ${pitchDeg.toFixed(1)}\xB0</text>
+`;
+  const chord = group.members.find(isChord)?.section_size ?? DEFAULT_TRUSS_SECTION.chord_size_in;
+  const web = group.members.find((m) => m.role === "truss_web")?.section_size ?? DEFAULT_TRUSS_SECTION.web_size_in;
+  const secStr = (s) => `${s[0]}"\xD7${s[1]}"`;
+  const footY = y0 + height - 12;
+  svg += `<text x="${(x0 + 12).toFixed(1)}" y="${footY.toFixed(1)}" text-anchor="start" font-size="10" fill="#475569">chord ${secStr(chord)} \xB7 web ${secStr(web)}${group.rep.members?.[0]?.material ? " \xB7 " + escapeXml4(group.rep.members[0].material) : ""}</text>
+`;
+  svg += `<text x="${(x0 + width - 12).toFixed(1)}" y="${footY.toFixed(1)}" text-anchor="end" font-size="9" fill="#94a3b8">lengths = true member lengths (for fabrication)</text>
+`;
+  svg += `</g>
+`;
+  return svg;
+}
+function dimLineH2(x1, x2, y, label) {
+  const lo = Math.min(x1, x2), hi = Math.max(x1, x2);
+  return `<line x1="${lo.toFixed(1)}" y1="${y.toFixed(1)}" x2="${hi.toFixed(1)}" y2="${y.toFixed(1)}" stroke="#334155" stroke-width="0.8"/>
+<line x1="${lo.toFixed(1)}" y1="${(y - 3).toFixed(1)}" x2="${lo.toFixed(1)}" y2="${(y + 3).toFixed(1)}" stroke="#334155" stroke-width="0.8"/>
+<line x1="${hi.toFixed(1)}" y1="${(y - 3).toFixed(1)}" x2="${hi.toFixed(1)}" y2="${(y + 3).toFixed(1)}" stroke="#334155" stroke-width="0.8"/>
+<text x="${((lo + hi) / 2).toFixed(1)}" y="${(y - 4).toFixed(1)}" text-anchor="middle" font-size="10" fill="#334155">${escapeXml4(label)}</text>
+`;
+}
+function dimLineV2(y1, y2, x, label) {
+  const lo = Math.min(y1, y2), hi = Math.max(y1, y2);
+  return `<line x1="${x.toFixed(1)}" y1="${lo.toFixed(1)}" x2="${x.toFixed(1)}" y2="${hi.toFixed(1)}" stroke="#334155" stroke-width="0.8"/>
+<line x1="${(x - 3).toFixed(1)}" y1="${lo.toFixed(1)}" x2="${(x + 3).toFixed(1)}" y2="${lo.toFixed(1)}" stroke="#334155" stroke-width="0.8"/>
+<line x1="${(x - 3).toFixed(1)}" y1="${hi.toFixed(1)}" x2="${(x + 3).toFixed(1)}" y2="${hi.toFixed(1)}" stroke="#334155" stroke-width="0.8"/>
+<text x="${(x + 4).toFixed(1)}" y="${((lo + hi) / 2).toFixed(1)}" text-anchor="middle" dominant-baseline="middle" font-size="10" fill="#334155" transform="rotate(-90 ${(x + 4).toFixed(1)} ${((lo + hi) / 2).toFixed(1)})">${escapeXml4(label)}</text>
+`;
+}
+
+// ../editor/src/svg2d/roof/v2/frameDimPanel.ts
+init_format();
+function membersBounds(members) {
+  let minX = Infinity, maxX = -Infinity, minY = Infinity, maxY = -Infinity;
+  for (const m of members) {
+    for (const p of [m.start, m.end]) {
+      if (p[0] < minX) minX = p[0];
+      if (p[0] > maxX) maxX = p[0];
+      if (p[1] < minY) minY = p[1];
+      if (p[1] > maxY) maxY = p[1];
+    }
+  }
+  if (!isFinite(minX)) return null;
+  return { minX, maxX, minY, maxY };
+}
+function v2FrameDimPanel(x0, y0, width, height, spec) {
+  const titleH = 40;
+  const padL = 104, padR = 40, padT = titleH + 30, padB = 96;
+  const drawW = width - padL - padR;
+  const drawH = height - padT - padB;
+  const ring = spec.members.filter((m) => m.role === "ring_beam");
+  const ridges = spec.members.filter((m) => m.role === "ridge");
+  const hips = spec.members.filter((m) => m.role === "hip");
+  const ties = spec.members.filter((m) => m.role === "tie_beam");
+  const eaves = spec.members.filter((m) => m.role === "pani_patti");
+  const trusses = spec.trusses;
+  const datum = membersBounds(ring.length ? ring : spec.members);
+  if (!datum) return panelFrame(x0, y0, width, height, titleH, "Main frame \u2014 dimensions", "v2-frame-dim") + "</g>\n";
+  const { minX, maxX, minY, maxY } = datum;
+  const spanX = maxX - minX || 1;
+  const spanY = maxY - minY || 1;
+  const half = (spec.framing?.wall_thickness_u ?? 0) / 2;
+  const wallSpanX = spanX + 2 * half, wallSpanY = spanY + 2 * half;
+  const fit = membersBounds([...ring, ...hips, ...ridges, ...ties, ...eaves]) ?? datum;
+  const fSpanX = fit.maxX - fit.minX || 1;
+  const fSpanY = fit.maxY - fit.minY || 1;
+  const scale = Math.min(drawW / fSpanX, drawH / fSpanY);
+  const offX = x0 + padL + (drawW - fSpanX * scale) / 2 - fit.minX * scale;
+  const offY = y0 + padT + (drawH - fSpanY * scale) / 2 - fit.minY * scale;
+  const toSvg = (p) => [
+    offX + p[0] * scale,
+    offY + p[1] * scale
+  ];
+  const title = "MAIN FRAME \u2014 Fabrication dimensions (wall outer face = floor plan \xB7 ring on wall centre)";
+  let svg = panelFrame(x0, y0, width, height, titleH, title, "v2-frame-dim");
+  const line2 = (a, b, stroke, w, dash) => `<line x1="${a[0].toFixed(1)}" y1="${a[1].toFixed(1)}" x2="${b[0].toFixed(1)}" y2="${b[1].toFixed(1)}" stroke="${stroke}" stroke-width="${w}"${dash ? ` stroke-dasharray="${dash}"` : ""} stroke-linecap="round"/>
+`;
+  const c0 = toSvg([minX, minY]);
+  const c1 = toSvg([maxX, maxY]);
+  const f0 = toSvg([fit.minX, fit.minY]);
+  const f1 = toSvg([fit.maxX, fit.maxY]);
+  const ringBottom = Math.max(c0[1], c1[1]), ringLeft = Math.min(c0[0], c1[0]);
+  const fullBottom = Math.max(f0[1], f1[1]), fullLeft = Math.min(f0[0], f1[0]);
+  const rectX = Math.min(c0[0], c1[0]), rectY = Math.min(c0[1], c1[1]);
+  const rectW = Math.abs(c1[0] - c0[0]), rectH = Math.abs(c1[1] - c0[1]);
+  svg += `<rect x="${rectX.toFixed(1)}" y="${rectY.toFixed(1)}" width="${rectW.toFixed(1)}" height="${rectH.toFixed(1)}" fill="#ecfdf5" stroke="none"/>
+`;
+  for (const m of ring) svg += line2(toSvg(m.start), toSvg(m.end), "#16a34a", 3);
+  for (const m of eaves) svg += line2(toSvg(m.start), toSvg(m.end), "#94a3b8", 1.2);
+  for (const m of hips) svg += line2(toSvg(m.start), toSvg(m.end), "#ea580c", 1.4, "5 3");
+  for (const m of ridges) svg += line2(toSvg(m.start), toSvg(m.end), "#dc2626", 2, "6 3");
+  for (const m of ties) svg += line2(toSvg(m.start), toSvg(m.end), "#0ea5e9", 1.2, "3 3");
+  const centroid = (i2) => {
+    const t = trusses[i2];
+    return (t.bottom_left[0] + t.bottom_right[0] + t.apex[0]) / 3;
+  };
+  const centroidY = (i2) => {
+    const t = trusses[i2];
+    return (t.bottom_left[1] + t.bottom_right[1] + t.apex[1]) / 3;
+  };
+  let spreadX = 0, spreadY = 0;
+  if (trusses.length > 1) {
+    const xs = trusses.map((_, i2) => centroid(i2));
+    const ys = trusses.map((_, i2) => centroidY(i2));
+    spreadX = Math.max(...xs) - Math.min(...xs);
+    spreadY = Math.max(...ys) - Math.min(...ys);
+  }
+  const distAxis = spreadX >= spreadY ? 0 : 1;
+  const stations = trusses.map((t, i2) => ({ i: i2, pos: distAxis === 0 ? centroid(i2) : centroidY(i2), t })).sort((a, b) => a.pos - b.pos);
+  stations.forEach((s, k) => {
+    const a = toSvg(s.t.bottom_left);
+    const b = toSvg(s.t.bottom_right);
+    svg += line2(a, b, "#7c2d12", 2);
+    const lx = (a[0] + b[0]) / 2, ly = (a[1] + b[1]) / 2;
+    svg += `<circle cx="${lx.toFixed(1)}" cy="${ly.toFixed(1)}" r="8" fill="#fff7ed" stroke="#7c2d12" stroke-width="0.8"/>
+`;
+    svg += `<text x="${lx.toFixed(1)}" y="${(ly + 3).toFixed(1)}" text-anchor="middle" font-size="9" font-weight="700" fill="#7c2d12">T${k + 1}</text>
+`;
+  });
+  const chainY = fullBottom + 20;
+  const edgeLo = distAxis === 0 ? minX : minY;
+  const edgeHi = distAxis === 0 ? maxX : maxY;
+  const svgOf = (pos) => distAxis === 0 ? toSvg([pos, minY])[0] : toSvg([minX, pos])[1];
+  if (distAxis === 0) {
+    const marks = [edgeLo, ...stations.map((s) => s.pos), edgeHi];
+    for (let j = 0; j + 1 < marks.length; j++) {
+      const gap = Math.abs(marks[j + 1] - marks[j]);
+      if (gap < 0.5) continue;
+      svg += dimLineH(svgOf(marks[j]), svgOf(marks[j + 1]), chainY, formatDimension(gap));
+    }
+    for (const mk of marks) {
+      const sx = svgOf(mk);
+      svg += line2([sx, ringBottom], [sx, chainY], "#94a3b8", 0.5, "2 2");
+    }
+    svg += dimLineH(toSvg([minX - half, minY])[0], toSvg([maxX + half, minY])[0], chainY + 22, `WALL WIDTH ${formatDimension(wallSpanX)}`);
+    svg += dimLineV(toSvg([minX, minY - half])[1], toSvg([minX, maxY + half])[1], fullLeft - 24, `WALL LENGTH ${formatDimension(wallSpanY)}`);
+  } else {
+    const chainX = fullLeft - 20;
+    const marks = [edgeLo, ...stations.map((s) => s.pos), edgeHi];
+    for (let j = 0; j + 1 < marks.length; j++) {
+      const gap = Math.abs(marks[j + 1] - marks[j]);
+      if (gap < 0.5) continue;
+      svg += dimLineV(svgOf(marks[j]), svgOf(marks[j + 1]), chainX, formatDimension(gap));
+    }
+    for (const mk of marks) {
+      const sy = svgOf(mk);
+      svg += line2([ringLeft, sy], [chainX, sy], "#94a3b8", 0.5, "2 2");
+    }
+    svg += dimLineV(toSvg([minX, minY - half])[1], toSvg([minX, maxY + half])[1], chainX - 22, `WALL LENGTH ${formatDimension(wallSpanY)}`);
+    svg += dimLineH(toSvg([minX - half, minY])[0], toSvg([maxX + half, minY])[0], fullBottom + 20, `WALL WIDTH ${formatDimension(wallSpanX)}`);
+  }
+  if (eaves.length) {
+    const half2 = (spec.framing?.wall_thickness_u ?? 0) / 2;
+    const wfMinX = minX - half2, wfMaxX = maxX + half2, wfMinY = minY - half2, wfMaxY = maxY + half2;
+    const w0 = toSvg([wfMinX, wfMinY]), w1 = toSvg([wfMaxX, wfMaxY]);
+    const wfL = Math.min(w0[0], w1[0]), wfR = Math.max(w0[0], w1[0]);
+    const wfT = Math.min(w0[1], w1[1]), wfB = Math.max(w0[1], w1[1]);
+    const midXsvg = (wfL + wfR) / 2, midYsvg = (wfT + wfB) / 2;
+    if (half2 > 0.01) svg += `<rect x="${wfL.toFixed(1)}" y="${wfT.toFixed(1)}" width="${(wfR - wfL).toFixed(1)}" height="${(wfB - wfT).toFixed(1)}" fill="none" stroke="#8a6a3f" stroke-width="0.9"/>
+`;
+    const eW = fit.maxX - fit.minX, eL = fit.maxY - fit.minY;
+    svg += dimLineH(f0[0], f1[0], fullBottom + 42, `EAVE WIDTH ${formatDimension(eW)}`);
+    svg += dimLineV(f0[1], f1[1], fullLeft - 66, `EAVE LENGTH ${formatDimension(eL)}`);
+    const ohL = wfMinX - fit.minX, ohR = fit.maxX - wfMaxX, ohT = wfMinY - fit.minY, ohB = fit.maxY - wfMaxY;
+    if (ohL > 0.5) svg += dimLineH(f0[0], wfL, midYsvg, formatDimension(ohL));
+    if (ohR > 0.5) svg += dimLineH(wfR, f1[0], midYsvg, formatDimension(ohR));
+    if (ohT > 0.5) svg += dimLineV(f0[1], wfT, midXsvg, formatDimension(ohT));
+    if (ohB > 0.5) svg += dimLineV(wfB, f1[1], midXsvg, formatDimension(ohB));
+  }
+  if (stations.length) {
+    const rep = stations[Math.floor(stations.length / 2)].t;
+    const span = Math.hypot(rep.bottom_right[0] - rep.bottom_left[0], rep.bottom_right[1] - rep.bottom_left[1]);
+    const a = toSvg(rep.bottom_left);
+    const b = toSvg(rep.bottom_right);
+    const midY = Math.min(a[1], b[1]) - 12;
+    svg += dimLineH(a[0], b[0], midY, `truss span ${formatDimension(span)}`);
+  }
+  const inLabel = (s) => s ? `${Math.round(s[0] * 10) / 10}"\xD7${Math.round(s[1] * 10) / 10}"` : null;
+  const ringSec = inLabel(spec.framing?.ring_beam_size_in) ?? sectionFtLabel(ring[0]?.section_size);
+  const ridgeSec = inLabel(spec.framing?.ridge_size_in) ?? sectionFtLabel(ridges[0]?.section_size);
+  const footY = y0 + height - 12;
+  const parts = [];
+  parts.push(`ring beam ${formatDimension(spanX)} \xD7 ${formatDimension(spanY)} (wall centre)`);
+  if (ringSec) parts.push(`ring ${ringSec}`);
+  if (ridgeSec) parts.push(`ridge ${ridgeSec}`);
+  parts.push(`${stations.length} truss station${stations.length === 1 ? "" : "s"}`);
+  svg += `<text x="${(x0 + 12).toFixed(1)}" y="${footY.toFixed(1)}" text-anchor="start" font-size="10" fill="#475569">${escapeXml2(parts.join("  \xB7  "))}</text>
+`;
+  svg += `<text x="${(x0 + width - 12).toFixed(1)}" y="${footY.toFixed(1)}" text-anchor="end" font-size="9" fill="#475569"><tspan fill="#16a34a">green = ring beam (wall centre)</tspan> \xB7 <tspan fill="#8a6a3f">brown = wall face</tspan> \xB7 grey = roof edge (eave)</text>
+`;
+  svg += `</g>
+`;
+  return svg;
+}
+
+// ../editor/src/svg2d/roof/v2/eavePanel.ts
+init_format();
+var IN_TO_U2 = 10 / 12;
+var sub = (a, b) => [a[0] - b[0], a[1] - b[1], a[2] - b[2]];
+var cross = (a, b) => [a[1] * b[2] - a[2] * b[1], a[2] * b[0] - a[0] * b[2], a[0] * b[1] - a[1] * b[0]];
+var norm = (a) => Math.hypot(a[0], a[1], a[2]);
+var secInLabel = (s) => `${Math.round(s[0] * 10) / 10}"\xD7${Math.round(s[1] * 10) / 10}"`;
+function planePitch(vs) {
+  if (vs.length < 3) return 0;
+  const n3 = cross(sub(vs[1], vs[0]), sub(vs[2], vs[0]));
+  const nl = norm(n3) || 1;
+  const nz = Math.abs(n3[2] / nl);
+  return Math.acos(Math.min(1, nz)) * 180 / Math.PI;
+}
+function lowEdgeMid(vs) {
+  const minZ = Math.min(...vs.map((v) => v[2]));
+  const low = vs.filter((v) => Math.abs(v[2] - minZ) < 1);
+  if (low.length < 2) return null;
+  return [(low[0][0] + low[1][0]) / 2, (low[0][1] + low[1][1]) / 2, minZ];
+}
+function groupEaves(spec) {
+  const eaves = spec.members.filter((m) => m.role === "pani_patti");
+  if (!eaves.length) return [];
+  let minX = Infinity, maxX = -Infinity, minY = Infinity, maxY = -Infinity;
+  for (const m of spec.members) if (m.role === "ring_beam") for (const p of [m.start, m.end]) {
+    if (p[0] < minX) minX = p[0];
+    if (p[0] > maxX) maxX = p[0];
+    if (p[1] < minY) minY = p[1];
+    if (p[1] > maxY) maxY = p[1];
+  }
+  if (!isFinite(minX)) return [];
+  const halfWall = (spec.framing?.wall_thickness_u ?? 0) / 2;
+  minX -= halfWall;
+  maxX += halfWall;
+  minY -= halfWall;
+  maxY += halfWall;
+  const cx = (minX + maxX) / 2, cy = (minY + maxY) / 2;
+  const facePlanes = spec.planes.filter((p) => p.role === "slope" || p.role === "hip_face");
+  const faceInfo = facePlanes.map((p) => ({ role: p.role, pitch: planePitch(p.vertices), mid: lowEdgeMid(p.vertices) })).filter((f2) => f2.mid != null);
+  const groups = /* @__PURE__ */ new Map();
+  for (const e of eaves) {
+    const emid = [(e.start[0] + e.end[0]) / 2, (e.start[1] + e.end[1]) / 2, (e.start[2] + e.end[2]) / 2];
+    const vertical = Math.abs(e.start[0] - e.end[0]) < 1;
+    let overhang, side2;
+    if (vertical) {
+      const X = e.start[0];
+      const wallX = X > cx ? maxX : minX;
+      overhang = Math.abs(X - wallX);
+      side2 = X > cx ? "E" : "W";
+    } else {
+      const Y = e.start[1];
+      const wallY = Y > cy ? maxY : minY;
+      overhang = Math.abs(Y - wallY);
+      side2 = Y > cy ? "S" : "N";
+    }
+    let best = null;
+    let bestD = Infinity;
+    for (const f2 of faceInfo) {
+      const d = Math.hypot(f2.mid[0] - emid[0], f2.mid[1] - emid[1]);
+      if (d < bestD) {
+        bestD = d;
+        best = { role: f2.role, pitch: f2.pitch };
+      }
+    }
+    const roleLabel = best?.role === "hip_face" ? "Hip end" : best?.role === "slope" ? "Main slope" : "Eave";
+    const pitchDeg = best?.pitch ?? 0;
+    const sig = `${roleLabel}|${Math.round(pitchDeg)}|${Math.round(overhang)}`;
+    const existing = groups.get(sig);
+    if (existing) {
+      existing.count += 1;
+      if (!existing.sides.includes(side2)) existing.sides.push(side2);
+    } else groups.set(sig, { signature: sig, roleLabel, pitchDeg, overhang, count: 1, sides: [side2] });
+  }
+  return [...groups.values()].sort((a, b) => a.roleLabel === b.roleLabel ? b.overhang - a.overhang : a.roleLabel < b.roleLabel ? -1 : 1);
+}
+function v2EavePanel(x0, y0, width, height, spec, group) {
+  const titleH = 40;
+  const sidesStr = group.sides.length ? ` (${group.sides.join(", ")})` : "";
+  const title = `EAVE \u2014 ${group.roleLabel}${group.count > 1 ? ` \xD7 ${group.count}` : ""}${sidesStr}`;
+  let svg = panelFrame(x0, y0, width, height, titleH, title, "v2-eave");
+  group.sides.forEach((side2, i2) => {
+    svg += keyPlanDisc(x0 + width - 24 - i2 * 30, y0 + 20, 12, side2, "#0e7490", "#ffffff", "#ffffff");
+  });
+  const ringIn = spec.framing?.ring_beam_size_in ?? [4, 2];
+  const rafterIn = spec.framing?.rafter_size_in ?? [2, 4];
+  const purlinIn = spec.framing?.purlin_size_in ?? [2, 1];
+  const ringW = ringIn[0] * IN_TO_U2;
+  const ringD = ringIn[1] * IN_TO_U2;
+  const rafterD = rafterIn[1] * IN_TO_U2;
+  const purlinD = purlinIn[1] * IN_TO_U2;
+  const wallT = spec.framing?.wall_thickness_u ?? 7.5;
+  const ringH0 = Math.max(0, (wallT - ringW) / 2);
+  const pitchDeg = group.pitchDeg || 25;
+  const th = pitchDeg * Math.PI / 180;
+  const cos = Math.cos(th), sin = Math.sin(th), tan = Math.tan(th);
+  const overhang = group.overhang || 2 * 10;
+  const wallH = Math.max(ringD * 4, 20);
+  const interiorRun = wallT + Math.max(wallT * 1.2, 12);
+  const battenGap = Math.max(rafterD * 0.35, 2);
+  const bottomAt = (h) => [h, ringD + (h - ringH0) * tan];
+  const perpUp = [-sin, cos];
+  const top = (p) => [p[0] + perpUp[0] * rafterD, p[1] + perpUp[1] * rafterD];
+  const tailB = bottomAt(-overhang);
+  const inB = bottomAt(interiorRun);
+  const tailT = top(tailB), inT = top(inB);
+  const tileOff = [perpUp[0] * battenGap, perpUp[1] * battenGap];
+  const tileTail = [tailT[0] + tileOff[0] - cos * 2, tailT[1] + tileOff[1] - sin * 2];
+  const tileIn = [inT[0] + tileOff[0], inT[1] + tileOff[1]];
+  const pAlong = wallT + Math.max(wallT * 0.5, 8);
+  const pOnTop = top(bottomAt(pAlong));
+  const pts = [
+    [0, 0],
+    [wallT, 0],
+    [0, -wallH],
+    [wallT, -wallH],
+    [ringH0, 0],
+    [ringH0 + ringW, 0],
+    [ringH0, ringD],
+    [ringH0 + ringW, ringD],
+    tailB,
+    inB,
+    tailT,
+    inT,
+    tileTail,
+    tileIn,
+    pOnTop
+  ];
+  let minH = Infinity, maxH = -Infinity, minZ = Infinity, maxZ = -Infinity;
+  for (const [h, z2] of pts) {
+    if (h < minH) minH = h;
+    if (h > maxH) maxH = h;
+    if (z2 < minZ) minZ = z2;
+    if (z2 > maxZ) maxZ = z2;
+  }
+  const padL = 60, padR = 74, padT = titleH + 26, padB = 54;
+  const drawW = width - padL - padR, drawH = height - padT - padB;
+  const spanH = maxH - minH || 1, spanZ = maxZ - minZ || 1;
+  const scale = Math.min(drawW / spanH, drawH / spanZ);
+  const offX = x0 + padL + (drawW - spanH * scale) / 2 - minH * scale;
+  const offY = y0 + padT + (drawH - spanZ * scale) / 2 + maxZ * scale;
+  const S = (p) => [offX + p[0] * scale, offY - p[1] * scale];
+  const poly = (ps, fill, stroke, w) => `<polygon points="${ps.map((p) => {
+    const q = S(p);
+    return `${q[0].toFixed(1)},${q[1].toFixed(1)}`;
+  }).join(" ")}" fill="${fill}" stroke="${stroke}" stroke-width="${w}"/>
+`;
+  const seg = (a, b, stroke, w, dash) => {
+    const p = S(a), q = S(b);
+    return `<line x1="${p[0].toFixed(1)}" y1="${p[1].toFixed(1)}" x2="${q[0].toFixed(1)}" y2="${q[1].toFixed(1)}" stroke="${stroke}" stroke-width="${w}"${dash ? ` stroke-dasharray="${dash}"` : ""} stroke-linecap="round"/>
+`;
+  };
+  const label = (p, text, anchor = "start", fill = "#334155") => {
+    const q = S(p);
+    return `<text x="${q[0].toFixed(1)}" y="${q[1].toFixed(1)}" text-anchor="${anchor}" font-size="10" fill="${fill}">${escapeXml2(text)}</text>
+`;
+  };
+  svg += poly([[0, 0], [wallT, 0], [wallT, -wallH], [0, -wallH]], "#efe7db", "#8a6a3f", 1);
+  for (let hh = 1; hh < 6; hh++) {
+    const zc = -wallH * (hh / 6);
+    svg += seg([0, zc], [wallT, zc], "#d9c9ad", 0.5);
+  }
+  svg += poly([[ringH0, 0], [ringH0 + ringW, 0], [ringH0 + ringW, ringD], [ringH0, ringD]], "#dcfce7", "#16a34a", 1.6);
+  svg += seg([Math.min(minH, -overhang), 0], [maxH, 0], "#94a3b8", 0.6, "5 3");
+  svg += poly([tailB, inB, inT, tailT], "#e2e8f0", "#475569", 1.4);
+  svg += seg(tailB, [tailB[0], tailB[1] - rafterD * 1.1], "#475569", 1.4);
+  const pHalf = purlinD / 2;
+  svg += poly([
+    [pOnTop[0] - pHalf * cos, pOnTop[1] - pHalf * sin],
+    [pOnTop[0] + pHalf * cos, pOnTop[1] + pHalf * sin],
+    [pOnTop[0] + pHalf * cos - perpUp[0] * purlinD, pOnTop[1] + pHalf * sin - perpUp[1] * purlinD],
+    [pOnTop[0] - pHalf * cos - perpUp[0] * purlinD, pOnTop[1] - pHalf * sin - perpUp[1] * purlinD]
+  ], "#64748b", "#334155", 0.8);
+  svg += seg(tileTail, tileIn, "#b45309", 2);
+  svg += label([wallT / 2, -wallH * 0.66], "WALL", "middle", "#8a6a3f");
+  svg += label([ringH0 + ringW + 1.5, ringD / 2], `RING BEAM ${secInLabel(ringIn)}`, "start", "#16a34a");
+  svg += label(inT, "RAFTER", "start", "#475569");
+  svg += label([pOnTop[0], pOnTop[1] + 1], "PURLIN", "middle", "#334155");
+  svg += label(tileIn, "TILE", "start", "#b45309");
+  const dimY = S([0, minZ])[1] + 22;
+  svg += dimLineH(S(tailB)[0], S([0, 0])[0], dimY, `overhang ${formatDimension(overhang)}`);
+  svg += seg(tailB, [tailB[0], minZ - overhang * 0.02], "#94a3b8", 0.4, "2 2");
+  svg += dimLineH(S([0, -wallH])[0], S([wallT, -wallH])[0], S([0, -wallH])[1] + 16, `wall ${formatDimension(wallT)}`);
+  const o = S([ringH0, ringD]);
+  const r2 = 26;
+  svg += `<path d="M ${(o[0] + r2).toFixed(1)} ${o[1].toFixed(1)} A ${r2} ${r2} 0 0 0 ${(o[0] + r2 * cos).toFixed(1)} ${(o[1] - r2 * sin).toFixed(1)}" fill="none" stroke="#8B4513" stroke-width="1"/>
+`;
+  svg += `<text x="${(o[0] + r2 + 4).toFixed(1)}" y="${(o[1] - 6).toFixed(1)}" text-anchor="start" font-size="11" font-weight="600" fill="#8B4513">${pitchDeg.toFixed(1)}\xB0</text>
+`;
+  const footY = y0 + height - 12;
+  svg += `<text x="${(x0 + 12).toFixed(1)}" y="${footY.toFixed(1)}" text-anchor="start" font-size="9" fill="#475569">rafter ${secInLabel(rafterIn)} \xB7 purlin ${secInLabel(purlinIn)} \xB7 sizes from the roof framing</text>
+`;
+  svg += `</g>
+`;
+  return svg;
+}
+
 // ../editor/src/svg2d/roof/v2/compose.ts
 var TILE_W = 900;
 var TILE_H = 600;
@@ -430894,10 +432214,32 @@ function computeV2RoofSections(cfg) {
   const cutY = (bounds.minY + bounds.maxY) / 2;
   const zMax = roofMaxZ(spec);
   const wallTopZ = inferWallTopZ(spec);
+  const eaveGroups = groupEaves(spec);
+  const faceGroups = groupFaces(spec);
+  const markers = {
+    sections: [
+      { label: "A", axis: "x", coord: cutX },
+      { label: "B", axis: "y", coord: cutY }
+    ],
+    // one eave callout per distinct eave, on each compass side it occurs
+    eaves: eaveGroups.map((g) => ({ sides: g.sides, label: g.roleLabel })),
+    // roof faces labelled F1.. (matches the "Face N" fabrication panels below)
+    faces: faceGroups.map((group, idx) => ({
+      label: `F${idx + 1}`,
+      planeIds: group.planes.map((p) => p.id)
+    }))
+  };
   const defs = [
+    // Isometric first — the at-a-glance frame — then the key plan that indexes
+    // every other view.
+    {
+      id: "perspective",
+      title: "Frame (isometric)",
+      render: (x0, y0, w, h) => v2PerspectivePanel(x0, y0, w, h, spec, { title: "Frame (isometric)", dimensions: true })
+    },
     {
       id: "top_view",
-      title: "Top View",
+      title: "Top view \u2014 key plan",
       // renderTopViewPanel returns a full <svg> — nest it inside our
       // master via a positioned <svg> wrapper. Inner viewBox handles
       // its own scaling; outer x/y positions it in the master grid.
@@ -430906,17 +432248,13 @@ function computeV2RoofSections(cfg) {
           width: w,
           height: h,
           padding: 20,
-          title: "Top View"
+          title: "Top view \u2014 key plan",
+          markers
         });
         const stripped = inner.replace(/^\s*<svg[^>]*>/, "").replace(/<\/svg>\s*$/, "");
         return `<svg x="${x0}" y="${y0}" width="${w}" height="${h}" viewBox="0 0 ${w} ${h}">${stripped}</svg>`;
       }
     },
-    {
-      id: "perspective",
-      title: "Frame (isometric)",
-      render: (x0, y0, w, h) => v2PerspectivePanel(x0, y0, w, h, spec, { title: "Frame (isometric)" })
-    },
     {
       id: "section_a_a",
       title: `Section A-A (cut at X=${cutX.toFixed(0)})`,
@@ -430924,7 +432262,10 @@ function computeV2RoofSections(cfg) {
         title: `Section A-A (cut at X=${cutX.toFixed(0)})`,
         cutAxis: "x",
         cutCoord: cutX,
-        wallTopZ
+        wallTopZ,
+        overlayTruss: true,
+        dimensions: true,
+        keyLabel: "A"
       })
     },
     {
@@ -430934,19 +432275,41 @@ function computeV2RoofSections(cfg) {
         title: `Section B-B (cut at Y=${cutY.toFixed(0)})`,
         cutAxis: "y",
         cutCoord: cutY,
-        wallTopZ
+        wallTopZ,
+        overlayTruss: true,
+        dimensions: true,
+        keyLabel: "B"
       })
+    },
+    {
+      id: "frame_dims",
+      title: "Main frame \u2014 fabrication dimensions",
+      render: (x0, y0, w, h) => v2FrameDimPanel(x0, y0, w, h, spec)
     }
   ];
-  const groups = groupFaces(spec);
-  groups.forEach((group, idx) => {
+  eaveGroups.forEach((g, idx) => {
+    const sides = g.sides.length ? ` (${g.sides.join("")})` : "";
+    defs.push({
+      id: `eave_${idx}`,
+      title: `Eave \u2014 ${g.roleLabel}${g.count > 1 ? ` \xD7 ${g.count}` : ""}${sides}`,
+      render: (x0, y0, w, h) => v2EavePanel(x0, y0, w, h, spec, g)
+    });
+  });
+  faceGroups.forEach((group, idx) => {
     const id = `face_${idx}`;
     const shape = group.geom.ridgeLen > 0.5 ? "trapezoid" : "triangle";
     const nice = group.planes.length === 1 ? `Face ${idx + 1} (${shape}) \u2014 ${group.planes[0].id}` : `Face ${idx + 1} (${shape}, ${group.planes.length} identical)`;
     defs.push({
       id,
       title: nice,
-      render: (x0, y0, w, h) => v2FacePanel(x0, y0, w, h, group)
+      render: (x0, y0, w, h) => v2FacePanel(x0, y0, w, h, group, `F${idx + 1}`)
+    });
+  });
+  groupTrusses(spec).forEach((group, idx) => {
+    defs.push({
+      id: `truss_${idx}`,
+      title: `${group.geom.kind === "mono_pitch" ? "Mono-pitch" : "Fink"} truss ${idx + 1} (elevation${group.count > 1 ? `, \xD7 ${group.count}` : ""})`,
+      render: (x0, y0, w, h) => v2TrussPanel(x0, y0, w, h, group)
     });
   });
   const cols = 2;
@@ -431141,7 +432504,7 @@ var DOCS = {
   },
   "data-model": {
     "title": "The underlying .wadi schema (generated from Zod)",
-    "body": '# Wadi data model (`.wadi` / `house_config.json`)\n\n> **Generated from `editor/src/schema/houseConfig.ts` \u2014 do not edit by hand.**\n> Regenerate: `node scripts/gen-schema-doc.mjs <path/to/houseConfig.ts> reference/data-model.md`\n> Some primitives (beam, floor_slab, pillar, plinth, ground) are generated from their\n> `fields` (schema/fields/\\*) into generated/objects.generated.ts \u2014 run `npm run gen-primitives`\n> in editor/ first if you changed those, so the generated schemas (which this doc reads) are current.\n> The Zod schema is the single source of truth; this file mirrors it (structure + the\n> semantics carried in its comments) so it can\'t drift.\n\nA `.wadi` file is one JSON object matching **HouseConfig**. Geometry is in **project\nunits** (a unitless grid; by default `units.per_unit = 10` means 10 units = 1 ft).\nPlan coordinates are **Inkscape-style**: origin top-left, **X \u2192 right, Y \u2192 down**.\nSee `coordinate-system.md` for the coordinate/units detail and `parametric-conventions.md`\nfor variables/points/formulas.\n\n## Fields shared by (almost) every object\n\nThese appear on most object types; documented once here, marked *(cross-cutting)* below.\n\n| field | type | req | notes |\n|---|---|---|---|\n| `type` | literal `room` | **yes** |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  |  |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  |  |\n| `layer` | string |  |  |\n| `name` | string | **yes** |  |\n| `material` | string |  |  |\n| `z_offset` | number |  | Vertical position of the room (its floor + walls), as a lift above the FLOOR BASE (slabZ = plinth top for floor 0, else the floor below\'s top; project units, 10 = 1 ft). This is the UNIFIED z_offset convention: every object is placed at `slabZ + z_offset`. When OMITTED, on-slab objects (room, wall, staircase, kitchen_platform) default z_offset to the floor\'s resolved slab thickness (floor.slab_thickness \u2192 house.defaults.slab_thickness \u2192 code default), so by default they sit on top of the slab, exactly as before. Set it explicitly for split-level floors \u2014 e.g. a room raised onto a thicker slab uses the same value the raised slab\'s top sits at. |\n\n\n- `type` \u2014 the discriminated-union tag; selects the object shape (values below).\n- `formulas` \u2014 per-field `"= expression"` overrides; the resolver evaluates each into the\n  matching numeric field. See `parametric-conventions.md`.\n- `z_offset` \u2014 vertical lift above the floor base (slab top). On-slab objects (room, wall,\n  staircase, kitchen_platform) default it to the floor\'s slab thickness; slab/beam/pillar/\n  roof default to 0.\n\n## Top level \u2014 HouseConfig\n\n| field | type | req | notes |\n|---|---|---|---|\n| `coord_convention` | enum: `outer` `center` |  | How a rectangular object\'s x/y/width/length relate to its walls (plans/grid-convention.md). "center" (new/canonical): coordinates are wall CENTRELINES \u2014 adjacent rooms ABUT on a shared line (no overlap), walls are centred on the boundary, and expandRoomWalls grows each footprint by wall_thickness/2 to the outer face. "outer" / absent (legacy): coordinates are the OUTER wall face and adjacent rooms must overlap by wall_thickness. |\n| `plinth` | any (freeform) |  | Legacy top-level plinth (pre-"Plinth floor"). Tolerated but IGNORED so an un-migrated file still loads (it just renders without a plinth/ground) instead of failing .strict() validation. New configs put the plinth on the Plinth floor as a `plinth` object. |\n| `defaults` | [houseDefaults](#housedefaults) |  |  |\n| `units` | [units](#units) |  |  |\n| `layers` | array of [LayerDef](#layerdef) |  | Configurable 3D visibility layers (optional; defaults applied when absent). Objects opt in via their own `layer` field. |\n| `variables` | map: string \u2192 number, or `"= formula"` string |  | Parametric layer (plans/object-relationships-plan.md). Named scalar variables (number or "= formula", may reference other variables) and named 2D points; object `formulas` maps reference these. Optional \u2014 absent = a plain non-parametric house, resolved as a no-op. |\n| `points` | map: string \u2192 inline object |  |  |\n| `components` | map: string \u2192 [ComponentDef](#componentdef) |  | Reusable-component library (in-file). Map of id \u2192 ComponentDef. A `component` object instantiates one by `ref`. Stored once; referenced by many instances; edit here to update every instance. |\n| `grids` | map: string \u2192 `gridDef` |  | First-class parametric grids (plans/grid-convention.md). Map of id \u2192 GridDef (named X/Y wall centrelines). Rooms/slabs bind via `grid`+`cell`, pillars via `grid`+`node`; the resolver derives their geometry from the centrelines + wall thickness. Optional; reusable across templates. |\n| `configurator` | [configurator](#configurator) |  | Configurator metadata (Gharkul owner UI). Optional; see plans/configurator-plan.md. |\n| `thumbnails` | array of string |  | Preview snapshots (data: URLs) captured by the architect editor and saved WITH the template so the owner gallery can show real previews \u2014 multiple angles + the floor plan. `thumbnails[0]` is the gallery cover. Optional; excluded from share links (a preview isn\'t model data \u2014 see io/shareLink.ts). `thumbnail` (singular) is the legacy one-image form, still read as a fallback so old template files keep working. |\n| `thumbnail` | string |  |  |\n| `template` | inline object |  | Catalog metadata that makes a `.wadi` SELF-DESCRIBING: the editorial fields a gallery card needs that can\'t be derived from geometry (title, blurb, style/roof tags, min plot). With this block + `thumbnails[]`, a folder of `.wadi` files IS the catalog \u2014 the app lists the folder and indexes each file, with no separate index.json to maintain (see io/templateSource.ts). Non-strict so newer editorial fields don\'t break an older build. |\n| `floors` | array of [floor](#floor) | **yes** |  |\n| `_walls_expanded` | boolean |  |  |\n\n\n## floor\n\n| field | type | req | notes |\n|---|---|---|---|\n| `floor_number` | integer \u2265 0 | **yes** |  |\n| `name` | string | **yes** |  |\n| `height` | number > 0 |  | Per-floor overrides for the default heights in GlobalConfig. In project units (10 units = 1 ft). All three are INDEPENDENT \u2014 no relationship enforced between them: height \u2014 floor-to-floor rise (drives roof wallTop-Z stack) wall_height \u2014 standing wall height (floor top \u2192 ceiling) slab_thickness \u2014 RCC deck between this floor and the one above All fall back to GlobalConfig defaults when omitted. |\n| `wall_height` | number > 0 |  |  |\n| `slab_thickness` | number \u2265 0 |  |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  |  |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  |  |\n| `objects` | array of [Object types](#object-types) | **yes** |  |\n\n\n## Object types (`floors[].objects[]`)\n\nEvery entry in a floor\'s `objects` array is one of these, tagged by `type`:\n\n### `plinth`\n\nThe plinth is now a normal object placed on the "Plinth" floor (the first floor, number 0), not a top-level config key. Its footprint + height match the old top-level plinth; the plinth floor\'s `height` drives the rise to the floor above (replacing the old hardcoded plinth_height seed).\n\n| field | type | req | notes |\n|---|---|---|---|\n| `type` | literal `plinth` | **yes** |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  | *(shared \u2014 see top)* |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  | *(shared \u2014 see top)* |\n| `layer` | string |  | *(shared \u2014 see top)* |\n| `name` | string |  | Label |\n| `material` | string |  | Material key |\n| `x` | number | **yes** | Top-left X (project units) |\n| `y` | number | **yes** | Top-left Y (project units) |\n| `width` | number > 0 | **yes** | X extent (project units) |\n| `length` | number > 0 | **yes** | Y extent (project units) |\n| `height` | number > 0 | **yes** | Plinth height (project units) |\n| `z_offset` | number |  | Lift above ground (project units) |\n\n\n### `ground`\n\nThe ground plane, also on the Plinth floor. Extent defaults to the site plot when authored by the migration. `height` is an optional thickness (0 = a flat plane); slope fields are a later phase.\n\n| field | type | req | notes |\n|---|---|---|---|\n| `type` | literal `ground` | **yes** |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  | *(shared \u2014 see top)* |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  | *(shared \u2014 see top)* |\n| `layer` | string |  | *(shared \u2014 see top)* |\n| `name` | string |  | Label |\n| `material` | string |  | Material key |\n| `x` | number | **yes** | Top-left X (project units) |\n| `y` | number | **yes** | Top-left Y (project units) |\n| `width` | number > 0 | **yes** | X extent (project units) |\n| `length` | number > 0 | **yes** | Y extent (project units) |\n| `height` | number \u2265 0 |  | Thickness (0 = flat) (project units) |\n| `z_offset` | number |  | Lift above origin (project units) |\n\n\n### `component`\n\nAn INSTANCE of a reusable component from the in-file `components` library. It references a component by id (`ref`), overrides the component\'s input variables via `params`, and places it at (x, y) with a `z_offset` lift on its parent floor. At render time `expandRoomWalls` flattens it into concrete objects (resolve component with param+origin overrides \u2192 recurse \u2192 offset), so no renderer needs to know about `component`.\n\n| field | type | req | notes |\n|---|---|---|---|\n| `type` | literal `component` | **yes** |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  | *(shared \u2014 see top)* |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  | *(shared \u2014 see top)* |\n| `layer` | string |  | *(shared \u2014 see top)* |\n| `name` | string |  |  |\n| `ref` | string | **yes** |  |\n| `params` | map: string \u2192 union \u2014 see notes |  | Overrides for the component\'s declared input variables. A string starting with "=" is a formula evaluated in the HOST scope (so it can reference the host\'s variables/points); a number is used directly. |\n| `x` | number | **yes** |  |\n| `y` | number | **yes** |  |\n| `rotation` | number |  | Standard placement: yaw\xB0 about the instance origin (clockwise, same sense as item rotation: 0=south, 90=east). Right angles (0/90/180/270) are exact for any component; a non-right angle is allowed only for furniture-only ones. |\n| `z_offset` | number |  |  |\n\n\n### `item`\n\nA free-standing GLB furniture / decor instance placed directly on a floor (for pieces that aren\'t inside an enclosed room \u2014 outdoor/site/verandah decor, a loft item, etc.). `x`/`y` are the item\'s plan CENTRE. It MAY instead anchor to a named room via `anchor_to` + `anchor` + `gap`, in which case `x`/`y` are DERIVED at expand time (same anchor model as room-nested items). `rotation` is yaw\xB0; `scale` is a uniform resize; `z_offset` lifts it above the floor base (default = slab thickness). (`itemAsset`, `itemAnchor`, `gapField` are defined above `room`.)\n\n| field | type | req | notes |\n|---|---|---|---|\n| `type` | literal `item` | **yes** |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  | *(shared \u2014 see top)* |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  | *(shared \u2014 see top)* |\n| `layer` | string |  | *(shared \u2014 see top)* |\n| `name` | string |  |  |\n| `asset` | [ItemAsset](#itemasset) | **yes** |  |\n| `x` | number | **yes** |  |\n| `y` | number | **yes** |  |\n| `rotation` | number |  |  |\n| `scale` | number > 0 |  |  |\n| `z_offset` | number |  |  |\n| `anchor_to` | string |  | Optional room-relative anchoring (for a free item that should follow a room). |\n| `anchor` | [ItemAnchor](#itemanchor) |  |  |\n| `gap_x` | number |  |  |\n| `gap_y` | number |  |  |\n\n\n### `model`\n\nA GLB placed at real scale and manipulated by a `rig` of named-node ops. Distinct from `item` (furniture, catalog + anchoring): `model` is a rigged structural asset. `asset.dimensions` is the real metre size, used for the 2D footprint and the scale.\n\n| field | type | req | notes |\n|---|---|---|---|\n| `type` | literal `model` | **yes** |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  | *(shared \u2014 see top)* |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  | *(shared \u2014 see top)* |\n| `layer` | string |  | *(shared \u2014 see top)* |\n| `name` | string |  |  |\n| `asset` | [ItemAsset](#itemasset) | **yes** |  |\n| `x` | number | **yes** |  |\n| `y` | number | **yes** |  |\n| `rotation` | number |  |  |\n| `scale` | number > 0 |  |  |\n| `z_offset` | number |  |  |\n| `rig` | array of `rigOp` |  |  |\n\n\n### `floor_slab`\n| field | type | req | notes |\n|---|---|---|---|\n| `type` | literal `floor_slab` | **yes** |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  | *(shared \u2014 see top)* |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  | *(shared \u2014 see top)* |\n| `layer` | string |  | *(shared \u2014 see top)* |\n| `name` | string |  | Label |\n| `x` | number | **yes** | Top-left X (project units) |\n| `y` | number | **yes** | Top-left Y (project units) |\n| `width` | number > 0 | **yes** | X extent (project units) |\n| `length` | number > 0 | **yes** | Y extent (project units) |\n| `thickness` | number \u2265 0 |  | Slab thickness (defaults to floor\'s) (project units) |\n| `z_offset` | number |  | Lift above floor base (project units) |\n\n\n### `pillar`\n| field | type | req | notes |\n|---|---|---|---|\n| `type` | literal `pillar` | **yes** |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  | *(shared \u2014 see top)* |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  | *(shared \u2014 see top)* |\n| `layer` | string |  | *(shared \u2014 see top)* |\n| `name` | string | **yes** | Label |\n| `x` | number | **yes** | Top-left corner X (project units) |\n| `y` | number | **yes** | Top-left corner Y (project units) |\n| `width` | number > 0 |  | X extent (project units) |\n| `length` | number > 0 |  | Y extent (project units) |\n| `height` | number > 0 | **yes** | Column height (project units) |\n| `z_offset` | number |  | Lift above floor base (project units) |\n\n\n### `beam`\n| field | type | req | notes |\n|---|---|---|---|\n| `type` | literal `beam` | **yes** |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  | *(shared \u2014 see top)* |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  | *(shared \u2014 see top)* |\n| `layer` | string |  | *(shared \u2014 see top)* |\n| `name` | string |  | Label |\n| `x` | number | **yes** | Top-left X (project units) |\n| `y` | number | **yes** | Top-left Y (project units) |\n| `width` | number > 0 | **yes** | X extent (project units) |\n| `length` | number > 0 | **yes** | Y extent (project units) |\n| `height` | number > 0 |  | Vertical thickness (project units) |\n| `z_offset` | number |  | Lift above floor base (project units) |\n\n\n### `room`\n| field | type | req | notes |\n|---|---|---|---|\n| `type` | literal `room` | **yes** |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  | *(shared \u2014 see top)* |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  | *(shared \u2014 see top)* |\n| `layer` | string |  | *(shared \u2014 see top)* |\n| `name` | string | **yes** |  |\n| `x` | number | **yes** |  |\n| `y` | number | **yes** |  |\n| `width` | number > 0 | **yes** |  |\n| `length` | number > 0 | **yes** |  |\n| `height` | number \u2265 0 |  | 0 accepted \u2014 semantically the same as absent ("use floor default"). Old configs that accidentally saved height: 0 keep loading; the form treats 0 as "no override" and doesn\'t write it back. |\n| `material` | string |  |  |\n| `z_offset` | number |  | Vertical position of the room (its floor + walls), as a lift above the FLOOR BASE (slabZ = plinth top for floor 0, else the floor below\'s top; project units, 10 = 1 ft). This is the UNIFIED z_offset convention: every object is placed at `slabZ + z_offset`. When OMITTED, on-slab objects (room, wall, staircase, kitchen_platform) default z_offset to the floor\'s resolved slab thickness (floor.slab_thickness \u2192 house.defaults.slab_thickness \u2192 code default), so by default they sit on top of the slab, exactly as before. Set it explicitly for split-level floors \u2014 e.g. a room raised onto a thicker slab uses the same value the raised slab\'s top sits at. |\n| `walls` | union \u2014 see notes |  |  |\n| `wall_heights` | map: string \u2192 [wall_heights entry](#wall-heights-entry) |  |  |\n| `items` | array of [RoomItem](#roomitem) |  | Furniture nested in this room. Each piece is anchored to the room\'s inner footprint (see roomItem), so it reflows when the room resizes. Expanded into top-level `item` objects at render time. |\n\n\n### `wall`\n| field | type | req | notes |\n|---|---|---|---|\n| `type` | literal `wall` | **yes** |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  | *(shared \u2014 see top)* |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  | *(shared \u2014 see top)* |\n| `layer` | string |  | *(shared \u2014 see top)* |\n| `name` | string | **yes** |  |\n| `start_x` | number | **yes** |  |\n| `start_y` | number | **yes** |  |\n| `end_x` | number | **yes** |  |\n| `end_y` | number | **yes** |  |\n| `height` | number > 0 |  |  |\n| `height_end` | number |  |  |\n| `material` | string |  |  |\n| `facing` | enum: `north` `south` `east` `west` |  |  |\n| `z_offset` | number |  | Lift above the FLOOR BASE (slabZ), project units. Omitted \u2192 defaults to the floor\'s resolved slab thickness (sits on the slab, as before). Set it for a split-level wall. Same convention as `room`. |\n| `openings` | array of [Opening](#opening) |  |  |\n\n\n### `staircase`\n| field | type | req | notes |\n|---|---|---|---|\n| `type` | literal `staircase` | **yes** |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  | *(shared \u2014 see top)* |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  | *(shared \u2014 see top)* |\n| `layer` | string |  | *(shared \u2014 see top)* |\n| `name` | string |  |  |\n| `climb` | enum: `up` `down` |  | `climb` picks which end (start_x, start_y) is and which way the flight runs in z as it extends into `direction`: \u2022 "up" (recommended): BOTTOM-anchored. Put the stair on the LOWER floor it rises FROM; (start_x, start_y) is the bottom step\'s near corner on that floor and the flight ASCENDS into `direction`. `rise_height` defaults to THIS floor\'s height (climb to the next level). The intuitive way. \u2022 "down" (DEFAULT, kept for older configs): TOP-anchored. Put the stair on the upper DESTINATION floor; (start_x, start_y) is the top connection and the flight DESCENDS into `direction`. `rise_height` defaults to the floor immediately BELOW this one. Either way the body + landings fill the box [start, start + max_run] along `direction`, and `z_offset` is the ANCHORED end\'s height above the floor base (omitted \u2192 this floor\'s slab thickness, flush with the walking surface). |\n| `start_x` | number | **yes** |  |\n| `start_y` | number | **yes** |  |\n| `rise_height` | number > 0 |  | Total height the stair covers, top \u2192 floor below. The step COUNT is derived: num_steps = round(rise_height / step_rise). Omitted \u2192 defaults to the height of the floor immediately below this one. Formula-capable (e.g. "= floor_height"). Replaces the old explicit `num_steps`. |\n| `step_rise` | number > 0 | **yes** |  |\n| `step_tread` | number > 0 | **yes** |  |\n| `step_width` | number > 0 | **yes** |  |\n| `direction` | enum: `north` `south` `east` `west` | **yes** | The direction the stair EXTENDS from its top \u2014 the whole assembly fills the allocated box from (start_x,start_y) going this way for up to `max_run`. |\n| `max_run` | number > 0 |  | ALLOCATED run: the length of space reserved for the stair along `direction`. The WHOLE assembly (flights + turn landings) is kept within [start, start+max_run]; when the run won\'t fit as one flight it auto-splits into switchback flights (more flights when tight), expanded in expandRoomWalls into plain staircases + floor_slab landings so every renderer is unchanged. Omit \u2192 one flight, no length limit. |\n| `landing_depth` | number > 0 |  | Turn-landing depth (along the run). Omitted \u2192 equals step_width. |\n| `landing_thickness` | number \u2265 0 |  | Turn-landing slab thickness. Omitted \u2192 equals step_rise. |\n| `turn` | enum: `clockwise` `anticlockwise` |  | Switchback handedness, reckoned DESCENDING from the top. Omitted \u2192 "clockwise". Only affects split stairs. |\n| `flight_gap` | number > 0 |  | Lateral gap between the two switchback flights (a stairwell void for a spine wall). Omitted/0 \u2192 flights are adjacent. The turn landings widen to bridge the gap. Only affects split stairs. |\n| `z_offset` | number |  | Height of the stair\'s TOP above the floor base (slabZ; project units, 10 = 1 ft). Omitted \u2192 this floor\'s slab thickness, so the top is flush with the walking surface and the flights descend to the floor below. Raise it for an internal step whose top sits above the floor. |\n| `material` | string |  |  |\n\n\n### `spiral_staircase`\n\nA helical staircase: `steps` treads winding `turns` revolutions around a central pole, from the floor to `total_height`, within `radius`. Placed by its CENTRE (x, y). Optional fields fall back to sensible defaults at render time.\n\n| field | type | req | notes |\n|---|---|---|---|\n| `type` | literal `spiral_staircase` | **yes** |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  | *(shared \u2014 see top)* |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  | *(shared \u2014 see top)* |\n| `layer` | string |  | *(shared \u2014 see top)* |\n| `name` | string |  | Label |\n| `x` | number | **yes** | Centre X (project units) |\n| `y` | number | **yes** | Centre Y (project units) |\n| `radius` | number > 0 | **yes** | Outer radius (project units) |\n| `total_height` | number > 0 | **yes** | Total rise (floor to top step) (project units) |\n| `turns` | number > 0 |  | Revolutions (default 1) |\n| `steps` | integer |  | Number of treads (default ~12 per turn) |\n| `tread_thickness` | number > 0 |  | Tread slab thickness (project units) |\n| `pole_radius` | number > 0 |  | Central pole radius (project units) |\n| `z_offset` | number |  | Lift above floor base (project units) |\n\n\n### `door`\n\nFlat door/window remain valid as a legacy schema \u2014 new configs nest them inside room.walls[side].openings or wall.openings.\n\n| field | type | req | notes |\n|---|---|---|---|\n| `type` | literal `door` | **yes** |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  | *(shared \u2014 see top)* |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  | *(shared \u2014 see top)* |\n| `layer` | string |  | *(shared \u2014 see top)* |\n| `name` | string | **yes** |  |\n| `x` | number | **yes** |  |\n| `y` | number | **yes** |  |\n| `width` | number > 0 | **yes** |  |\n| `height` | number > 0 | **yes** |  |\n| `direction` | enum: `north` `south` `east` `west` | **yes** |  |\n| `room` | string |  |  |\n| `wall` | string |  |  |\n| `open` | boolean |  |  |\n\n\n### `window`\n| field | type | req | notes |\n|---|---|---|---|\n| `type` | literal `window` | **yes** |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  | *(shared \u2014 see top)* |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  | *(shared \u2014 see top)* |\n| `layer` | string |  | *(shared \u2014 see top)* |\n| `name` | string | **yes** |  |\n| `x` | number | **yes** |  |\n| `y` | number | **yes** |  |\n| `width` | number > 0 | **yes** |  |\n| `height` | number > 0 | **yes** |  |\n| `sill_height` | number \u2265 0 |  |  |\n| `direction` | enum: `north` `south` `east` `west` | **yes** |  |\n| `room` | string |  |  |\n| `wall` | string |  |  |\n| `open` | boolean |  |  |\n\n\n### `kitchen_platform`\n\nKitchen platform \u2014 a polyline countertop / cooking slab that runs along the base of walls. Path is the wall-side edge; the platform extends `depth` units perpendicular to each segment on the given `side`. Renders as one box per path segment; corners meet at the shared point (no fancy mitering in v1).\n\n| field | type | req | notes |\n|---|---|---|---|\n| `type` | literal `kitchen_platform` | **yes** |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  | *(shared \u2014 see top)* |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  | *(shared \u2014 see top)* |\n| `layer` | string |  | *(shared \u2014 see top)* |\n| `name` | string |  |  |\n| `path` | array of tuple `[n,n]` | **yes** |  |\n| `side` | enum: `left` `right` | **yes** |  |\n| `depth` | number > 0 | **yes** |  |\n| `height` | number > 0 | **yes** |  |\n| `z_offset` | number |  | Lift above the FLOOR BASE (slabZ), project units. Omitted \u2192 defaults to the floor\'s resolved slab thickness (sits on the slab top, as before). Same convention as `room`. |\n| `base_z` | number |  |  |\n| `material` | string |  |  |\n\n\n### `roof`\n\nv2 roof \u2014 unified segment-based type that replaces hip/gable/flat/shed. Schema is permissive; the v2 pipeline (svg2d/roof/v2/) validates segments + slope + endpoint style at derivation time.\n\n\n> **Freeform:** extra fields are allowed (`.catchall`) and validated at derivation time. See `roof-v2-guide.md`.\n\n| field | type | req | notes |\n|---|---|---|---|\n| `type` | literal `roof` | **yes** |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  | *(shared \u2014 see top)* |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  | *(shared \u2014 see top)* |\n\n\n## Shared & nested schemas\n\n### site\n\nObjects don\'t bind to the grid with a special field \u2014 a grid line\'s position is published as a formula symbol (`<gridId>.x<name>` / `.y<name>`, see param/resolve.ts), so a room places itself with ordinary `formulas`, e.g. { x: "= main.x1", width: "= main.x5 - main.x1" }. With coord_convention:"center" those are wall centrelines and expandRoomWalls handles the wall extent.\n\n| field | type | req | notes |\n|---|---|---|---|\n| `reference_x` | number | **yes** |  |\n| `reference_y` | number | **yes** |  |\n| `plot_length` | number > 0 | **yes** |  |\n| `plot_width` | number > 0 | **yes** |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  |  |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  |  |\n\n\n### houseDefaults\n\nHouse-level overrides for the built-in GlobalConfig defaults. Every floor without its own value falls back to these; if these are absent too, the code defaults in DEFAULT_GLOBAL_CONFIG apply.\n\n| field | type | req | notes |\n|---|---|---|---|\n| `floor_height` | number > 0 |  |  |\n| `wall_height` | number > 0 |  |  |\n| `slab_thickness` | number \u2265 0 |  |  |\n| `wall_thickness` | number > 0 |  | House-wide wall thickness (project units). Per-object `wall_thickness`/`thickness` overrides still win. Falls back to the code default (DEFAULT_GLOBAL_CONFIG.wall_thickness = 8) when omitted. |\n| `formulas` | map: field name \u2192 `"= formula"` string |  |  |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  |  |\n\n\n### units\n\nHow dimensions are LABELLED on the drawings. Display-only \u2014 geometry always stays in project units; this just controls the text on the dimension lines. Omitted = the built-in default (feet & inches, 10 project units = 1 ft).\n\n| field | type | req | notes |\n|---|---|---|---|\n| `system` | enum: `feet_inches` `feet` `meters` `centimeters` `millimeters` |  | feet_inches \u2192 12\' 6" ; the rest \u2192 decimal with a unit suffix. |\n| `per_unit` | number > 0 |  | Project units that equal ONE display unit (10 \u2192 10 units = 1 ft; 100 \u2192 100 units = 1 m). Default 10. |\n| `precision` | integer \u2265 0 |  | Decimal places for the non-feet_inches systems. |\n\n\n### Opening\n\nThe plinth is now a normal object placed on the "Plinth" floor (the first floor, number 0), not a top-level config key. Its footprint + height match the old top-level plinth; the plinth floor\'s `height` drives the rise to the floor above (replacing the old hardcoded plinth_height seed). `plinth` + `ground` are GENERATED from fields (schema/fields/{plinth,ground}.ts), imported above as plinthObject / groundObject. (P2b)\n\n| field | type | req | notes |\n|---|---|---|---|\n| `kind` | enum: `door` `window` | **yes** |  |\n| `name` | string |  |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  | Numeric fields hold the RESOLVED value; a `= formula` for any of them lives in `formulas` (e.g. formulas.offset), evaluated by resolveParametric against the house variables/points \u2014 same pattern as every other object. |\n| `offset` | number | **yes** | Any number: `center` anchor takes a signed shift; the resolved placement is fit-checked against the wall in expand.ts, so a bad value errors there. |\n| `anchor` | enum: `start` `center` `end` |  | Which end of the wall `offset` is measured from, so the opening holds its place when the wall/room scales \u2014 no formula needed. `start` (default, legacy): offset from the wall start to the near edge. `end`: offset from the wall end to the far edge (0 = flush to the end). `center`: signed shift of the opening centre from the wall midpoint (0 = centred; may be negative). Resolved to a start-based offset in expand.ts (openingAnchor.ts). |\n| `width` | number > 0 | **yes** |  |\n| `height` | number > 0 | **yes** |  |\n| `sill_height` | number |  |  |\n| `direction` | enum: `north` `south` `east` `west` |  |  |\n| `facing` | enum: `north` `south` `east` `west` |  |  |\n| `open` | boolean |  | When true, the opening is left BARE (just a hole) \u2014 no glazing/frame for a window, no leaf for a door \u2014 e.g. an open doorway or unglazed vent. |\n\n\n### RoomWallSide\n| field | type | req | notes |\n|---|---|---|---|\n| `height` | number |  |  |\n| `height_end` | number |  |  |\n| `openings` | array of [Opening](#opening) |  |  |\n\n\n### RoomItem\n\nA furniture piece nested INSIDE a room (room.items[]). It has NO x/y \u2014 its plan position is DERIVED at expand time from the parent room\'s footprint + `anchor` + per-axis gap (+ its own `rotation`). Flattened into a top-level `item` for every renderer. `gap_x`/`gap_y` are the inset (project units) kept from the anchor into the room (edge/corner anchor \u2192 clears the wall; centre anchor \u2192 signed offset, +x east / +y south). `gap_x`/`gap_y`/`rotation`/`scale`/`z_offset` are all plain numeric fields so each can be driven by a `= formula` (via the `formulas` map).\n\n| field | type | req | notes |\n|---|---|---|---|\n| `name` | string |  |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  |  |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  |  |\n| `layer` | string |  |  |\n| `asset` | [ItemAsset](#itemasset) | **yes** |  |\n| `anchor` | [ItemAnchor](#itemanchor) |  |  |\n| `gap_x` | number |  |  |\n| `gap_y` | number |  |  |\n| `rotation` | number |  |  |\n| `scale` | number > 0 |  |  |\n| `z_offset` | number |  |  |\n\n\n### ItemAsset\n\nFurniture (GLB `item`) \u2014 shared schema pieces Defined BEFORE `room` so a room can nest its own `items[]`. Asset distances are METRES (the GLB\'s native unit); the 3D/2D layers scale them into project units. See registry/nodes/item + three/units. The asset backing a furniture item \u2014 stored INLINE so a .wadi is self-contained (share links / web load the GLB from `src`). A catalog is just a picker convenience.\n\n| field | type | req | notes |\n|---|---|---|---|\n| `id` | string | **yes** |  |\n| `name` | string |  |  |\n| `src` | string | **yes** |  |\n| `dimensions` | tuple `[n>0,n>0,n>0]` | **yes** |  |\n| `thumbnail` | string |  |  |\n| `floorPlanUrl` | string |  |  |\n| `category` | string |  |  |\n| `tags` | array of string |  |  |\n| `offset` | tuple `[n,n,n]` |  |  |\n| `corrRotation` | tuple `[n,n,n]` |  |  |\n| `corrScale` | tuple `[n>0,n>0,n>0]` |  |  |\n\n\n### ComponentDef\n| field | type | req | notes |\n|---|---|---|---|\n| `name` | string |  |  |\n| `goal` | string |  | A short natural-language description of what this component accomplishes (the discovery key for goal-based module lookup, e.g. "climb to the next floor"). Purely metadata \u2014 renderers ignore it. |\n| `params` | array of [ComponentParam](#componentparam) |  |  |\n| `variables` | map: string \u2192 number, or `"= formula"` string |  |  |\n| `points` | map: string \u2192 inline object |  |  |\n| `objects` | array of [Object types](#object-types) | **yes** |  |\n| `expose` | inline object |  | Promote this component to a typed primitive at load time (plans/declarative-plugins.md P0). When present, the component registers a NodeDefinition of type `expose.type` whose fields come from `params`; it can then be used like any core object type. `type` is namespaced (`pack.thing`). |\n\n\n### ComponentParam\n\nA reusable component DEFINITION in the in-file `components` library. It is a mini-house: its own `variables`/`points` and a flat `objects` body authored in LOCAL coords (origin 0,0). `params` names which variables are the public inputs (label/default for the instance form). A `component` instance overrides those variables and places the body at its (x,y,z_offset). Stored once; referenced by many instances.\n\n| field | type | req | notes |\n|---|---|---|---|\n| `name` | string | **yes** |  |\n| `label` | string |  |  |\n| `description` | string |  |  |\n| `default` | number |  |  |\n| `kind` | string |  | Field-projection annotations, used only when the component is `expose`d as a typed primitive (plans/declarative-plugins.md). `kind` is a FieldKind preset (coord/extent/nonneg/int/text/flag/enum); when absent the kind is inferred from the default\'s type. `unit` is a doc-only unit hint. |\n| `unit` | string |  |  |\n\n\n### LayerDef\n\nA visibility layer for the 3D view. Each object may reference a layer by `id` (via its `layer` field); the layers menu toggles whole layers on/off. Display-only \u2014 never affects geometry. Optional: when absent, a built-in default layer set is used, and objects fall back to an automatic per-type/floor mapping.\n\n| field | type | req | notes |\n|---|---|---|---|\n| `id` | string (non-empty) | **yes** |  |\n| `label` | string | **yes** |  |\n| `color` | string |  |  |\n| `group` | string |  | Friendly group for the owner "Show/hide layers" menu (e.g. "Roof", "Walls"). Layers sharing a group toggle together. Optional. |\n\n\n### configurator\n| field | type | req | notes |\n|---|---|---|---|\n| `title` | string |  |  |\n| `description` | string |  |  |\n| `groups` | array of inline object |  |  |\n| `inputs` | array of [ConfiguratorInput](#configuratorinput) | **yes** |  |\n\n\n### ConfiguratorInput\n\nConfigurator (Gharkul owner UI) Optional, author-supplied metadata: which `variables`/`points` a template exposes to end users, and how to present them. IGNORED by the resolver and every geometry consumer \u2014 read only by the owner-facing Configurator UI. `target` is a variable name (e.g. "floorH") or a point coordinate ("House.W" \u2192 points.House.x; W/L/X/Y/x/y are resolver synonyms). `min`/`max`/ `step` are in RAW project units; `unit` only affects display.\n\n| field | type | req | notes |\n|---|---|---|---|\n| `target` | string (non-empty) | **yes** |  |\n| `label` | string (non-empty) | **yes** |  |\n| `description` | string |  |  |\n| `control` | enum: `slider` `number` `select` `toggle` |  |  |\n| `unit` | enum: `ft` `in` `m` `units` `percent` `count` `none` |  |  |\n| `min` | number |  |  |\n| `max` | number |  |  |\n| `step` | number > 0 |  |  |\n| `options` | array of inline object |  |  |\n| `group` | string |  |  |\n\n\n### ItemAnchor\n\n9-point anchor on a room\'s INNER footprint. First token = vertical (top = north \u2026 bottom = south), second = horizontal (left = west \u2026 right = east); "center" alone = both. The item aligns its matching edge/corner to this spot, held `gap` off it, into the room \u2014 so it reflows when the room is resized.\n\nEnum: `top-left` `top-center` `top-right` `center-left` `center` `center-right` `bottom-left` `bottom-center` `bottom-right`\n'
+    "body": '# Wadi data model (`.wadi` / `house_config.json`)\n\n> **Generated from `editor/src/schema/houseConfig.ts` \u2014 do not edit by hand.**\n> Regenerate: `node scripts/gen-schema-doc.mjs <path/to/houseConfig.ts> reference/data-model.md`\n> Some primitives (beam, floor_slab, pillar, plinth, ground) are generated from their\n> `fields` (schema/fields/\\*) into generated/objects.generated.ts \u2014 run `npm run gen-primitives`\n> in editor/ first if you changed those, so the generated schemas (which this doc reads) are current.\n> The Zod schema is the single source of truth; this file mirrors it (structure + the\n> semantics carried in its comments) so it can\'t drift.\n\nA `.wadi` file is one JSON object matching **HouseConfig**. Geometry is in **project\nunits** (a unitless grid; by default `units.per_unit = 10` means 10 units = 1 ft).\nPlan coordinates are **Inkscape-style**: origin top-left, **X \u2192 right, Y \u2192 down**.\nSee `coordinate-system.md` for the coordinate/units detail and `parametric-conventions.md`\nfor variables/points/formulas.\n\n## Fields shared by (almost) every object\n\nThese appear on most object types; documented once here, marked *(cross-cutting)* below.\n\n| field | type | req | notes |\n|---|---|---|---|\n| `type` | literal `room` | **yes** |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  |  |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  |  |\n| `layer` | string |  |  |\n| `name` | string | **yes** |  |\n| `material` | string |  |  |\n| `z_offset` | number |  | Vertical position of the room (its floor + walls), as a lift above the FLOOR BASE (slabZ = plinth top for floor 0, else the floor below\'s top; project units, 10 = 1 ft). This is the UNIFIED z_offset convention: every object is placed at `slabZ + z_offset`. When OMITTED, on-slab objects (room, wall, staircase, kitchen_platform) default z_offset to the floor\'s resolved slab thickness (floor.slab_thickness \u2192 house.defaults.slab_thickness \u2192 code default), so by default they sit on top of the slab, exactly as before. Set it explicitly for split-level floors \u2014 e.g. a room raised onto a thicker slab uses the same value the raised slab\'s top sits at. |\n\n\n- `type` \u2014 the discriminated-union tag; selects the object shape (values below).\n- `formulas` \u2014 per-field `"= expression"` overrides; the resolver evaluates each into the\n  matching numeric field. See `parametric-conventions.md`.\n- `z_offset` \u2014 vertical lift above the floor base (slab top). On-slab objects (room, wall,\n  staircase, kitchen_platform) default it to the floor\'s slab thickness; slab/beam/pillar/\n  roof default to 0.\n\n## Top level \u2014 HouseConfig\n\n| field | type | req | notes |\n|---|---|---|---|\n| `coord_convention` | enum: `outer` `center` |  | How a rectangular object\'s x/y/width/length relate to its walls (plans/grid-convention.md). "center" (new/canonical): coordinates are wall CENTRELINES \u2014 adjacent rooms ABUT on a shared line (no overlap), walls are centred on the boundary, and expandRoomWalls grows each footprint by wall_thickness/2 to the outer face. "outer" / absent (legacy): coordinates are the OUTER wall face and adjacent rooms must overlap by wall_thickness. |\n| `plinth` | any (freeform) |  | Legacy top-level plinth (pre-"Plinth floor"). Tolerated but IGNORED so an un-migrated file still loads (it just renders without a plinth/ground) instead of failing .strict() validation. New configs put the plinth on the Plinth floor as a `plinth` object. |\n| `defaults` | [houseDefaults](#housedefaults) |  |  |\n| `units` | [units](#units) |  |  |\n| `layers` | array of [LayerDef](#layerdef) |  | Configurable 3D visibility layers (optional; defaults applied when absent). Objects opt in via their own `layer` field. |\n| `variables` | map: string \u2192 number, or `"= formula"` string |  | Parametric layer (plans/object-relationships-plan.md). Named scalar variables (number or "= formula", may reference other variables) and named 2D points; object `formulas` maps reference these. Optional \u2014 absent = a plain non-parametric house, resolved as a no-op. |\n| `points` | map: string \u2192 inline object |  |  |\n| `components` | map: string \u2192 [ComponentDef](#componentdef) |  | Reusable-component library (in-file). Map of id \u2192 ComponentDef. A `component` object instantiates one by `ref`. Stored once; referenced by many instances; edit here to update every instance. |\n| `grids` | map: string \u2192 `gridDef` |  | First-class parametric grids (plans/grid-convention.md). Map of id \u2192 GridDef (named X/Y wall centrelines). Rooms/slabs bind via `grid`+`cell`, pillars via `grid`+`node`; the resolver derives their geometry from the centrelines + wall thickness. Optional; reusable across templates. |\n| `configurator` | [configurator](#configurator) |  | Configurator metadata (Gharkul owner UI). Optional; see plans/configurator-plan.md. |\n| `thumbnails` | array of string |  | Preview snapshots (data: URLs) captured by the architect editor and saved WITH the template so the owner gallery can show real previews \u2014 multiple angles + the floor plan. `thumbnails[0]` is the gallery cover. Optional; excluded from share links (a preview isn\'t model data \u2014 see io/shareLink.ts). `thumbnail` (singular) is the legacy one-image form, still read as a fallback so old template files keep working. |\n| `thumbnail` | string |  |  |\n| `template` | inline object |  | Catalog metadata that makes a `.wadi` SELF-DESCRIBING: the editorial fields a gallery card needs that can\'t be derived from geometry (title, blurb, style/roof tags, min plot). With this block + `thumbnails[]`, a folder of `.wadi` files IS the catalog \u2014 the app lists the folder and indexes each file, with no separate index.json to maintain (see io/templateSource.ts). Non-strict so newer editorial fields don\'t break an older build. |\n| `floors` | array of [floor](#floor) | **yes** |  |\n| `_walls_expanded` | boolean |  |  |\n\n\n## floor\n\n| field | type | req | notes |\n|---|---|---|---|\n| `floor_number` | integer \u2265 0 | **yes** |  |\n| `name` | string | **yes** |  |\n| `height` | number > 0 |  | Per-floor overrides for the default heights in GlobalConfig. In project units (10 units = 1 ft). All three are INDEPENDENT \u2014 no relationship enforced between them: height \u2014 floor-to-floor rise (drives roof wallTop-Z stack) wall_height \u2014 standing wall height (floor top \u2192 ceiling) slab_thickness \u2014 RCC deck between this floor and the one above All fall back to GlobalConfig defaults when omitted. |\n| `wall_height` | number > 0 |  |  |\n| `slab_thickness` | number \u2265 0 |  |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  |  |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  |  |\n| `objects` | array of [Object types](#object-types) | **yes** |  |\n\n\n## Object types (`floors[].objects[]`)\n\nEvery entry in a floor\'s `objects` array is one of these, tagged by `type`:\n\n### `plinth`\n\nThe plinth is now a normal object placed on the "Plinth" floor (the first floor, number 0), not a top-level config key. Its footprint + height match the old top-level plinth; the plinth floor\'s `height` drives the rise to the floor above (replacing the old hardcoded plinth_height seed).\n\n| field | type | req | notes |\n|---|---|---|---|\n| `type` | literal `plinth` | **yes** |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  | *(shared \u2014 see top)* |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  | *(shared \u2014 see top)* |\n| `layer` | string |  | *(shared \u2014 see top)* |\n| `name` | string |  | Label |\n| `material` | string |  | Material key |\n| `x` | number | **yes** | Top-left X (project units) |\n| `y` | number | **yes** | Top-left Y (project units) |\n| `width` | number > 0 | **yes** | X extent (project units) |\n| `length` | number > 0 | **yes** | Y extent (project units) |\n| `height` | number > 0 | **yes** | Plinth height (project units) |\n| `z_offset` | number |  | Lift above ground (project units) |\n\n\n### `ground`\n\nThe ground plane, also on the Plinth floor. Extent defaults to the site plot when authored by the migration. `height` is an optional thickness (0 = a flat plane); slope fields are a later phase.\n\n| field | type | req | notes |\n|---|---|---|---|\n| `type` | literal `ground` | **yes** |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  | *(shared \u2014 see top)* |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  | *(shared \u2014 see top)* |\n| `layer` | string |  | *(shared \u2014 see top)* |\n| `name` | string |  | Label |\n| `material` | string |  | Material key |\n| `x` | number | **yes** | Top-left X (project units) |\n| `y` | number | **yes** | Top-left Y (project units) |\n| `width` | number > 0 | **yes** | X extent (project units) |\n| `length` | number > 0 | **yes** | Y extent (project units) |\n| `height` | number \u2265 0 |  | Thickness (0 = flat) (project units) |\n| `z_offset` | number |  | Lift above origin (project units) |\n\n\n### `component`\n\nAn INSTANCE of a reusable component from the in-file `components` library. It references a component by id (`ref`), overrides the component\'s input variables via `params`, and places it at (x, y) with a `z_offset` lift on its parent floor. At render time `expandRoomWalls` flattens it into concrete objects (resolve component with param+origin overrides \u2192 recurse \u2192 offset), so no renderer needs to know about `component`.\n\n| field | type | req | notes |\n|---|---|---|---|\n| `type` | literal `component` | **yes** |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  | *(shared \u2014 see top)* |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  | *(shared \u2014 see top)* |\n| `layer` | string |  | *(shared \u2014 see top)* |\n| `name` | string |  |  |\n| `ref` | string | **yes** |  |\n| `params` | map: string \u2192 union \u2014 see notes |  | Overrides for the component\'s declared input variables. A string starting with "=" is a formula evaluated in the HOST scope (so it can reference the host\'s variables/points); a number is used directly. |\n| `x` | number | **yes** |  |\n| `y` | number | **yes** |  |\n| `rotation` | number |  | Standard placement: yaw\xB0 about the instance origin (clockwise, same sense as item rotation: 0=south, 90=east). Right angles (0/90/180/270) are exact for any component; a non-right angle is allowed only for furniture-only ones. |\n| `z_offset` | number |  |  |\n\n\n### `item`\n\nA free-standing GLB furniture / decor instance placed directly on a floor (for pieces that aren\'t inside an enclosed room \u2014 outdoor/site/verandah decor, a loft item, etc.). `x`/`y` are the item\'s plan CENTRE. It MAY instead anchor to a named room via `anchor_to` + `anchor` + `gap`, in which case `x`/`y` are DERIVED at expand time (same anchor model as room-nested items). `rotation` is yaw\xB0; `scale` is a uniform resize; `z_offset` lifts it above the floor base (default = slab thickness). (`itemAsset`, `itemAnchor`, `gapField` are defined above `room`.)\n\n| field | type | req | notes |\n|---|---|---|---|\n| `type` | literal `item` | **yes** |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  | *(shared \u2014 see top)* |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  | *(shared \u2014 see top)* |\n| `layer` | string |  | *(shared \u2014 see top)* |\n| `name` | string |  |  |\n| `asset` | [ItemAsset](#itemasset) | **yes** |  |\n| `x` | number | **yes** |  |\n| `y` | number | **yes** |  |\n| `rotation` | number |  |  |\n| `scale` | number > 0 |  |  |\n| `z_offset` | number |  |  |\n| `anchor_to` | string |  | Optional room-relative anchoring (for a free item that should follow a room). |\n| `anchor` | [ItemAnchor](#itemanchor) |  |  |\n| `gap_x` | number |  |  |\n| `gap_y` | number |  |  |\n\n\n### `model`\n\nA GLB placed at real scale and manipulated by a `rig` of named-node ops. Distinct from `item` (furniture, catalog + anchoring): `model` is a rigged structural asset. `asset.dimensions` is the real metre size, used for the 2D footprint and the scale.\n\n| field | type | req | notes |\n|---|---|---|---|\n| `type` | literal `model` | **yes** |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  | *(shared \u2014 see top)* |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  | *(shared \u2014 see top)* |\n| `layer` | string |  | *(shared \u2014 see top)* |\n| `name` | string |  |  |\n| `asset` | [ItemAsset](#itemasset) | **yes** |  |\n| `x` | number | **yes** |  |\n| `y` | number | **yes** |  |\n| `rotation` | number |  |  |\n| `scale` | number > 0 |  |  |\n| `z_offset` | number |  |  |\n| `rig` | array of `rigOp` |  |  |\n\n\n### `floor_slab`\n| field | type | req | notes |\n|---|---|---|---|\n| `type` | literal `floor_slab` | **yes** |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  | *(shared \u2014 see top)* |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  | *(shared \u2014 see top)* |\n| `layer` | string |  | *(shared \u2014 see top)* |\n| `name` | string |  | Label |\n| `x` | number | **yes** | Top-left X (project units) |\n| `y` | number | **yes** | Top-left Y (project units) |\n| `width` | number > 0 | **yes** | X extent (project units) |\n| `length` | number > 0 | **yes** | Y extent (project units) |\n| `thickness` | number \u2265 0 |  | Slab thickness (defaults to floor\'s) (project units) |\n| `z_offset` | number |  | Lift above floor base (project units) |\n\n\n### `pillar`\n| field | type | req | notes |\n|---|---|---|---|\n| `type` | literal `pillar` | **yes** |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  | *(shared \u2014 see top)* |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  | *(shared \u2014 see top)* |\n| `layer` | string |  | *(shared \u2014 see top)* |\n| `name` | string | **yes** | Label |\n| `x` | number | **yes** | Top-left corner X (project units) |\n| `y` | number | **yes** | Top-left corner Y (project units) |\n| `width` | number > 0 |  | X extent (project units) |\n| `length` | number > 0 |  | Y extent (project units) |\n| `height` | number > 0 | **yes** | Column height (project units) |\n| `z_offset` | number |  | Lift above floor base (project units) |\n\n\n### `beam`\n| field | type | req | notes |\n|---|---|---|---|\n| `type` | literal `beam` | **yes** |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  | *(shared \u2014 see top)* |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  | *(shared \u2014 see top)* |\n| `layer` | string |  | *(shared \u2014 see top)* |\n| `name` | string |  | Label |\n| `x` | number | **yes** | Top-left X (project units) |\n| `y` | number | **yes** | Top-left Y (project units) |\n| `width` | number > 0 | **yes** | X extent (project units) |\n| `length` | number > 0 | **yes** | Y extent (project units) |\n| `height` | number > 0 |  | Vertical thickness (project units) |\n| `z_offset` | number |  | Lift above floor base (project units) |\n\n\n### `room`\n| field | type | req | notes |\n|---|---|---|---|\n| `type` | literal `room` | **yes** |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  | *(shared \u2014 see top)* |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  | *(shared \u2014 see top)* |\n| `layer` | string |  | *(shared \u2014 see top)* |\n| `name` | string | **yes** |  |\n| `x` | number | **yes** |  |\n| `y` | number | **yes** |  |\n| `width` | number > 0 | **yes** |  |\n| `length` | number > 0 | **yes** |  |\n| `height` | number \u2265 0 |  | 0 accepted \u2014 semantically the same as absent ("use floor default"). Old configs that accidentally saved height: 0 keep loading; the form treats 0 as "no override" and doesn\'t write it back. |\n| `material` | string |  |  |\n| `z_offset` | number |  | Vertical position of the room (its floor + walls), as a lift above the FLOOR BASE (slabZ = plinth top for floor 0, else the floor below\'s top; project units, 10 = 1 ft). This is the UNIFIED z_offset convention: every object is placed at `slabZ + z_offset`. When OMITTED, on-slab objects (room, wall, staircase, kitchen_platform) default z_offset to the floor\'s resolved slab thickness (floor.slab_thickness \u2192 house.defaults.slab_thickness \u2192 code default), so by default they sit on top of the slab, exactly as before. Set it explicitly for split-level floors \u2014 e.g. a room raised onto a thicker slab uses the same value the raised slab\'s top sits at. |\n| `walls` | union \u2014 see notes |  |  |\n| `wall_heights` | map: string \u2192 [wall_heights entry](#wall-heights-entry) |  |  |\n| `items` | array of [RoomItem](#roomitem) |  | Furniture nested in this room. Each piece is anchored to the room\'s inner footprint (see roomItem), so it reflows when the room resizes. Expanded into top-level `item` objects at render time. |\n\n\n### `wall`\n| field | type | req | notes |\n|---|---|---|---|\n| `type` | literal `wall` | **yes** |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  | *(shared \u2014 see top)* |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  | *(shared \u2014 see top)* |\n| `layer` | string |  | *(shared \u2014 see top)* |\n| `name` | string | **yes** |  |\n| `start_x` | number | **yes** |  |\n| `start_y` | number | **yes** |  |\n| `end_x` | number | **yes** |  |\n| `end_y` | number | **yes** |  |\n| `height` | number > 0 |  |  |\n| `height_end` | number |  |  |\n| `material` | string |  |  |\n| `facing` | enum: `north` `south` `east` `west` |  |  |\n| `z_offset` | number |  | Lift above the FLOOR BASE (slabZ), project units. Omitted \u2192 defaults to the floor\'s resolved slab thickness (sits on the slab, as before). Set it for a split-level wall. Same convention as `room`. |\n| `openings` | array of [Opening](#opening) |  |  |\n\n\n### `staircase`\n| field | type | req | notes |\n|---|---|---|---|\n| `type` | literal `staircase` | **yes** |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  | *(shared \u2014 see top)* |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  | *(shared \u2014 see top)* |\n| `layer` | string |  | *(shared \u2014 see top)* |\n| `name` | string |  |  |\n| `climb` | enum: `up` `down` |  | `climb` picks which end (start_x, start_y) is and which way the flight runs in z as it extends into `direction`: \u2022 "up" (recommended): BOTTOM-anchored. Put the stair on the LOWER floor it rises FROM; (start_x, start_y) is the bottom step\'s near corner on that floor and the flight ASCENDS into `direction`. `rise_height` defaults to THIS floor\'s height (climb to the next level). The intuitive way. \u2022 "down" (DEFAULT, kept for older configs): TOP-anchored. Put the stair on the upper DESTINATION floor; (start_x, start_y) is the top connection and the flight DESCENDS into `direction`. `rise_height` defaults to the floor immediately BELOW this one. Either way the body + landings fill the box [start, start + max_run] along `direction`, and `z_offset` is the ANCHORED end\'s height above the floor base (omitted \u2192 this floor\'s slab thickness, flush with the walking surface). |\n| `start_x` | number | **yes** |  |\n| `start_y` | number | **yes** |  |\n| `rise_height` | number > 0 |  | Total height the stair covers, top \u2192 floor below. The step COUNT is derived: num_steps = round(rise_height / step_rise). Omitted \u2192 defaults to the height of the floor immediately below this one. Formula-capable (e.g. "= floor_height"). Replaces the old explicit `num_steps`. |\n| `step_rise` | number > 0 | **yes** |  |\n| `step_tread` | number > 0 | **yes** |  |\n| `width` | number > 0 |  | BOX MODEL (preferred): give a `width` (X) \xD7 `length` (Y) rectangle and the WHOLE staircase \u2014 flights + turn landings \u2014 is packed to fit INSIDE it. (start_x,start_y) is then the box\'s min corner, NOT the first step, and each flight\'s width is DERIVED from the box: two switchback lanes = (lateral \u2212 flight_gap)/2, or the full box for a single flight. `direction` picks the run axis (N/S \u2192 run along length/Y; E/W \u2192 run along width/X). The model errors if the box is too small for even the tightest split. Omit both to use the legacy `step_width` + `max_run` form below. |\n| `length` | number > 0 |  |  |\n| `step_width` | number > 0 |  | Legacy per-step width (required by the old form; derived from the box in the box model). The expanded single-flight staircases the renderer consumes always carry it. |\n| `direction` | enum: `north` `south` `east` `west` | **yes** | The direction the stair EXTENDS from its top \u2014 the whole assembly fills the allocated box from (start_x,start_y) going this way for up to `max_run`. |\n| `max_run` | number > 0 |  | ALLOCATED run: the length of space reserved for the stair along `direction`. The WHOLE assembly (flights + turn landings) is kept within [start, start+max_run]; when the run won\'t fit as one flight it auto-splits into switchback flights (more flights when tight), expanded in expandRoomWalls into plain staircases + floor_slab landings so every renderer is unchanged. Omit \u2192 one flight, no length limit. |\n| `landing_depth` | number > 0 |  | Turn-landing depth (along the run). Omitted \u2192 equals step_width. |\n| `landing_thickness` | number \u2265 0 |  | Turn-landing slab thickness. Omitted \u2192 equals step_rise. |\n| `turn` | enum: `clockwise` `anticlockwise` |  | Switchback handedness, reckoned DESCENDING from the top. Omitted \u2192 "clockwise". Only affects split stairs. |\n| `flight_gap` | number > 0 |  | Lateral gap between the two switchback flights (a stairwell void for a spine wall). Omitted/0 \u2192 flights are adjacent. The turn landings widen to bridge the gap. Only affects split stairs. |\n| `z_offset` | number |  | Height of the stair\'s TOP above the floor base (slabZ; project units, 10 = 1 ft). Omitted \u2192 this floor\'s slab thickness, so the top is flush with the walking surface and the flights descend to the floor below. Raise it for an internal step whose top sits above the floor. |\n| `material` | string |  |  |\n\n\n### `spiral_staircase`\n\nA helical staircase: `steps` treads winding `turns` revolutions around a central pole, from the floor to `total_height`, within `radius`. Placed by its CENTRE (x, y). Optional fields fall back to sensible defaults at render time.\n\n| field | type | req | notes |\n|---|---|---|---|\n| `type` | literal `spiral_staircase` | **yes** |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  | *(shared \u2014 see top)* |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  | *(shared \u2014 see top)* |\n| `layer` | string |  | *(shared \u2014 see top)* |\n| `name` | string |  | Label |\n| `x` | number | **yes** | Centre X (project units) |\n| `y` | number | **yes** | Centre Y (project units) |\n| `radius` | number > 0 | **yes** | Outer radius (project units) |\n| `total_height` | number > 0 | **yes** | Total rise (floor to top step) (project units) |\n| `turns` | number > 0 |  | Revolutions (default 1) |\n| `steps` | integer |  | Number of treads (default ~12 per turn) |\n| `tread_thickness` | number > 0 |  | Tread slab thickness (project units) |\n| `pole_radius` | number > 0 |  | Central pole radius (project units) |\n| `z_offset` | number |  | Lift above floor base (project units) |\n\n\n### `door`\n\nFlat door/window remain valid as a legacy schema \u2014 new configs nest them inside room.walls[side].openings or wall.openings.\n\n| field | type | req | notes |\n|---|---|---|---|\n| `type` | literal `door` | **yes** |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  | *(shared \u2014 see top)* |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  | *(shared \u2014 see top)* |\n| `layer` | string |  | *(shared \u2014 see top)* |\n| `name` | string | **yes** |  |\n| `x` | number | **yes** |  |\n| `y` | number | **yes** |  |\n| `width` | number > 0 | **yes** |  |\n| `height` | number > 0 | **yes** |  |\n| `direction` | enum: `north` `south` `east` `west` | **yes** |  |\n| `room` | string |  |  |\n| `wall` | string |  |  |\n| `open` | boolean |  |  |\n\n\n### `window`\n| field | type | req | notes |\n|---|---|---|---|\n| `type` | literal `window` | **yes** |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  | *(shared \u2014 see top)* |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  | *(shared \u2014 see top)* |\n| `layer` | string |  | *(shared \u2014 see top)* |\n| `name` | string | **yes** |  |\n| `x` | number | **yes** |  |\n| `y` | number | **yes** |  |\n| `width` | number > 0 | **yes** |  |\n| `height` | number > 0 | **yes** |  |\n| `sill_height` | number \u2265 0 |  |  |\n| `direction` | enum: `north` `south` `east` `west` | **yes** |  |\n| `room` | string |  |  |\n| `wall` | string |  |  |\n| `open` | boolean |  |  |\n\n\n### `kitchen_platform`\n\nKitchen platform \u2014 a polyline countertop / cooking slab that runs along the base of walls. Path is the wall-side edge; the platform extends `depth` units perpendicular to each segment on the given `side`. Renders as one box per path segment; corners meet at the shared point (no fancy mitering in v1).\n\n| field | type | req | notes |\n|---|---|---|---|\n| `type` | literal `kitchen_platform` | **yes** |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  | *(shared \u2014 see top)* |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  | *(shared \u2014 see top)* |\n| `layer` | string |  | *(shared \u2014 see top)* |\n| `name` | string |  |  |\n| `path` | array of tuple `[n,n]` | **yes** |  |\n| `side` | enum: `left` `right` | **yes** |  |\n| `depth` | number > 0 | **yes** |  |\n| `height` | number > 0 | **yes** |  |\n| `z_offset` | number |  | Lift above the FLOOR BASE (slabZ), project units. Omitted \u2192 defaults to the floor\'s resolved slab thickness (sits on the slab top, as before). Same convention as `room`. |\n| `base_z` | number |  |  |\n| `material` | string |  |  |\n\n\n### `roof`\n\nv2 roof \u2014 unified segment-based type that replaces hip/gable/flat/shed. Schema is permissive; the v2 pipeline (svg2d/roof/v2/) validates segments + slope + endpoint style at derivation time.\n\n\n> **Freeform:** extra fields are allowed (`.catchall`) and validated at derivation time. See `roof-v2-guide.md`.\n\n| field | type | req | notes |\n|---|---|---|---|\n| `type` | literal `roof` | **yes** |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  | *(shared \u2014 see top)* |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  | *(shared \u2014 see top)* |\n\n\n## Shared & nested schemas\n\n### site\n\nObjects don\'t bind to the grid with a special field \u2014 a grid line\'s position is published as a formula symbol (`<gridId>.x<name>` / `.y<name>`, see param/resolve.ts), so a room places itself with ordinary `formulas`, e.g. { x: "= main.x1", width: "= main.x5 - main.x1" }. With coord_convention:"center" those are wall centrelines and expandRoomWalls handles the wall extent.\n\n| field | type | req | notes |\n|---|---|---|---|\n| `reference_x` | number | **yes** |  |\n| `reference_y` | number | **yes** |  |\n| `plot_length` | number > 0 | **yes** |  |\n| `plot_width` | number > 0 | **yes** |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  |  |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  |  |\n\n\n### houseDefaults\n\nHouse-level overrides for the built-in GlobalConfig defaults. Every floor without its own value falls back to these; if these are absent too, the code defaults in DEFAULT_GLOBAL_CONFIG apply.\n\n| field | type | req | notes |\n|---|---|---|---|\n| `floor_height` | number > 0 |  |  |\n| `wall_height` | number > 0 |  |  |\n| `slab_thickness` | number \u2265 0 |  |  |\n| `wall_thickness` | number > 0 |  | House-wide wall thickness (project units). Per-object `wall_thickness`/`thickness` overrides still win. Falls back to the code default (DEFAULT_GLOBAL_CONFIG.wall_thickness = 8) when omitted. |\n| `formulas` | map: field name \u2192 `"= formula"` string |  |  |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  |  |\n\n\n### units\n\nHow dimensions are LABELLED on the drawings. Display-only \u2014 geometry always stays in project units; this just controls the text on the dimension lines. Omitted = the built-in default (feet & inches, 10 project units = 1 ft).\n\n| field | type | req | notes |\n|---|---|---|---|\n| `system` | enum: `feet_inches` `feet` `meters` `centimeters` `millimeters` |  | feet_inches \u2192 12\' 6" ; the rest \u2192 decimal with a unit suffix. |\n| `per_unit` | number > 0 |  | Project units that equal ONE display unit (10 \u2192 10 units = 1 ft; 100 \u2192 100 units = 1 m). Default 10. |\n| `precision` | integer \u2265 0 |  | Decimal places for the non-feet_inches systems. |\n\n\n### Opening\n\nThe plinth is now a normal object placed on the "Plinth" floor (the first floor, number 0), not a top-level config key. Its footprint + height match the old top-level plinth; the plinth floor\'s `height` drives the rise to the floor above (replacing the old hardcoded plinth_height seed). `plinth` + `ground` are GENERATED from fields (schema/fields/{plinth,ground}.ts), imported above as plinthObject / groundObject. (P2b)\n\n| field | type | req | notes |\n|---|---|---|---|\n| `kind` | enum: `door` `window` | **yes** |  |\n| `name` | string |  |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  | Numeric fields hold the RESOLVED value; a `= formula` for any of them lives in `formulas` (e.g. formulas.offset), evaluated by resolveParametric against the house variables/points \u2014 same pattern as every other object. |\n| `offset` | number | **yes** | Any number: `center` anchor takes a signed shift; the resolved placement is fit-checked against the wall in expand.ts, so a bad value errors there. |\n| `anchor` | enum: `start` `center` `end` |  | Which end of the wall `offset` is measured from, so the opening holds its place when the wall/room scales \u2014 no formula needed. `start` (default, legacy): offset from the wall start to the near edge. `end`: offset from the wall end to the far edge (0 = flush to the end). `center`: signed shift of the opening centre from the wall midpoint (0 = centred; may be negative). Resolved to a start-based offset in expand.ts (openingAnchor.ts). |\n| `width` | number > 0 | **yes** |  |\n| `height` | number > 0 | **yes** |  |\n| `sill_height` | number |  |  |\n| `direction` | enum: `north` `south` `east` `west` |  |  |\n| `facing` | enum: `north` `south` `east` `west` |  |  |\n| `open` | boolean |  | When true, the opening is left BARE (just a hole) \u2014 no glazing/frame for a window, no leaf for a door \u2014 e.g. an open doorway or unglazed vent. |\n\n\n### RoomWallSide\n| field | type | req | notes |\n|---|---|---|---|\n| `height` | number |  |  |\n| `height_end` | number |  |  |\n| `openings` | array of [Opening](#opening) |  |  |\n\n\n### RoomItem\n\nA furniture piece nested INSIDE a room (room.items[]). It has NO x/y \u2014 its plan position is DERIVED at expand time from the parent room\'s footprint + `anchor` + per-axis gap (+ its own `rotation`). Flattened into a top-level `item` for every renderer. `gap_x`/`gap_y` are the inset (project units) kept from the anchor into the room (edge/corner anchor \u2192 clears the wall; centre anchor \u2192 signed offset, +x east / +y south). `gap_x`/`gap_y`/`rotation`/`scale`/`z_offset` are all plain numeric fields so each can be driven by a `= formula` (via the `formulas` map).\n\n| field | type | req | notes |\n|---|---|---|---|\n| `name` | string |  |  |\n| `formulas` | map: field name \u2192 `"= formula"` string |  |  |\n| `enabled` | boolean or number (`false`/`0` = hidden) |  |  |\n| `layer` | string |  |  |\n| `asset` | [ItemAsset](#itemasset) | **yes** |  |\n| `anchor` | [ItemAnchor](#itemanchor) |  |  |\n| `gap_x` | number |  |  |\n| `gap_y` | number |  |  |\n| `rotation` | number |  |  |\n| `scale` | number > 0 |  |  |\n| `z_offset` | number |  |  |\n\n\n### ItemAsset\n\nFurniture (GLB `item`) \u2014 shared schema pieces Defined BEFORE `room` so a room can nest its own `items[]`. Asset distances are METRES (the GLB\'s native unit); the 3D/2D layers scale them into project units. See registry/nodes/item + three/units. The asset backing a furniture item \u2014 stored INLINE so a .wadi is self-contained (share links / web load the GLB from `src`). A catalog is just a picker convenience.\n\n| field | type | req | notes |\n|---|---|---|---|\n| `id` | string | **yes** |  |\n| `name` | string |  |  |\n| `src` | string | **yes** |  |\n| `dimensions` | tuple `[n>0,n>0,n>0]` | **yes** |  |\n| `thumbnail` | string |  |  |\n| `floorPlanUrl` | string |  |  |\n| `category` | string |  |  |\n| `tags` | array of string |  |  |\n| `offset` | tuple `[n,n,n]` |  |  |\n| `corrRotation` | tuple `[n,n,n]` |  |  |\n| `corrScale` | tuple `[n>0,n>0,n>0]` |  |  |\n\n\n### ComponentDef\n| field | type | req | notes |\n|---|---|---|---|\n| `name` | string |  |  |\n| `goal` | string |  | A short natural-language description of what this component accomplishes (the discovery key for goal-based module lookup, e.g. "climb to the next floor"). Purely metadata \u2014 renderers ignore it. |\n| `params` | array of [ComponentParam](#componentparam) |  |  |\n| `variables` | map: string \u2192 number, or `"= formula"` string |  |  |\n| `points` | map: string \u2192 inline object |  |  |\n| `objects` | array of [Object types](#object-types) | **yes** |  |\n| `expose` | inline object |  | Promote this component to a typed primitive at load time (plans/declarative-plugins.md P0). When present, the component registers a NodeDefinition of type `expose.type` whose fields come from `params`; it can then be used like any core object type. `type` is namespaced (`pack.thing`). |\n\n\n### ComponentParam\n\nA reusable component DEFINITION in the in-file `components` library. It is a mini-house: its own `variables`/`points` and a flat `objects` body authored in LOCAL coords (origin 0,0). `params` names which variables are the public inputs (label/default for the instance form). A `component` instance overrides those variables and places the body at its (x,y,z_offset). Stored once; referenced by many instances.\n\n| field | type | req | notes |\n|---|---|---|---|\n| `name` | string | **yes** |  |\n| `label` | string |  |  |\n| `description` | string |  |  |\n| `default` | number |  |  |\n| `kind` | string |  | Field-projection annotations, used only when the component is `expose`d as a typed primitive (plans/declarative-plugins.md). `kind` is a FieldKind preset (coord/extent/nonneg/int/text/flag/enum); when absent the kind is inferred from the default\'s type. `unit` is a doc-only unit hint. |\n| `unit` | string |  |  |\n\n\n### LayerDef\n\nA visibility layer for the 3D view. Each object may reference a layer by `id` (via its `layer` field); the layers menu toggles whole layers on/off. Display-only \u2014 never affects geometry. Optional: when absent, a built-in default layer set is used, and objects fall back to an automatic per-type/floor mapping.\n\n| field | type | req | notes |\n|---|---|---|---|\n| `id` | string (non-empty) | **yes** |  |\n| `label` | string | **yes** |  |\n| `color` | string |  |  |\n| `group` | string |  | Friendly group for the owner "Show/hide layers" menu (e.g. "Roof", "Walls"). Layers sharing a group toggle together. Optional. |\n\n\n### configurator\n| field | type | req | notes |\n|---|---|---|---|\n| `title` | string |  |  |\n| `description` | string |  |  |\n| `groups` | array of inline object |  |  |\n| `inputs` | array of [ConfiguratorInput](#configuratorinput) | **yes** |  |\n\n\n### ConfiguratorInput\n\nConfigurator (Gharkul owner UI) Optional, author-supplied metadata: which `variables`/`points` a template exposes to end users, and how to present them. IGNORED by the resolver and every geometry consumer \u2014 read only by the owner-facing Configurator UI. `target` is a variable name (e.g. "floorH") or a point coordinate ("House.W" \u2192 points.House.x; W/L/X/Y/x/y are resolver synonyms). `min`/`max`/ `step` are in RAW project units; `unit` only affects display.\n\n| field | type | req | notes |\n|---|---|---|---|\n| `target` | string (non-empty) | **yes** |  |\n| `label` | string (non-empty) | **yes** |  |\n| `description` | string |  |  |\n| `control` | enum: `slider` `number` `select` `toggle` |  |  |\n| `unit` | enum: `ft` `in` `m` `units` `percent` `count` `none` |  |  |\n| `min` | number |  |  |\n| `max` | number |  |  |\n| `step` | number > 0 |  |  |\n| `options` | array of inline object |  |  |\n| `group` | string |  |  |\n\n\n### ItemAnchor\n\n9-point anchor on a room\'s INNER footprint. First token = vertical (top = north \u2026 bottom = south), second = horizontal (left = west \u2026 right = east); "center" alone = both. The item aligns its matching edge/corner to this spot, held `gap` off it, into the room \u2014 so it reflows when the room is resized.\n\nEnum: `top-left` `top-center` `top-right` `center-left` `center` `center-right` `bottom-left` `bottom-center` `bottom-right`\n'
   }
 };
 var MODULES = {