@pascal-app/core 1.0.4 → 1.0.5

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

@@ -1,7 +1,17 @@
 import { getWallFaceOffsets } from '../../systems/wall/wall-frame.js';
+import { getBarrelRoofProfile } from './barrel-roof.js';
 import { getDutchRoofMetrics, getSegmentSlopeFrame } from './roof-segment.js';
 function getWallVolumeFrame(node) {
     const { activeRh, tanTheta } = getSegmentSlopeFrame(node);
+    if (node.roofType === 'barrel')
+        return {
+            wV: node.width + (node.wallThickness ?? 0.1),
+            dV: node.depth + (node.wallThickness ?? 0.1),
+            eaveY: node.wallHeight,
+            peakY: node.wallHeight + activeRh,
+            tanTheta,
+            hasSlope: true,
+        };
     const wallThickness = node.wallThickness ?? 0.1;
     const autoDrop = getWallFaceOffsets({ thickness: wallThickness }).a * tanTheta;
     const wV = Math.max(0.01, node.width + wallThickness);
@@ -49,6 +59,20 @@ function buildFaceProfile(node, frame, id) {
     if (!hasSlope)
         return rectProfile(length, eaveY);
     switch (node.roofType) {
+        case 'barrel': {
+            if (!isEnd)
+                return rectProfile(length, node.wallHeight);
+            const profile = getBarrelRoofProfile(node.depth, getSegmentSlopeFrame(node).activeRh, node.barrelSegments ?? 12);
+            // The arch springs from the eaves' centre lines, inside the walls' outer faces; the placeable
+            // region stays convex by leaving out the walls' outer halves above their base corners.
+            return [
+                [0, 0],
+                [length, 0],
+                ...profile
+                    .reverse()
+                    .map(([z, y]) => [z + length / 2, y + node.wallHeight]),
+            ];
+        }
         case 'gable': {
             if (!isEnd)
                 return rectProfile(length, eaveY);

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

@@ -1,16 +1,7 @@
 import { z } from 'zod';
 import type { MaterialSchema as MaterialSchemaType } from '../material.js';
-export declare const RoofType: z.ZodEnum<{
-    flat: "flat";
-    hip: "hip";
-    gable: "gable";
-    shed: "shed";
-    gambrel: "gambrel";
-    dutch: "dutch";
-    mansard: "mansard";
-    conical: "conical";
-}>;
-export type RoofType = z.infer<typeof RoofType>;
+import { RoofType } from './roof-types.js';
+export { 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>;
@@ -65,8 +56,8 @@ export declare const RoofSegmentNode: z.ZodObject<{
         position: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
         target: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
         mode: z.ZodDefault<z.ZodEnum<{
-            perspective: "perspective";
             orthographic: "orthographic";
+            perspective: "perspective";
         }>>;
         fov: z.ZodOptional<z.ZodNumber>;
         zoom: z.ZodOptional<z.ZodNumber>;
@@ -77,23 +68,23 @@ export declare const RoofSegmentNode: z.ZodObject<{
             ns: z.ZodOptional<z.ZodString>;
             id: z.ZodString;
             role: z.ZodOptional<z.ZodEnum<{
-                primary: "primary";
-                piece: "piece";
                 absorbed: "absorbed";
                 alias: "alias";
                 derived: "derived";
+                piece: "piece";
+                primary: "primary";
             }>>;
         }, z.core.$strip>>;
         lineage: z.ZodOptional<z.ZodObject<{
             op: z.ZodEnum<{
+                attach: "attach";
+                convert: "convert";
+                duplicate: "duplicate";
                 import: "import";
-                split: "split";
+                "make-independent": "make-independent";
                 merge: "merge";
-                duplicate: "duplicate";
-                convert: "convert";
                 promote: "promote";
-                "make-independent": "make-independent";
-                attach: "attach";
+                split: "split";
             }>;
             fromIds: z.ZodArray<z.ZodString>;
         }, z.core.$strip>>;
@@ -103,16 +94,16 @@ export declare const RoofSegmentNode: z.ZodObject<{
     material: z.ZodOptional<z.ZodObject<{
         id: z.ZodOptional<z.ZodString>;
         preset: z.ZodOptional<z.ZodCatch<z.ZodEnum<{
-            custom: "custom";
-            white: "white";
             brick: "brick";
             concrete: "concrete";
-            wood: "wood";
+            custom: "custom";
             glass: "glass";
+            marble: "marble";
             metal: "metal";
             plaster: "plaster";
             tile: "tile";
-            marble: "marble";
+            white: "white";
+            wood: "wood";
         }>>>;
         properties: z.ZodOptional<z.ZodObject<{
             color: z.ZodDefault<z.ZodString>;
@@ -121,9 +112,9 @@ export declare const RoofSegmentNode: z.ZodObject<{
             opacity: z.ZodDefault<z.ZodNumber>;
             transparent: z.ZodDefault<z.ZodBoolean>;
             side: z.ZodDefault<z.ZodEnum<{
-                front: "front";
                 back: "back";
                 double: "double";
+                front: "front";
             }>>;
         }, z.core.$strip>>;
         texture: z.ZodOptional<z.ZodObject<{
@@ -136,16 +127,16 @@ export declare const RoofSegmentNode: z.ZodObject<{
     topMaterial: z.ZodOptional<z.ZodObject<{
         id: z.ZodOptional<z.ZodString>;
         preset: z.ZodOptional<z.ZodCatch<z.ZodEnum<{
-            custom: "custom";
-            white: "white";
             brick: "brick";
             concrete: "concrete";
-            wood: "wood";
+            custom: "custom";
             glass: "glass";
+            marble: "marble";
             metal: "metal";
             plaster: "plaster";
             tile: "tile";
-            marble: "marble";
+            white: "white";
+            wood: "wood";
         }>>>;
         properties: z.ZodOptional<z.ZodObject<{
             color: z.ZodDefault<z.ZodString>;
@@ -154,9 +145,9 @@ export declare const RoofSegmentNode: z.ZodObject<{
             opacity: z.ZodDefault<z.ZodNumber>;
             transparent: z.ZodDefault<z.ZodBoolean>;
             side: z.ZodDefault<z.ZodEnum<{
-                front: "front";
                 back: "back";
                 double: "double";
+                front: "front";
             }>>;
         }, z.core.$strip>>;
         texture: z.ZodOptional<z.ZodObject<{
@@ -169,16 +160,16 @@ export declare const RoofSegmentNode: z.ZodObject<{
     edgeMaterial: z.ZodOptional<z.ZodObject<{
         id: z.ZodOptional<z.ZodString>;
         preset: z.ZodOptional<z.ZodCatch<z.ZodEnum<{
-            custom: "custom";
-            white: "white";
             brick: "brick";
             concrete: "concrete";
-            wood: "wood";
+            custom: "custom";
             glass: "glass";
+            marble: "marble";
             metal: "metal";
             plaster: "plaster";
             tile: "tile";
-            marble: "marble";
+            white: "white";
+            wood: "wood";
         }>>>;
         properties: z.ZodOptional<z.ZodObject<{
             color: z.ZodDefault<z.ZodString>;
@@ -187,9 +178,9 @@ export declare const RoofSegmentNode: z.ZodObject<{
             opacity: z.ZodDefault<z.ZodNumber>;
             transparent: z.ZodDefault<z.ZodBoolean>;
             side: z.ZodDefault<z.ZodEnum<{
-                front: "front";
                 back: "back";
                 double: "double";
+                front: "front";
             }>>;
         }, z.core.$strip>>;
         texture: z.ZodOptional<z.ZodObject<{
@@ -202,16 +193,16 @@ export declare const RoofSegmentNode: z.ZodObject<{
     wallMaterial: z.ZodOptional<z.ZodObject<{
         id: z.ZodOptional<z.ZodString>;
         preset: z.ZodOptional<z.ZodCatch<z.ZodEnum<{
-            custom: "custom";
-            white: "white";
             brick: "brick";
             concrete: "concrete";
-            wood: "wood";
+            custom: "custom";
             glass: "glass";
+            marble: "marble";
             metal: "metal";
             plaster: "plaster";
             tile: "tile";
-            marble: "marble";
+            white: "white";
+            wood: "wood";
         }>>>;
         properties: z.ZodOptional<z.ZodObject<{
             color: z.ZodDefault<z.ZodString>;
@@ -220,9 +211,9 @@ export declare const RoofSegmentNode: z.ZodObject<{
             opacity: z.ZodDefault<z.ZodNumber>;
             transparent: z.ZodDefault<z.ZodBoolean>;
             side: z.ZodDefault<z.ZodEnum<{
-                front: "front";
                 back: "back";
                 double: "double";
+                front: "front";
             }>>;
         }, z.core.$strip>>;
         texture: z.ZodOptional<z.ZodObject<{
@@ -235,15 +226,76 @@ export declare const RoofSegmentNode: z.ZodObject<{
     position: z.ZodDefault<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
     rotation: z.ZodDefault<z.ZodNumber>;
     roofType: z.ZodDefault<z.ZodEnum<{
+        barrel: "barrel";
+        conical: "conical";
+        dutch: "dutch";
         flat: "flat";
-        hip: "hip";
         gable: "gable";
-        shed: "shed";
         gambrel: "gambrel";
-        dutch: "dutch";
+        hip: "hip";
         mansard: "mansard";
-        conical: "conical";
+        shed: "shed";
     }>>;
+    barrelRise: z.ZodOptional<z.ZodNumber>;
+    barrelSegments: z.ZodOptional<z.ZodNumber>;
+    roofSystem: z.ZodOptional<z.ZodEnum<{
+        glazed: "glazed";
+        standard: "standard";
+    }>>;
+    glazing: z.ZodOptional<z.ZodObject<{
+        across: z.ZodPrefault<z.ZodObject<{
+            layout: z.ZodDefault<z.ZodEnum<{
+                count: "count";
+                "fixed-spacing": "fixed-spacing";
+                "maximum-spacing": "maximum-spacing";
+            }>>;
+            count: z.ZodDefault<z.ZodNumber>;
+            spacing: z.ZodDefault<z.ZodNumber>;
+            alignment: z.ZodDefault<z.ZodEnum<{
+                center: "center";
+                end: "end";
+                start: "start";
+            }>>;
+        }, z.core.$strip>>;
+        along: z.ZodPrefault<z.ZodObject<{
+            layout: z.ZodDefault<z.ZodEnum<{
+                count: "count";
+                "fixed-spacing": "fixed-spacing";
+                "maximum-spacing": "maximum-spacing";
+            }>>;
+            count: z.ZodDefault<z.ZodNumber>;
+            spacing: z.ZodDefault<z.ZodNumber>;
+            alignment: z.ZodDefault<z.ZodEnum<{
+                center: "center";
+                end: "end";
+                start: "start";
+            }>>;
+        }, z.core.$strip>>;
+        frameWidth: z.ZodDefault<z.ZodNumber>;
+        frameDepth: z.ZodDefault<z.ZodNumber>;
+        glassThickness: z.ZodDefault<z.ZodNumber>;
+        frameColor: z.ZodDefault<z.ZodString>;
+        glassColor: z.ZodDefault<z.ZodString>;
+        glassOpacity: z.ZodDefault<z.ZodNumber>;
+        glassRoughness: z.ZodDefault<z.ZodNumber>;
+        glazedEnds: z.ZodDefault<z.ZodBoolean>;
+        panelType: z.ZodDefault<z.ZodEnum<{
+            empty: "empty";
+            glass: "glass";
+            solid: "solid";
+        }>>;
+        panels: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            face: z.ZodString;
+            column: z.ZodNumber;
+            row: z.ZodNumber;
+            type: z.ZodEnum<{
+                empty: "empty";
+                glass: "glass";
+                solid: "solid";
+            }>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    slots: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     width: z.ZodDefault<z.ZodNumber>;
     depth: z.ZodDefault<z.ZodNumber>;
     conicalStartAngle: z.ZodOptional<z.ZodNumber>;
@@ -272,6 +324,7 @@ export declare const RoofSegmentNode: z.ZodObject<{
     wallThickness: z.ZodDefault<z.ZodNumber>;
     deckThickness: z.ZodDefault<z.ZodNumber>;
     overhang: z.ZodDefault<z.ZodNumber>;
+    gableOverhang: z.ZodOptional<z.ZodNumber>;
     shingleThickness: z.ZodDefault<z.ZodNumber>;
     arc: z.ZodOptional<z.ZodObject<{
         centerX: z.ZodNumber;
@@ -296,12 +349,47 @@ export declare const RoofSegmentNode: z.ZodObject<{
     managedByParent: z.ZodDefault<z.ZodBoolean>;
     wallShell: z.ZodDefault<z.ZodEnum<{
         auto: "auto";
-        omit: "omit";
         include: "include";
+        omit: "omit";
     }>>;
     shedInsetEndPanels: z.ZodDefault<z.ZodBoolean>;
     fascia: z.ZodOptional<z.ZodBoolean>;
     fasciaHighEdge: z.ZodOptional<z.ZodBoolean>;
+    fasciaHeight: z.ZodOptional<z.ZodNumber>;
+    fasciaDepth: z.ZodOptional<z.ZodNumber>;
+    fasciaMaterial: 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>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    fasciaMaterialPreset: z.ZodOptional<z.ZodString>;
     gambrelLowerWidthRatio: z.ZodDefault<z.ZodNumber>;
     gambrelLowerHeightRatio: z.ZodDefault<z.ZodNumber>;
     mansardSteepWidthRatio: z.ZodDefault<z.ZodNumber>;
@@ -370,7 +458,7 @@ export type SegmentSlopeFrame = {
  * skylight surface-frame routine, and the segment-hit raycaster) and
  * silently drifted when a new roof type was added.
  */
-export declare function getSegmentSlopeFrame(node: Pick<RoofSegmentNode, 'roofType' | 'pitch' | 'width' | 'depth'> & Partial<ShapeRatios>): SegmentSlopeFrame;
+export declare function getSegmentSlopeFrame(node: Pick<RoofSegmentNode, 'roofType' | 'pitch' | 'width' | 'depth'> & Partial<ShapeRatios> & Pick<Partial<RoofSegmentNode>, 'barrelRise' | 'barrelSegments'>): SegmentSlopeFrame;
 /**
  * The eave-to-peak height of the assembled segment, derived from pitch +
  * footprint + roofType. Replaces the legacy `roofHeight` field on the node.
@@ -384,6 +472,24 @@ export type RoofSegmentVisibleTopBounds = {
     width: number;
     depth: number;
 };
+/** Whether a form's ends along the segment's width are rakes, not eaves: they take `gableOverhang`. */
+export declare function roofTypeHasRakes(roofType: RoofType): boolean;
+/**
+ * How far a segment's deck reaches past its wall centre lines in plan, along its own x (the ridge,
+ * where a gable, gambrel or shed has its rakes) and z (the eaves): half the wall's thickness, then
+ * the eaves' overhang, which the node stores along the slope, or at the rakes its `gableOverhang`.
+ */
+export declare function getRoofSegmentDeckReach(segment: Pick<RoofSegmentNode, 'roofType' | 'pitch' | 'width' | 'depth'> & Partial<Pick<RoofSegmentNode, 'wallThickness' | 'overhang' | 'gableOverhang'>>): {
+    x: number;
+    z: number;
+};
+/**
+ * How far a segment's ends along its width reach past its wall centre lines in plan, for the readers
+ * that measure its eaves by the stored `overhang` (gutters, lean-to attachments, the sheets): a
+ * gable's, gambrel's or shed's ends are rakes, at the deck's edge (`getRoofSegmentDeckReach`); the
+ * other forms' ends are eaves like their sides, at `overhang`.
+ */
+export declare function getRoofSegmentEndReach(segment: Pick<RoofSegmentNode, 'roofType' | 'pitch' | 'width' | 'depth'> & Partial<Pick<RoofSegmentNode, 'wallThickness' | 'overhang' | 'gableOverhang'>>): number;
 export declare function getRoofSegmentVisibleTopBounds(segment: RoofSegmentNode): RoofSegmentVisibleTopBounds;
 /** Segment-local surface height used by roof accessory placement and hit disambiguation. */
 export declare function getRoofSegmentSurfaceY(node: Pick<RoofSegmentNode, 'roofType' | 'width' | 'depth' | 'wallHeight'> & Parameters<typeof getSegmentSlopeFrame>[0], localX: number, localZ: number): number;
@@ -410,6 +516,8 @@ 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;
+/** The fascia and rake boards' own finish, or null when they take the wall role's. */
+export declare function getSegmentFasciaMaterial(node: RoofSegmentNode): RoofSegmentSurfaceMaterialSpec | null;
 /**
  * Returns true when the segment has any segment-level material override —
  * either the legacy catch-all or any of the three role-specific fields.
@@ -418,5 +526,4 @@ export declare function getEffectiveSegmentSurfaceMaterial(node: RoofSegmentNode
  * shell.
  */
 export declare function hasSegmentMaterialOverride(node: RoofSegmentNode): boolean;
-export {};
 //# sourceMappingURL=roof-segment.d.ts.map

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

@@ -2,16 +2,10 @@ import dedent from 'dedent';
 import { z } from 'zod';
 import { BaseNode, nodeType, objectId } from '../base.js';
 import { MaterialSchema } from '../material.js';
-export const RoofType = z.enum([
-    'hip',
-    'gable',
-    'shed',
-    'gambrel',
-    'dutch',
-    'mansard',
-    'flat',
-    'conical',
-]);
+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';
 export const MIN_ROOF_SEGMENT_TRIM_SPAN = 0.1;
 const DEFAULT_ROOF_SEGMENT_WIDTH = 8;
 const DEFAULT_ROOF_SEGMENT_DEPTH = 6;
@@ -102,6 +96,11 @@ export const RoofSegmentNode = BaseNode.extend({
     rotation: z.number().default(0),
     // Roof shape type
     roofType: RoofType.default('gable'),
+    barrelRise: z.number().finite().positive().optional(),
+    barrelSegments: z.number().int().min(4).max(32).optional(),
+    roofSystem: RoofSystemType.optional(),
+    glazing: RoofGlazing.optional(),
+    slots: z.record(z.string(), z.string()).optional(),
     // Footprint dimensions
     width: z.number().default(8),
     depth: z.number().default(6),
@@ -132,6 +131,9 @@ export const RoofSegmentNode = BaseNode.extend({
     wallThickness: z.number().default(0.1),
     deckThickness: z.number().default(0.1),
     overhang: z.number().default(0.3),
+    // How far the roof reaches past the gable-end walls' outside faces, in plan (a gable's or
+    // 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),
     arc: z
         .object({
@@ -168,6 +170,13 @@ export const RoofSegmentNode = BaseNode.extend({
     // 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.
+    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(),
     // 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.
@@ -225,7 +234,9 @@ export const RoofSegmentNode = BaseNode.extend({
   Roof segment node - an individual roof module within a roof group.
   Each segment generates a complete architectural volume (walls + roof).
   Multiple segments can be combined to form complex roof shapes.
-  - roofType: hip, gable, shed, gambrel, dutch, mansard, flat, conical
+  - roofType: hip, gable, shed, gambrel, dutch, mansard, flat, conical, barrel
+  - barrelRise: arch rise in metres, limited to half the depth/span
+  - barrelSegments: 4–32 flat arch bays, default 12
   - width/depth: footprint dimensions
   - conicalStartAngle / conicalSweepAngle: angular extent of a conical sector (radians)
   - conicalFullCircle: temporarily render the complete cone while preserving the sector angles
@@ -233,10 +244,13 @@ export const RoofSegmentNode = BaseNode.extend({
   - wallHeight: height of walls below the roof
   - pitch: roof slope in degrees (angle of the primary slope face)
   - wallThickness/deckThickness: structural thicknesses
-  - overhang: eave overhang distance
+  - 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)
   - 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
+  - fasciaMaterial/fasciaMaterialPreset: the boards' and rakes' finish (the wall 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
@@ -435,6 +449,13 @@ function getPrimarySlopeRiseFraction(input) {
  * silently drifted when a new roof type was added.
  */
 export function getSegmentSlopeFrame(node) {
+    if (node.roofType === 'barrel') {
+        const run = Math.max(0.005, node.depth / 2);
+        const rise = Math.min(run, node.barrelRise ?? run / 2);
+        const tanTheta = rise / run;
+        const cosTheta = 1 / Math.sqrt(1 + tanTheta * tanTheta);
+        return { run, rise, tanTheta, cosTheta, sinTheta: tanTheta * cosTheta, activeRh: rise };
+    }
     const ratios = withRatioDefaults(node);
     const run = getPrimarySlopeRun(ratios);
     // `!(pitch > 0)` (not `pitch <= 0`) so a missing/NaN pitch — e.g. a segment
@@ -459,17 +480,46 @@ export function getSegmentSlopeFrame(node) {
 export function getActiveRoofHeight(node) {
     return getSegmentSlopeFrame(node).activeRh;
 }
+/** Whether a form's ends along the segment's width are rakes, not eaves: they take `gableOverhang`. */
+export function roofTypeHasRakes(roofType) {
+    return roofType === 'gable' || roofType === 'gambrel' || roofType === 'shed';
+}
+/**
+ * How far a segment's deck reaches past its wall centre lines in plan, along its own x (the ridge,
+ * where a gable, gambrel or shed has its rakes) and z (the eaves): half the wall's thickness, then
+ * the eaves' overhang, which the node stores along the slope, or at the rakes its `gableOverhang`.
+ */
+export function getRoofSegmentDeckReach(segment) {
+    const half = finiteNonNegative(segment.wallThickness) / 2;
+    // A barrel's arch springs from its eaves, and its ends reach out by the overhang, unsloped.
+    if (segment.roofType === 'barrel')
+        return { x: half + finiteNonNegative(segment.overhang), z: 0 };
+    const z = half + finiteNonNegative(segment.overhang) * getSegmentSlopeFrame(segment).cosTheta;
+    const gable = segment.gableOverhang;
+    const raked = roofTypeHasRakes(segment.roofType) && Number.isFinite(gable);
+    return { x: raked ? half + finiteNonNegative(gable) : z, z };
+}
+/**
+ * How far a segment's ends along its width reach past its wall centre lines in plan, for the readers
+ * that measure its eaves by the stored `overhang` (gutters, lean-to attachments, the sheets): a
+ * gable's, gambrel's or shed's ends are rakes, at the deck's edge (`getRoofSegmentDeckReach`); the
+ * other forms' ends are eaves like their sides, at `overhang`.
+ */
+export function getRoofSegmentEndReach(segment) {
+    return roofTypeHasRakes(segment.roofType)
+        ? getRoofSegmentDeckReach(segment).x
+        : finiteNonNegative(segment.overhang);
+}
 export function getRoofSegmentVisibleTopBounds(segment) {
-    const { activeRh, cosTheta, sinTheta } = getSegmentSlopeFrame(segment);
+    const { activeRh, sinTheta } = getSegmentSlopeFrame(segment);
     const width = finitePositive(segment.width, DEFAULT_ROOF_SEGMENT_WIDTH);
     const depth = finitePositive(segment.depth, DEFAULT_ROOF_SEGMENT_DEPTH);
     const trim = normalizeRoofSegmentTrim({ ...segment, width, depth });
-    const horizontalOverhang = finiteNonNegative(segment.overhang) * cosTheta;
-    const deckExt = finiteNonNegative(segment.wallThickness) / 2 + horizontalOverhang;
-    const shingleOverhang = finiteNonNegative(segment.shingleThickness) * sinTheta;
-    let xExt = deckExt;
-    let frontExt = deckExt;
-    let backExt = deckExt;
+    const reach = getRoofSegmentDeckReach(segment);
+    const shingleOverhang = segment.roofSystem === 'glazed' ? 0 : finiteNonNegative(segment.shingleThickness) * sinTheta;
+    let xExt = reach.x;
+    let frontExt = reach.z;
+    let backExt = reach.z;
     if (segment.roofType === 'hip' ||
         segment.roofType === 'conical' ||
         segment.roofType === 'mansard' ||
@@ -526,6 +576,16 @@ export function getRoofSegmentVisibleTopBounds(segment) {
 export function getRoofSegmentSurfaceY(node, localX, localZ) {
     const slopeFrame = getSegmentSlopeFrame(node);
     const activeRh = slopeFrame.activeRh;
+    if (node.roofType === 'barrel') {
+        const profile = getBarrelRoofProfile(node.depth, activeRh, node.barrelSegments ?? 12);
+        const z = Math.max(-node.depth / 2, Math.min(node.depth / 2, localZ));
+        for (let i = 1; i < profile.length; i++) {
+            const a = profile[i - 1], b = profile[i];
+            if (z <= b[0] + 1e-8)
+                return node.wallHeight + a[1] + ((b[1] - a[1]) * (z - a[0])) / (b[0] - a[0]);
+        }
+        return node.wallHeight;
+    }
     const peakY = node.wallHeight + activeRh;
     if (activeRh === 0)
         return node.wallHeight;
@@ -641,6 +701,15 @@ export function getEffectiveSegmentSurfaceMaterial(node, role, parentFallback) {
         return legacy;
     return parentFallback ?? { material: undefined, 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')
+        return null;
+    return {
+        material: node.fasciaMaterial,
+        materialPreset: typeof node.fasciaMaterialPreset === 'string' ? node.fasciaMaterialPreset : undefined,
+    };
+}
 /**
  * Returns true when the segment has any segment-level material override —
  * either the legacy catch-all or any of the three role-specific fields.
@@ -656,5 +725,7 @@ export function hasSegmentMaterialOverride(node) {
         node.edgeMaterial !== undefined ||
         typeof node.edgeMaterialPreset === 'string' ||
         node.wallMaterial !== undefined ||
-        typeof node.wallMaterialPreset === 'string');
+        typeof node.wallMaterialPreset === 'string' ||
+        node.fasciaMaterial !== undefined ||
+        typeof node.fasciaMaterialPreset === 'string');
 }

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

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+export declare const RoofType: z.ZodEnum<{
+    barrel: "barrel";
+    conical: "conical";
+    dutch: "dutch";
+    flat: "flat";
+    gable: "gable";
+    gambrel: "gambrel";
+    hip: "hip";
+    mansard: "mansard";
+    shed: "shed";
+}>;
+export type RoofType = z.infer<typeof RoofType>;
+//# sourceMappingURL=roof-types.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+// Roof shapes, in a file with no other dependency: agent tool contracts validate against them
+// without loading the node schemas.
+export const RoofType = z.enum([
+    'hip',
+    'gable',
+    'shed',
+    'gambrel',
+    'dutch',
+    'mansard',
+    'flat',
+    'conical',
+    'barrel',
+]);