@pascal-app/core 1.0.6 → 1.0.7

package/dist/schema/nodes/railing-wall.js

@@ -0,0 +1,160 @@
+import { z } from 'zod';
+import { StairRailingStyle } from './stair-types.js';
+/**
+ * A railing wall (`WallNode.wallType: 'railing'`): drawn and joined
+ * like any wall, and like any wall it closes rooms (a deck or a porch its railings fence is a
+ * room), but it stands as an open guard instead of a framed body: posts at its ends and equally
+ * spaced between them, rails, and the infill its style sets. Its doors are gaps in the guard (a
+ * doorway: no leaf, casing or threshold), with a post either side. It takes no finishes, assembly,
+ * framing or foundation, and it keeps its own height rather than following the storey.
+ */
+const INCH = 0.0254;
+/** A guard's height over the floor, IRC R312.1.2: 36 in where the drop is more than 30 in. */
+export const RAILING_GUARD_HEIGHT = 36 * INCH;
+/** The taller guard the IBC (1015.3) and some local codes ask for: 42 in. */
+export const RAILING_GUARD_HEIGHT_TALL = 42 * INCH;
+/** The largest sphere a guard's openings may pass, IRC R312.1.3: 4 in. */
+export const RAILING_SPHERE_LIMIT = 4 * INCH;
+/** Guard posts on centre at most this far apart: 6 ft, the AWC Deck Construction Guide (DCA 6). */
+export const RAILING_MAX_POST_SPACING = 72 * INCH;
+/** The railing styles: the stair guards' vocabulary (`StairRailingStyle`). */
+export const RailingWallStyle = StairRailingStyle;
+/**
+ * How a railing wall is built, metres. The guard's height is the wall's own `height`; its
+ * `thickness` follows `postSize`, so the plan outline and the room it closes run along the posts.
+ * - `postSpacing`: the most the posts stand apart on centre; they are equally spaced between the
+ *   run's ends (each end, and each side of an opening, has its post).
+ * - `postSize`: the posts' square section.
+ * - `infillSize`: a baluster's (picket's, bar's) square section, a cable's diameter, a board's
+ *   face height, a glass pane's thickness.
+ * - `infillGap`: the clear space between the infill members (keep it under the 4 in sphere).
+ * - `bottomClearance`: the clear space under the bottom rail (or the lowest infill) over the floor.
+ * - `cap`: a 2x6 cap laid flat over the top rail (the post-and-rail and boards styles).
+ */
+export const RailingWallConfig = z.object({
+    style: RailingWallStyle.default('post-and-rail'),
+    postSpacing: z.number().finite().positive().default(RAILING_MAX_POST_SPACING),
+    postSize: z
+        .number()
+        .finite()
+        .positive()
+        .default(3.5 * INCH),
+    infillSize: z
+        .number()
+        .finite()
+        .positive()
+        .default(1.5 * INCH),
+    infillGap: z
+        .number()
+        .finite()
+        .nonnegative()
+        .default(3.5 * INCH),
+    bottomClearance: z
+        .number()
+        .finite()
+        .nonnegative()
+        .default(3.5 * INCH),
+    cap: z.boolean().default(true),
+});
+/**
+ * The default railing: the DCA 6 deck guard — 4x4 posts at most 6 ft apart, a 2x6 cap over a
+ * 2x4 top rail, a 2x4 bottom rail 3½ in off the floor, and 2x2 balusters 3½ in clear.
+ */
+export const DEFAULT_RAILING_WALL = RailingWallConfig.parse({});
+/**
+ * The members each style is drawn with when picked: its posts' section, its infill's section and
+ * clear gap, and its clearance over the floor (the stair guards' members, `nodes/stair/*-guard`).
+ */
+export const RAILING_STYLE_DEFAULTS = {
+    // DCA 6: 4x4 posts, 2x2 balusters 3½ in clear on a 2x4 bottom rail 3½ in up.
+    'post-and-rail': {
+        postSize: 3.5 * INCH,
+        infillSize: 1.5 * INCH,
+        infillGap: 3.5 * INCH,
+        bottomClearance: 3.5 * INCH,
+    },
+    // Joinery: newels, 1¼ in square balusters between a handrail and a shoe rail.
+    balusters: {
+        postSize: 3.5 * INCH,
+        infillSize: 1.25 * INCH,
+        infillGap: 3.5 * INCH,
+        bottomClearance: 2.25 * INCH,
+    },
+    // 2 in posts, ⅜ in cables 3 in on centre under a flat cap.
+    cable: {
+        postSize: 2 * INCH,
+        infillSize: 0.375 * INCH,
+        infillGap: 2.625 * INCH,
+        bottomClearance: 2.75 * INCH,
+    },
+    // 4x4 posts, 1x6 boards on the flat 3½ in apart under a 2x6 cap.
+    boards: {
+        postSize: 3.5 * INCH,
+        infillSize: 5.5 * INCH,
+        infillGap: 3.5 * INCH,
+        bottomClearance: 3.5 * INCH,
+    },
+    // 1½ in posts and one ½ in tempered pane per bay.
+    glass: {
+        postSize: 1.5 * INCH,
+        infillSize: 0.5 * INCH,
+        infillGap: 0,
+        bottomClearance: 3 * INCH,
+    },
+    // 1½ in steel posts on baseplates, ⅝ in square bars between two flat rails.
+    metal: {
+        postSize: 1.5 * INCH,
+        infillSize: 0.625 * INCH,
+        infillGap: 3.75 * INCH,
+        bottomClearance: 3 * INCH,
+    },
+};
+/** A railing wall's config with every field present: its own over the defaults. */
+export function getRailingWallConfig(wall) {
+    return wall.railing ? { ...DEFAULT_RAILING_WALL, ...wall.railing } : DEFAULT_RAILING_WALL;
+}
+/** Whether a node is a railing wall. */
+export function isRailingWall(node) {
+    return node?.type === 'wall' && node.wallType === 'railing';
+}
+/** A railing's height: its own, else the 36 in guard (a railing never follows the storey). */
+export function getRailingWallHeight(wall) {
+    return wall.height ?? RAILING_GUARD_HEIGHT;
+}
+/**
+ * What a newly drawn railing wall is (the Build panel's Railing): a railing of `style` with that
+ * style's members, as thick as its posts, 36 in tall, and no assembly (a railing has no layers).
+ */
+export function railingWallDefaults(style = 'post-and-rail') {
+    const railing = { ...DEFAULT_RAILING_WALL, ...RAILING_STYLE_DEFAULTS[style], style };
+    return {
+        wallType: 'railing',
+        thickness: railing.postSize,
+        height: RAILING_GUARD_HEIGHT,
+        railing,
+        assembly: undefined,
+    };
+}
+/**
+ * What a door placed on a railing becomes: a gap in the guard as tall as the guard, with no leaf,
+ * casing or threshold. The guard stands a post either side of it.
+ */
+export function railingOpeningFields(wall) {
+    return {
+        openingKind: 'opening',
+        height: getRailingWallHeight(wall),
+        threshold: false,
+        casingFaceA: false,
+        casingFaceB: false,
+    };
+}
+const WOOD_STYLES = new Set(['post-and-rail', 'balusters', 'boards']);
+/**
+ * What an unpainted railing shows: a wood guard painted white, a metal one steel, and glass
+ * panes glass.
+ */
+export function railingWallSlotDefault(style, slot) {
+    if (slot === 'railing-infill' && style === 'glass')
+        return 'library:preset-glass';
+    return WOOD_STYLES.has(style) ? 'library:preset-white' : 'library:metal-steel';
+}

package/dist/schema/nodes/ridge-vent.d.ts

@@ -79,6 +79,11 @@ export declare const RidgeVentNode: z.ZodObject<{
             url: z.ZodString;
             repeat: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
             scale: z.ZodOptional<z.ZodNumber>;
+            offset: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+            normalMap: z.ZodOptional<z.ZodString>;
+            normalScale: z.ZodOptional<z.ZodNumber>;
+            bumpMap: z.ZodOptional<z.ZodString>;
+            bumpScale: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
     materialPreset: z.ZodOptional<z.ZodString>;

package/dist/schema/nodes/ridge-vent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ridge-vent.d.ts","sourceRoot":"","sources":["../../../src/schema/nodes/ridge-vent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,gBAAgB,CAAA;AAyBvB,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACvB,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACtB,CAAA;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8BzB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA;AAEzD,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,eAAe,GAAG,aAAa,EAAE,CA0JrF;AAQD,wBAAgB,iCAAiC,CAAC,OAAO,EAAE,eAAe,GAAG,aAAa,EAAE,CAiB3F;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,OAAO,EACb,aAAa,CAAC,EAAE,eAAe,CAAC,IAAI,CAAC,GACpC,IAAI,IAAI,aAAa,CAyBvB;AASD,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC,GACzC,OAAO,IAAI,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC,GAAG;IAChD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;QAAE,aAAa,EAAE,OAAO,CAAA;KAAE,CAAA;CAC/D,CAEA;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,GAAG,UAAU,GAAG,UAAU,CAAC,EAC9D,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAUT"}
+{"version":3,"file":"ridge-vent.d.ts","sourceRoot":"","sources":["../../../src/schema/nodes/ridge-vent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,gBAAgB,CAAA;AAyBvB,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACvB,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACtB,CAAA;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8BzB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA;AAEzD,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,eAAe,GAAG,aAAa,EAAE,CA0JrF;AAQD,wBAAgB,iCAAiC,CAAC,OAAO,EAAE,eAAe,GAAG,aAAa,EAAE,CAiB3F;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,OAAO,EACb,aAAa,CAAC,EAAE,eAAe,CAAC,IAAI,CAAC,GACpC,IAAI,IAAI,aAAa,CAyBvB;AASD,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC,GACzC,OAAO,IAAI,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC,GAAG;IAChD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;QAAE,aAAa,EAAE,OAAO,CAAA;KAAE,CAAA;CAC/D,CAEA;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,GAAG,UAAU,GAAG,UAAU,CAAC,EAC9D,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAUT"}

package/dist/schema/nodes/roof-segment.d.ts

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 import type { MaterialSchema as MaterialSchemaType } from '../material.js';
 import { RoofType } from './roof-types.js';
-export { RoofType } from './roof-types.js';
+export { RoofEaveCut, RoofType } from './roof-types.js';
 export declare const MIN_ROOF_SEGMENT_TRIM_SPAN = 0.1;
 export declare const RoofSegmentTrim: z.ZodDefault<z.ZodObject<{
     left: z.ZodDefault<z.ZodNumber>;
@@ -121,6 +121,11 @@ export declare const RoofSegmentNode: z.ZodObject<{
             url: z.ZodString;
             repeat: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
             scale: z.ZodOptional<z.ZodNumber>;
+            offset: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+            normalMap: z.ZodOptional<z.ZodString>;
+            normalScale: z.ZodOptional<z.ZodNumber>;
+            bumpMap: z.ZodOptional<z.ZodString>;
+            bumpScale: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
     materialPreset: z.ZodOptional<z.ZodString>;
@@ -154,6 +159,11 @@ export declare const RoofSegmentNode: z.ZodObject<{
             url: z.ZodString;
             repeat: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
             scale: z.ZodOptional<z.ZodNumber>;
+            offset: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+            normalMap: z.ZodOptional<z.ZodString>;
+            normalScale: z.ZodOptional<z.ZodNumber>;
+            bumpMap: z.ZodOptional<z.ZodString>;
+            bumpScale: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
     topMaterialPreset: z.ZodOptional<z.ZodString>;
@@ -187,6 +197,11 @@ export declare const RoofSegmentNode: z.ZodObject<{
             url: z.ZodString;
             repeat: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
             scale: z.ZodOptional<z.ZodNumber>;
+            offset: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+            normalMap: z.ZodOptional<z.ZodString>;
+            normalScale: z.ZodOptional<z.ZodNumber>;
+            bumpMap: z.ZodOptional<z.ZodString>;
+            bumpScale: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
     edgeMaterialPreset: z.ZodOptional<z.ZodString>;
@@ -220,6 +235,11 @@ export declare const RoofSegmentNode: z.ZodObject<{
             url: z.ZodString;
             repeat: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
             scale: z.ZodOptional<z.ZodNumber>;
+            offset: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+            normalMap: z.ZodOptional<z.ZodString>;
+            normalScale: z.ZodOptional<z.ZodNumber>;
+            bumpMap: z.ZodOptional<z.ZodString>;
+            bumpScale: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
     wallMaterialPreset: z.ZodOptional<z.ZodString>;
@@ -326,6 +346,72 @@ export declare const RoofSegmentNode: z.ZodObject<{
     overhang: z.ZodDefault<z.ZodNumber>;
     gableOverhang: z.ZodOptional<z.ZodNumber>;
     shingleThickness: z.ZodDefault<z.ZodNumber>;
+    buildUp: z.ZodOptional<z.ZodObject<{
+        presetId: z.ZodOptional<z.ZodString>;
+        roofing: z.ZodObject<{
+            kind: z.ZodEnum<{
+                "architectural-shingle": "architectural-shingle";
+                "asphalt-3-tab": "asphalt-3-tab";
+                "clay-tile": "clay-tile";
+                "concrete-tile": "concrete-tile";
+                slate: "slate";
+                "standing-seam-metal": "standing-seam-metal";
+                "wood-shake": "wood-shake";
+            }>;
+            thickness: z.ZodNumber;
+            name: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        underlayment: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodEnum<{
+                "felt-15": "felt-15";
+                "felt-30": "felt-30";
+                "ice-and-water": "ice-and-water";
+                synthetic: "synthetic";
+            }>;
+            thickness: z.ZodNumber;
+            name: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        sheathing: z.ZodObject<{
+            kind: z.ZodEnum<{
+                osb: "osb";
+                plywood: "plywood";
+            }>;
+            thickness: z.ZodNumber;
+            name: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        structure: z.ZodObject<{
+            system: z.ZodEnum<{
+                rafters: "rafters";
+                trusses: "trusses";
+            }>;
+            size: z.ZodEnum<{
+                "2x10": "2x10";
+                "2x12": "2x12";
+                "2x4": "2x4";
+                "2x6": "2x6";
+                "2x8": "2x8";
+            }>;
+            spacing: z.ZodNumber;
+        }, z.core.$strip>;
+        insulation: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodEnum<{
+                batt: "batt";
+                blown: "blown";
+                rigid: "rigid";
+            }>;
+            thickness: z.ZodNumber;
+            name: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        finish: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodEnum<{
+                drywall: "drywall";
+                plaster: "plaster";
+                "wood-plank": "wood-plank";
+            }>;
+            thickness: z.ZodNumber;
+            name: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
     arc: z.ZodOptional<z.ZodObject<{
         centerX: z.ZodNumber;
         centerZ: z.ZodNumber;
@@ -354,6 +440,11 @@ export declare const RoofSegmentNode: z.ZodObject<{
     }>>;
     shedInsetEndPanels: z.ZodDefault<z.ZodBoolean>;
     fascia: z.ZodOptional<z.ZodBoolean>;
+    eaveCut: z.ZodOptional<z.ZodEnum<{
+        plumb: "plumb";
+        "plumb-level": "plumb-level";
+        square: "square";
+    }>>;
     fasciaHighEdge: z.ZodOptional<z.ZodBoolean>;
     fasciaHeight: z.ZodOptional<z.ZodNumber>;
     fasciaDepth: z.ZodOptional<z.ZodNumber>;
@@ -387,9 +478,128 @@ export declare const RoofSegmentNode: z.ZodObject<{
             url: z.ZodString;
             repeat: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
             scale: z.ZodOptional<z.ZodNumber>;
+            offset: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+            normalMap: z.ZodOptional<z.ZodString>;
+            normalScale: z.ZodOptional<z.ZodNumber>;
+            bumpMap: z.ZodOptional<z.ZodString>;
+            bumpScale: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
     fasciaMaterialPreset: z.ZodOptional<z.ZodString>;
+    heelMaterial: z.ZodOptional<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        preset: z.ZodOptional<z.ZodCatch<z.ZodEnum<{
+            brick: "brick";
+            concrete: "concrete";
+            custom: "custom";
+            glass: "glass";
+            marble: "marble";
+            metal: "metal";
+            plaster: "plaster";
+            tile: "tile";
+            white: "white";
+            wood: "wood";
+        }>>>;
+        properties: z.ZodOptional<z.ZodObject<{
+            color: z.ZodDefault<z.ZodString>;
+            roughness: z.ZodDefault<z.ZodNumber>;
+            metalness: z.ZodDefault<z.ZodNumber>;
+            opacity: z.ZodDefault<z.ZodNumber>;
+            transparent: z.ZodDefault<z.ZodBoolean>;
+            side: z.ZodDefault<z.ZodEnum<{
+                back: "back";
+                double: "double";
+                front: "front";
+            }>>;
+        }, z.core.$strip>>;
+        texture: z.ZodOptional<z.ZodObject<{
+            url: z.ZodString;
+            repeat: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+            scale: z.ZodOptional<z.ZodNumber>;
+            offset: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+            normalMap: z.ZodOptional<z.ZodString>;
+            normalScale: z.ZodOptional<z.ZodNumber>;
+            bumpMap: z.ZodOptional<z.ZodString>;
+            bumpScale: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    heelMaterialPreset: z.ZodOptional<z.ZodString>;
+    gableLeftMaterial: z.ZodOptional<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        preset: z.ZodOptional<z.ZodCatch<z.ZodEnum<{
+            brick: "brick";
+            concrete: "concrete";
+            custom: "custom";
+            glass: "glass";
+            marble: "marble";
+            metal: "metal";
+            plaster: "plaster";
+            tile: "tile";
+            white: "white";
+            wood: "wood";
+        }>>>;
+        properties: z.ZodOptional<z.ZodObject<{
+            color: z.ZodDefault<z.ZodString>;
+            roughness: z.ZodDefault<z.ZodNumber>;
+            metalness: z.ZodDefault<z.ZodNumber>;
+            opacity: z.ZodDefault<z.ZodNumber>;
+            transparent: z.ZodDefault<z.ZodBoolean>;
+            side: z.ZodDefault<z.ZodEnum<{
+                back: "back";
+                double: "double";
+                front: "front";
+            }>>;
+        }, z.core.$strip>>;
+        texture: z.ZodOptional<z.ZodObject<{
+            url: z.ZodString;
+            repeat: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+            scale: z.ZodOptional<z.ZodNumber>;
+            offset: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+            normalMap: z.ZodOptional<z.ZodString>;
+            normalScale: z.ZodOptional<z.ZodNumber>;
+            bumpMap: z.ZodOptional<z.ZodString>;
+            bumpScale: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    gableLeftMaterialPreset: z.ZodOptional<z.ZodString>;
+    gableRightMaterial: z.ZodOptional<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        preset: z.ZodOptional<z.ZodCatch<z.ZodEnum<{
+            brick: "brick";
+            concrete: "concrete";
+            custom: "custom";
+            glass: "glass";
+            marble: "marble";
+            metal: "metal";
+            plaster: "plaster";
+            tile: "tile";
+            white: "white";
+            wood: "wood";
+        }>>>;
+        properties: z.ZodOptional<z.ZodObject<{
+            color: z.ZodDefault<z.ZodString>;
+            roughness: z.ZodDefault<z.ZodNumber>;
+            metalness: z.ZodDefault<z.ZodNumber>;
+            opacity: z.ZodDefault<z.ZodNumber>;
+            transparent: z.ZodDefault<z.ZodBoolean>;
+            side: z.ZodDefault<z.ZodEnum<{
+                back: "back";
+                double: "double";
+                front: "front";
+            }>>;
+        }, z.core.$strip>>;
+        texture: z.ZodOptional<z.ZodObject<{
+            url: z.ZodString;
+            repeat: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+            scale: z.ZodOptional<z.ZodNumber>;
+            offset: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+            normalMap: z.ZodOptional<z.ZodString>;
+            normalScale: z.ZodOptional<z.ZodNumber>;
+            bumpMap: z.ZodOptional<z.ZodString>;
+            bumpScale: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    gableRightMaterialPreset: z.ZodOptional<z.ZodString>;
     gambrelLowerWidthRatio: z.ZodDefault<z.ZodNumber>;
     gambrelLowerHeightRatio: z.ZodDefault<z.ZodNumber>;
     mansardSteepWidthRatio: z.ZodDefault<z.ZodNumber>;
@@ -516,6 +726,19 @@ export type RoofSegmentSurfaceMaterialSpec = {
  * to fill in for an unset segment slot — typical from the renderer.
  */
 export declare function getEffectiveSegmentSurfaceMaterial(node: RoofSegmentNode, role: RoofSegmentSurfaceMaterialRole, parentFallback?: RoofSegmentSurfaceMaterialSpec): RoofSegmentSurfaceMaterialSpec;
+/** A segment's wall-band surfaces painted apart from the edge role: the heel band and each gable. */
+export type RoofWallBand = 'heel' | 'gable-left' | 'gable-right';
+export declare const ROOF_WALL_BANDS: readonly RoofWallBand[];
+/** The node fields one wall band's finish is stored in. */
+export declare function roofWallBandFields(band: RoofWallBand): {
+    material: "gableLeftMaterial" | "gableRightMaterial" | "heelMaterial";
+    materialPreset: "gableLeftMaterialPreset" | "gableRightMaterialPreset" | "heelMaterialPreset";
+};
+/**
+ * A wall band's own finish on a segment (or, for the heel, a roof), or null when it has none and
+ * the band follows its fallback: the heel the roof's, then the walls' below; a gable the edge role.
+ */
+export declare function getRoofWallBandMaterial(node: Partial<Pick<RoofSegmentNode, 'heelMaterial' | 'heelMaterialPreset' | 'gableLeftMaterial' | 'gableLeftMaterialPreset' | 'gableRightMaterial' | 'gableRightMaterialPreset'>>, band: RoofWallBand): RoofSegmentSurfaceMaterialSpec | null;
 /** The fascia and rake boards' own finish, or null when they take the wall role's. */
 export declare function getSegmentFasciaMaterial(node: RoofSegmentNode): RoofSegmentSurfaceMaterialSpec | null;
 /**

package/dist/schema/nodes/roof-segment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"roof-segment.d.ts","sourceRoot":"","sources":["../../../src/schema/nodes/roof-segment.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"roof-segment.d.ts","sourceRoot":"","sources":["../../../src/schema/nodes/roof-segment.ts"],"names":[],"mappings":"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"}

package/dist/schema/nodes/roof-segment.js

@@ -1,11 +1,12 @@
 import dedent from 'dedent';
 import { z } from 'zod';
 import { BaseNode, nodeType, objectId } from '../base.js';
+import { RoofBuildUp } from '../build-up.js';
 import { MaterialSchema } from '../material.js';
 import { getBarrelRoofProfile } from './barrel-roof.js';
 import { RoofGlazing, RoofSystemType } from './roof-glazing.js';
-import { RoofType } from './roof-types.js';
-export { RoofType } from './roof-types.js';
+import { RoofEaveCut, RoofType } from './roof-types.js';
+export { RoofEaveCut, RoofType } from './roof-types.js';
 export const MIN_ROOF_SEGMENT_TRIM_SPAN = 0.1;
 const DEFAULT_ROOF_SEGMENT_WIDTH = 8;
 const DEFAULT_ROOF_SEGMENT_DEPTH = 6;
@@ -135,6 +136,9 @@ export const RoofSegmentNode = BaseNode.extend({
     // gambrel's ends, a shed's sides). Absent, as far as the eaves reach (`overhang` is along the slope).
     gableOverhang: z.number().min(0).optional(),
     shingleThickness: z.number().default(0.05),
+    // The plane's layers, outside in. Present, `deckThickness` and `shingleThickness` are derived
+    // from it and written with it (`roofBuildUpPatch`); absent, they are the plane's own.
+    buildUp: RoofBuildUp.optional(),
     arc: z
         .object({
         centerX: z.number(),
@@ -163,20 +167,32 @@ export const RoofSegmentNode = BaseNode.extend({
     managedByParent: z.boolean().default(false),
     wallShell: z.enum(['auto', 'include', 'omit']).default('auto'),
     shedInsetEndPanels: z.boolean().default(false),
-    // Plumb 1x8 fascia and rake boards on the eaves and rakes (gable, hip,
-    // shed, flat), built from the segment itself so they follow its pitch,
-    // size, overhang and type.
+    // Fascia and rake boards on the eaves and rakes (gable, hip, shed, flat), built from the segment
+    // itself so they follow its pitch, size, overhang, layers and eave cut (core's `roofEaveProfile`).
     fascia: z.boolean().optional(),
+    // How the rafter tails are cut at the eaves, the fascia with them (`RoofEaveCut`); absent, plumb.
+    eaveCut: RoofEaveCut.optional(),
     // Shed only: the board on the high edge. Off when that edge meets a wall
     // (a porch cover on a ledger); a lean-to never has one.
     fasciaHighEdge: z.boolean().optional(),
-    // The boards' height and thickness; a 1x8 (0.184 × 0.019 m) when absent. With a height set, a
-    // flat roof's boards rise to the roof's top: a coping band over the deck and membrane edges.
+    // The boards' height and thickness; absent, a 1x as deep as the tails need (`roofEaveProfile`).
+    // With a height set, a flat roof's boards rise to the roof's top: a coping band over the deck and
+    // membrane edges.
     fasciaHeight: z.number().positive().optional(),
     fasciaDepth: z.number().positive().optional(),
     // The boards' and rakes' own finish; absent, they take the wall role's, as they always did.
     fasciaMaterial: MaterialSchema.optional(),
     fasciaMaterialPreset: z.string().optional(),
+    // The wall band between the top plate and the eaves (a raised heel) is wall, not trim: its own
+    // finish; absent, the roof's, then the walls' below it.
+    heelMaterial: MaterialSchema.optional(),
+    heelMaterialPreset: z.string().optional(),
+    // Each gable end's own finish (−x is the left, +x the right, as `getRoofSegmentWallFaces` names
+    // them); absent, the edge role's, as every gable took before they could be painted apart.
+    gableLeftMaterial: MaterialSchema.optional(),
+    gableLeftMaterialPreset: z.string().optional(),
+    gableRightMaterial: MaterialSchema.optional(),
+    gableRightMaterialPreset: z.string().optional(),
     // Shape-specific ratios. Only the pair matching `roofType` is read; the
     // rest are inert. Defined on every segment so the panel can flip
     // roofType without losing the previous shape's tuning.
@@ -247,10 +263,14 @@ export const RoofSegmentNode = BaseNode.extend({
   - overhang: eave overhang distance, along the slope
   - gableOverhang: reach past the gable-end walls in plan (gable, gambrel, shed); absent = the eaves' reach
   - shingleThickness: outer shingle layer thickness
-  - fascia: plumb fascia and rake boards on the eaves and rakes (gable, hip, shed, flat) (off when absent)
+  - buildUp: layers outside in (roofing, underlayment, sheathing, structure, insulation, finish); sets deckThickness and shingleThickness
+  - fascia: fascia and rake boards on the eaves and rakes (gable, hip, shed, flat) (off when absent)
+  - eaveCut: how the rafter tails are cut at the eaves — plumb, square (to the slope) or plumb-level (a boxed eave with a level soffit); plumb when absent
   - fasciaHighEdge: shed only — a board on the high edge (off when it meets a wall; on when absent)
-  - fasciaHeight/fasciaDepth: the boards' size (a 1x8 when absent); with a height, a flat roof's boards reach its top
+  - fasciaHeight/fasciaDepth: the boards' size (a 1x as deep as the tails need when absent); with a height, a flat roof's boards reach its top
   - fasciaMaterial/fasciaMaterialPreset: the boards' and rakes' finish (the wall role's when absent)
+  - heelMaterial/heelMaterialPreset: the wall band under the eaves (the roof's, then the walls' below, when absent)
+  - gableLeftMaterial/gableRightMaterial (+Preset): one gable end's finish (the edge role's when absent)
   - gambrelLowerWidthRatio / gambrelLowerHeightRatio: kink position on gambrel roofs
   - mansardSteepWidthRatio / mansardSteepHeightRatio: waist position on mansard roofs
   - dutchHipWidthRatio / dutchHipHeightRatio: hip-to-gable split on dutch roofs
@@ -701,6 +721,32 @@ export function getEffectiveSegmentSurfaceMaterial(node, role, parentFallback) {
         return legacy;
     return parentFallback ?? { material: undefined, materialPreset: undefined };
 }
+export const ROOF_WALL_BANDS = ['heel', 'gable-left', 'gable-right'];
+const WALL_BAND_FIELDS = {
+    heel: ['heelMaterial', 'heelMaterialPreset'],
+    'gable-left': ['gableLeftMaterial', 'gableLeftMaterialPreset'],
+    'gable-right': ['gableRightMaterial', 'gableRightMaterialPreset'],
+};
+/** The node fields one wall band's finish is stored in. */
+export function roofWallBandFields(band) {
+    const [material, materialPreset] = WALL_BAND_FIELDS[band];
+    return { material, materialPreset };
+}
+/**
+ * A wall band's own finish on a segment (or, for the heel, a roof), or null when it has none and
+ * the band follows its fallback: the heel the roof's, then the walls' below; a gable the edge role.
+ */
+export function getRoofWallBandMaterial(node, band) {
+    const fields = roofWallBandFields(band);
+    const material = node[fields.material];
+    const materialPreset = node[fields.materialPreset];
+    if (material === undefined && typeof materialPreset !== 'string')
+        return null;
+    return {
+        material,
+        materialPreset: typeof materialPreset === 'string' ? materialPreset : undefined,
+    };
+}
 /** The fascia and rake boards' own finish, or null when they take the wall role's. */
 export function getSegmentFasciaMaterial(node) {
     if (node.fasciaMaterial === undefined && typeof node.fasciaMaterialPreset !== 'string')
@@ -727,5 +773,6 @@ export function hasSegmentMaterialOverride(node) {
         node.wallMaterial !== undefined ||
         typeof node.wallMaterialPreset === 'string' ||
         node.fasciaMaterial !== undefined ||
-        typeof node.fasciaMaterialPreset === 'string');
+        typeof node.fasciaMaterialPreset === 'string' ||
+        ROOF_WALL_BANDS.some((band) => getRoofWallBandMaterial(node, band) !== null));
 }

package/dist/schema/nodes/roof-types.d.ts

@@ -11,4 +11,15 @@ export declare const RoofType: z.ZodEnum<{
     shed: "shed";
 }>;
 export type RoofType = z.infer<typeof RoofType>;
+/**
+ * How a roof plane's rafter tails are cut at its eaves, and so the fascia over them: `plumb`
+ * (vertical, the fascia plumb), `square` (square to the slope, the fascia with it) or `plumb-level`
+ * (plumb, with a level cut under it for a soffit nailed up flat: a boxed eave).
+ */
+export declare const RoofEaveCut: z.ZodEnum<{
+    plumb: "plumb";
+    "plumb-level": "plumb-level";
+    square: "square";
+}>;
+export type RoofEaveCut = z.infer<typeof RoofEaveCut>;
 //# sourceMappingURL=roof-types.d.ts.map

package/dist/schema/nodes/roof-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"roof-types.d.ts","sourceRoot":"","sources":["../../../src/schema/nodes/roof-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,eAAO,MAAM,QAAQ;;;;;;;;;;EAUnB,CAAA;AAEF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAA"}
+{"version":3,"file":"roof-types.d.ts","sourceRoot":"","sources":["../../../src/schema/nodes/roof-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,eAAO,MAAM,QAAQ;;;;;;;;;;EAUnB,CAAA;AAEF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAA;AAE/C;;;;GAIG;AACH,eAAO,MAAM,WAAW;;;;EAA6C,CAAA;AAErE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAA"}

package/dist/schema/nodes/roof-types.js

@@ -12,3 +12,9 @@ export const RoofType = z.enum([
     'conical',
     'barrel',
 ]);
+/**
+ * How a roof plane's rafter tails are cut at its eaves, and so the fascia over them: `plumb`
+ * (vertical, the fascia plumb), `square` (square to the slope, the fascia with it) or `plumb-level`
+ * (plumb, with a level cut under it for a soffit nailed up flat: a boxed eave).
+ */
+export const RoofEaveCut = z.enum(['plumb', 'square', 'plumb-level']);