@pascal-app/core 1.0.0-beta.4 → 1.0.0

package/dist/schema/nodes/lean-to-extension.js

@@ -0,0 +1,114 @@
+import dedent from 'dedent';
+import { z } from 'zod';
+import { BaseNode, nodeType, objectId } from '../base';
+import { ColumnNode } from './column';
+import { RoofNode } from './roof';
+import { SlabNode } from './slab';
+export const LeanToConnectionMode = z.enum(['auto', 'manual']);
+export const LeanToCanopyForm = z.enum(['mono', 'gable', 'butterfly']);
+export const LeanToHostKind = z.enum(['wall', 'slab-edge', 'freestanding', 'conical-roof']);
+export const LeanToRoofEdge = z.enum(['+X', '-X', '+Z', '-Z']);
+export const LeanToResizeLock = z.enum([
+    'preserve-high-edge',
+    'preserve-low-edge',
+    'preserve-pitch',
+]);
+export const LeanToEndCondition = z.enum(['open', 'wall-abutment', 'joined']);
+export const LeanToFramingStrategy = z.enum(['hidden', 'rafters', 'purlins', 'covering-specific']);
+export const LeanToHighSideMode = z.enum(['wall-ledger', 'independent-high-beam']);
+export const LeanToPostLayoutMode = z.enum(['count', 'target-spacing']);
+export const LeanToFootingStyle = z.enum(['none', 'base-plate', 'concrete-pad']);
+export const LeanToCoveringType = z.enum(['generic', 'shingle', 'metal-panel']);
+const LeanToOmittedPostSlot = z.object({
+    side: z.enum(['low', 'high']),
+    index: z.number().int(),
+    layoutCount: z.number().int().min(1),
+});
+const DEFAULT_LOW_EDGE_HEIGHT = 2.7 - 3 * Math.tan((5 * Math.PI) / 180);
+const DEFAULT_LEAN_TO_POST_SPACING = 3;
+export const LeanToExtensionNode = BaseNode.extend({
+    id: objectId('leanto'),
+    type: nodeType('lean-to-extension'),
+    position: z.tuple([z.number(), z.number(), z.number()]).default([0, 0, 0]),
+    rotation: z.tuple([z.number(), z.number(), z.number()]).default([0, 0, 0]),
+    children: z.array(z.union([ColumnNode.shape.id, RoofNode.shape.id])).default([]),
+    canopyForm: LeanToCanopyForm.default('mono'),
+    hostKind: LeanToHostKind.default('wall'),
+    hostHeightOffset: z.number().min(-10).max(10).default(0),
+    hostSlabId: SlabNode.shape.id.optional(),
+    hostSlabEdgeIndex: z.number().int().min(0).optional(),
+    hostSlabEdgeT: z.number().min(0).max(1).optional(),
+    span: z.number().min(0.5).max(100).default(4),
+    autoSpan: z.boolean().default(true),
+    projection: z.number().min(0.5).max(10).default(2.5),
+    spanArcCenterZ: z
+        .number()
+        .optional()
+        .describe('Local-Z of the host wall arc center in the lean-to local frame (the crown sits on the local Z axis, so center X = 0). Derived from the host wall arc; absent for straight walls.'),
+    spanArcRadius: z
+        .number()
+        .optional()
+        .describe("The host wall's true arc radius, in metres. Derived from the host wall arc; absent for straight walls."),
+    highEdgeHeight: z.number().min(0.8).max(10).default(2.8),
+    lowEdgeHeight: z.number().min(0.2).max(10).default(DEFAULT_LOW_EDGE_HEIGHT),
+    pitch: z.number().min(1).max(45).default(10),
+    resizeLock: LeanToResizeLock.default('preserve-high-edge'),
+    leftEndCondition: LeanToEndCondition.default('open'),
+    rightEndCondition: LeanToEndCondition.default('open'),
+    autoMiterCorners: z.boolean().default(true),
+    sideFlashing: z.boolean().default(true),
+    flashingProjection: z.number().min(0.01).max(0.5).default(0.025),
+    flashingHeight: z.number().min(0.03).max(0.5).default(0.14),
+    slots: z.record(z.string(), z.string()).optional(),
+    highSideMode: LeanToHighSideMode.default('wall-ledger'),
+    ledgerVerticalOffset: z.number().min(-1).max(1).default(0),
+    lowBeamInset: z.number().min(0).max(2).default(0),
+    gutterEnabled: z.boolean().default(true),
+    gutterProfile: z.enum(['k-style', 'half-round', 'box']).default('k-style'),
+    gutterSize: z.number().min(0.04).max(0.3).default(0.13),
+    downspoutEnabled: z.boolean().default(true),
+    downspoutPosition: z.number().min(-1).max(1).default(1),
+    connectionMode: LeanToConnectionMode.default('auto'),
+    hostRoofId: RoofNode.shape.id.optional(),
+    hostRoofSegmentId: z.string().optional(),
+    hostRoofEdge: LeanToRoofEdge.optional(),
+    hostRoofEdgeRange: z.tuple([z.number().min(0).max(1), z.number().min(0).max(1)]).optional(),
+    connectionOffset: z.number().min(-1).max(1).default(0),
+    connectionInset: z.number().min(0).max(10).default(0),
+    matchHostRoofMaterial: z.boolean().default(true),
+    matchHostRoofStructure: z.boolean().default(true),
+    roofThickness: z.number().min(0.02).max(0.5).default(0.1),
+    shingleThickness: z.number().min(0).max(0.5).default(0.025),
+    highOverhang: z.number().min(0).max(1.5).default(0),
+    lowOverhang: z.number().min(0).max(1.5).default(0.25),
+    leftOverhang: z.number().min(0).max(1.5).default(0.15),
+    rightOverhang: z.number().min(0).max(1.5).default(0.15),
+    coveringType: LeanToCoveringType.default('generic'),
+    beamWidth: z.number().min(0.05).max(0.6).default(0.16),
+    beamHeight: z.number().min(0.05).max(0.8).default(0.24),
+    ledgerDepth: z.number().min(0.03).max(0.5).default(0.1),
+    ledgerHeight: z.number().min(0.05).max(0.8).default(0.18),
+    rafterWidth: z.number().min(0.03).max(0.4).default(0.08),
+    rafterHeight: z.number().min(0.03).max(0.5).default(0.14),
+    rafterSpacing: z.number().min(0.2).max(3).default(1.2),
+    rafterEndInset: z.number().min(0).max(3).default(0),
+    framingStrategy: LeanToFramingStrategy.default('rafters'),
+    purlinWidth: z.number().min(0.03).max(0.4).default(0.08),
+    purlinHeight: z.number().min(0.03).max(0.5).default(0.1),
+    purlinSpacing: z.number().min(0.2).max(3).default(0.8),
+    postWidth: z.number().min(0.05).max(0.6).default(0.16),
+    postDepth: z.number().min(0.05).max(0.6).default(0.16),
+    postCount: z.number().int().min(2).max(20).default(3),
+    postLayoutMode: LeanToPostLayoutMode.default('target-spacing'),
+    postSpacing: z.number().min(0.3).max(10).default(DEFAULT_LEAN_TO_POST_SPACING),
+    postInset: z.number().min(0).max(3).default(0),
+    omittedPostSlots: z.array(LeanToOmittedPostSlot).default([]),
+    postBracing: z.enum(['none', 'knee']).default('none'),
+    footingStyle: LeanToFootingStyle.default('none'),
+}).describe(dedent `
+  Open parametric canopy.
+  The high edge can attach to a wall, attach to an upper slab edge, stand on an independent
+  high beam, or wrap around a conical roof's cylindrical base. Attached canopies use a mono-pitch
+  roof. Freestanding canopies can use a mono-pitch, gable, or butterfly roof with managed columns,
+  framing, gutters, and downspouts.
+  `);

package/dist/schema/nodes/level.d.ts

@@ -1,4 +1,6 @@
 import { z } from 'zod';
+export declare const DEFAULT_LEVEL_BASE_ELEVATION = 0;
+export declare function normalizeLevelBaseElevation(value: unknown): number;
 export declare const LevelNode: z.ZodObject<{
     object: z.ZodDefault<z.ZodLiteral<"node">>;
     name: z.ZodOptional<z.ZodString>;
@@ -14,11 +16,12 @@ export declare const LevelNode: z.ZodObject<{
         fov: z.ZodOptional<z.ZodNumber>;
         zoom: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
-    metadata: z.ZodDefault<z.ZodOptional<z.ZodJSONSchema>>;
+    metadata: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     id: z.ZodDefault<z.ZodTemplateLiteral<`level_${string}`>>;
     type: z.ZodDefault<z.ZodLiteral<"level">>;
-    children: z.ZodDefault<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`item_${string}` | `ceiling_${string}` | `column_${string}` | `wall_${string}` | `fence_${string}` | `construction-dimension_${string}` | `structural-grid_${string}` | `zone_${string}` | `slab_${string}` | `roof_${string}` | `stair_${string}` | `scan_${string}` | `guide_${string}` | `measurement_${string}` | `spawn_${string}` | `shelf_${string}` | `duct-segment_${string}` | `duct-fitting_${string}` | `duct-terminal_${string}` | `hvac-equipment_${string}` | `lineset_${string}` | `liquid-line_${string}` | `pipe-segment_${string}` | `pipe-fitting_${string}` | `pipe-trap_${string}`, string>>>>;
+    children: z.ZodDefault<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<`item_${string}` | `block_${string}` | `ceiling_${string}` | `column_${string}` | `wall_${string}` | `roof_${string}` | `slab_${string}` | `fence_${string}` | `construction-dimension_${string}` | `structural-grid_${string}` | `zone_${string}` | `stair_${string}` | `scan_${string}` | `guide_${string}` | `measurement_${string}` | `spawn_${string}` | `shelf_${string}` | `duct-segment_${string}` | `duct-fitting_${string}` | `duct-terminal_${string}` | `hvac-equipment_${string}` | `lineset_${string}` | `liquid-line_${string}` | `pipe-segment_${string}` | `pipe-fitting_${string}` | `pipe-trap_${string}`, string>>>>;
     level: z.ZodDefault<z.ZodNumber>;
+    baseElevation: z.ZodDefault<z.ZodNumber>;
     height: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type LevelNode = z.infer<typeof LevelNode>;

package/dist/schema/nodes/level.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"level.d.ts","sourceRoot":"","sources":["../../../src/schema/nodes/level.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAyDvB,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;iBAqBrB,CAAA;AAED,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAA"}
+{"version":3,"file":"level.d.ts","sourceRoot":"","sources":["../../../src/schema/nodes/level.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AA2DvB,eAAO,MAAM,4BAA4B,IAAI,CAAA;AAE7C,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAElE;AAED,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;iBA0BrB,CAAA;AAED,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAA"}

package/dist/schema/nodes/level.js

@@ -2,6 +2,10 @@ import dedent from 'dedent';
 import { z } from 'zod';
 import { BaseNode, nodeType, objectId } from '../base';
 const LevelChildId = z.string().transform((id) => id);
+export const DEFAULT_LEVEL_BASE_ELEVATION = 0;
+export function normalizeLevelBaseElevation(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : DEFAULT_LEVEL_BASE_ELEVATION;
+}
 export const LevelNode = BaseNode.extend({
     id: objectId('level'),
     type: nodeType('level'),
@@ -10,6 +14,10 @@ export const LevelNode = BaseNode.extend({
     children: z.array(LevelChildId).default([]),
     // Specific props
     level: z.number().default(0),
+    baseElevation: z
+        .number()
+        .default(DEFAULT_LEVEL_BASE_ELEVATION)
+        .describe("Additive Y offset in meters applied above this level's computed stack position."),
     /**
      * Stored storey height in meters (floor-to-floor). No zod default on
      * purpose: absence marks unmigrated legacy data and gates the load-time
@@ -20,5 +28,6 @@ export const LevelNode = BaseNode.extend({
   Level node - used to represent a level in the building
   - children: array of architectural, equipment, and MEP distribution nodes
   - level: level number
+  - baseElevation: additive Y offset in meters above the computed stack position
   - height: storey height in meters (floor-to-floor); absent only on unmigrated legacy data
   `);

package/dist/schema/nodes/lineset.d.ts

@@ -29,7 +29,7 @@ export declare const LinesetNode: z.ZodObject<{
         fov: z.ZodOptional<z.ZodNumber>;
         zoom: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
-    metadata: z.ZodDefault<z.ZodOptional<z.ZodJSONSchema>>;
+    metadata: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     id: z.ZodDefault<z.ZodTemplateLiteral<`lineset_${string}`>>;
     type: z.ZodDefault<z.ZodLiteral<"lineset">>;
     path: z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;

package/dist/schema/nodes/liquid-line.d.ts

@@ -23,7 +23,7 @@ export declare const LiquidLineNode: z.ZodObject<{
         fov: z.ZodOptional<z.ZodNumber>;
         zoom: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
-    metadata: z.ZodDefault<z.ZodOptional<z.ZodJSONSchema>>;
+    metadata: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     id: z.ZodDefault<z.ZodTemplateLiteral<`liquid-line_${string}`>>;
     type: z.ZodDefault<z.ZodLiteral<"liquid-line">>;
     path: z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;

package/dist/schema/nodes/measurement.d.ts

@@ -206,7 +206,7 @@ export declare const MeasurementNode: z.ZodObject<{
         fov: z.ZodOptional<z.ZodNumber>;
         zoom: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
-    metadata: z.ZodDefault<z.ZodOptional<z.ZodJSONSchema>>;
+    metadata: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     id: z.ZodDefault<z.ZodTemplateLiteral<`measurement_${string}`>>;
     type: z.ZodDefault<z.ZodLiteral<"measurement">>;
     measurement: z.ZodDiscriminatedUnion<[z.ZodObject<{

package/dist/schema/nodes/pipe-fitting.d.ts

@@ -27,7 +27,7 @@ export declare const PipeFittingNode: z.ZodObject<{
         fov: z.ZodOptional<z.ZodNumber>;
         zoom: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
-    metadata: z.ZodDefault<z.ZodOptional<z.ZodJSONSchema>>;
+    metadata: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     id: z.ZodDefault<z.ZodTemplateLiteral<`pipe-fitting_${string}`>>;
     type: z.ZodDefault<z.ZodLiteral<"pipe-fitting">>;
     position: z.ZodDefault<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
@@ -35,12 +35,20 @@ export declare const PipeFittingNode: z.ZodObject<{
     fittingType: z.ZodDefault<z.ZodEnum<{
         elbow: "elbow";
         cross: "cross";
+        reducer: "reducer";
+        "end-cap": "end-cap";
+        coupling: "coupling";
         wye: "wye";
         "sanitary-tee": "sanitary-tee";
+        cleanout: "cleanout";
     }>>;
     angle: z.ZodDefault<z.ZodNumber>;
     diameter: z.ZodDefault<z.ZodNumber>;
     diameter2: z.ZodDefault<z.ZodNumber>;
+    cleanoutStyle: z.ZodDefault<z.ZodEnum<{
+        end: "end";
+        inline: "inline";
+    }>>;
     pipeMaterial: z.ZodDefault<z.ZodEnum<{
         pvc: "pvc";
         abs: "abs";

package/dist/schema/nodes/pipe-fitting.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipe-fitting.d.ts","sourceRoot":"","sources":["../../../src/schema/nodes/pipe-fitting.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8B3B,CAAA;AACD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAC7D,MAAM,MAAM,iBAAiB,GAAG,eAAe,CAAC,IAAI,CAAC,CAAA"}
+{"version":3,"file":"pipe-fitting.d.ts","sourceRoot":"","sources":["../../../src/schema/nodes/pipe-fitting.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkC3B,CAAA;AACD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAC7D,MAAM,MAAM,iBAAiB,GAAG,eAAe,CAAC,IAAI,CAAC,CAAA"}

package/dist/schema/nodes/pipe-fitting.js

@@ -21,7 +21,9 @@ export const PipeFittingNode = BaseNode.extend({
     position: z.tuple([z.number(), z.number(), z.number()]).default([0, 0, 0]),
     // XYZ euler radians.
     rotation: z.tuple([z.number(), z.number(), z.number()]).default([0, 0, 0]),
-    fittingType: z.enum(['elbow', 'wye', 'sanitary-tee', 'cross']).default('elbow'),
+    fittingType: z
+        .enum(['elbow', 'wye', 'sanitary-tee', 'cross', 'end-cap', 'cleanout', 'reducer', 'coupling'])
+        .default('elbow'),
     // Elbow turn in degrees — DWV bends ship as 22.5 / 45 / 90 ("long
     // sweep" for drains); adjustable range matches the duct elbow. 0° is a
     // straight coupling — what an elbow flattens to when its run is dragged
@@ -31,13 +33,15 @@ export const PipeFittingNode = BaseNode.extend({
     diameter: z.number().min(1.25).max(8).default(2),
     // Branch collar size (wye / sanitary-tee).
     diameter2: z.number().min(1.25).max(8).default(2),
+    cleanoutStyle: z.enum(['end', 'inline']).default('end'),
     pipeMaterial: z.enum(['pvc', 'abs', 'cast-iron']).default('pvc'),
     system: z.enum(['waste', 'vent']).default('waste'),
 }).describe(dedent `
   DWV pipe fitting - elbow (bend), wye (45° branch), sanitary tee (square branch), or cross (two opposed branches).
   - position: [x, y, z] level-local meters
   - rotation: [x, y, z] euler radians
-  - fittingType: elbow | wye | sanitary-tee | cross
+  - fittingType: elbow | wye | sanitary-tee | cross | end-cap | cleanout | reducer | coupling
+  - cleanoutStyle: end (one flow port) or inline (two flow ports with a capped service branch)
   - angle: elbow turn in degrees (22.5 / 45 / 90 typical)
   - diameter: run size in inches; diameter2: branch collar size (both branches for a cross)
   - pipeMaterial: pvc | abs | cast-iron

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

@@ -28,10 +28,32 @@ export declare const PipeSegmentNode: z.ZodObject<{
         fov: z.ZodOptional<z.ZodNumber>;
         zoom: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
-    metadata: z.ZodDefault<z.ZodOptional<z.ZodJSONSchema>>;
+    metadata: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     id: z.ZodDefault<z.ZodTemplateLiteral<`pipe-segment_${string}`>>;
     type: z.ZodDefault<z.ZodLiteral<"pipe-segment">>;
     path: z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    autoHangers: z.ZodOptional<z.ZodBoolean>;
+    hangerOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        fraction: z.ZodOptional<z.ZodNumber>;
+        skipped: z.ZodOptional<z.ZodBoolean>;
+        hostId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    hangerStyle: z.ZodOptional<z.ZodEnum<{
+        double: "double";
+        single: "single";
+    }>>;
+    hangerSpacing: z.ZodOptional<z.ZodNumber>;
+    hangerMaxReach: z.ZodOptional<z.ZodNumber>;
+    wallAttachment: z.ZodOptional<z.ZodObject<{
+        wallId: z.ZodDefault<z.ZodTemplateLiteral<`wall_${string}`>>;
+        side: z.ZodEnum<{
+            front: "front";
+            back: "back";
+        }>;
+        startUV: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        endUV: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        offset: z.ZodNumber;
+    }, z.core.$strip>>;
     diameter: z.ZodDefault<z.ZodNumber>;
     pipeMaterial: z.ZodDefault<z.ZodEnum<{
         pvc: "pvc";

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

@@ -1 +1 @@
-{"version":3,"file":"pipe-segment.d.ts","sourceRoot":"","sources":["../../../src/schema/nodes/pipe-segment.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoB3B,CAAA;AACD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAC7D,MAAM,MAAM,iBAAiB,GAAG,eAAe,CAAC,IAAI,CAAC,CAAA"}
+{"version":3,"file":"pipe-segment.d.ts","sourceRoot":"","sources":["../../../src/schema/nodes/pipe-segment.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuC3B,CAAA;AACD,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAC7D,MAAM,MAAM,iBAAiB,GAAG,eAAe,CAAC,IAAI,CAAC,CAAA"}

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

@@ -1,6 +1,7 @@
 import dedent from 'dedent';
 import { z } from 'zod';
 import { BaseNode, nodeType, objectId } from '../base';
+import { HangerOverrides } from './hanger-overrides';
 /**
  * DWV pipe segment — drain / waste / vent runs in US residential
  * plumbing. Phase 2 of the distribution-system effort: the plumbing
@@ -20,6 +21,22 @@ export const PipeSegmentNode = BaseNode.extend({
     type: nodeType('pipe-segment'),
     // Polyline path in level-local meters. Minimum two points.
     path: z.array(z.tuple([z.number(), z.number(), z.number()])).min(2),
+    autoHangers: z.boolean().optional(),
+    hangerOverrides: HangerOverrides.optional(),
+    hangerStyle: z.enum(['single', 'double']).optional(),
+    hangerSpacing: z.number().finite().positive().optional(),
+    hangerMaxReach: z.number().finite().positive().optional(),
+    // Logical wall host for runs drafted on a wall. The path remains
+    // level-local; UV coordinates let wall edits reproject the run later.
+    wallAttachment: z
+        .object({
+        wallId: objectId('wall'),
+        side: z.enum(['front', 'back']),
+        startUV: z.tuple([z.number(), z.number()]),
+        endUV: z.tuple([z.number(), z.number()]),
+        offset: z.number().finite().nonnegative(),
+    })
+        .optional(),
     // Nominal pipe size in inches. Residential DWV: 1¼ (lav tailpiece) to
     // 4 (building drain); 6 covers oversized mains.
     diameter: z.number().min(1.25).max(8).default(2),
@@ -29,6 +46,9 @@ export const PipeSegmentNode = BaseNode.extend({
     system: z.enum(['waste', 'vent']).default('waste'),
 }).describe(dedent `
   DWV pipe segment - drain / waste / vent run as a polyline of 3D points.
+  - autoHangers: automatically attach supports to nearby walls or ceilings (off when absent)
+  - hangerSpacing: distance between supports in meters (default 1.5)
+  - hangerMaxReach: maximum centerline-to-host distance in meters (default 2)
   - path: list of [x, y, z] points in level-local meters (min 2; y may go below the floor)
   - diameter: nominal size in inches (1.5 / 2 / 3 / 4 typical residential)
   - pipeMaterial: pvc | abs | cast-iron

package/dist/schema/nodes/pipe-trap.d.ts

@@ -25,7 +25,7 @@ export declare const PipeTrapNode: z.ZodObject<{
         fov: z.ZodOptional<z.ZodNumber>;
         zoom: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
-    metadata: z.ZodDefault<z.ZodOptional<z.ZodJSONSchema>>;
+    metadata: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     id: z.ZodDefault<z.ZodTemplateLiteral<`pipe-trap_${string}`>>;
     type: z.ZodDefault<z.ZodLiteral<"pipe-trap">>;
     position: z.ZodDefault<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;

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

@@ -20,7 +20,7 @@ export declare const RidgeVentNode: z.ZodObject<{
         fov: z.ZodOptional<z.ZodNumber>;
         zoom: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
-    metadata: z.ZodDefault<z.ZodOptional<z.ZodJSONSchema>>;
+    metadata: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     id: z.ZodDefault<z.ZodTemplateLiteral<`rvent_${string}`>>;
     type: z.ZodDefault<z.ZodLiteral<"ridge-vent">>;
     material: z.ZodOptional<z.ZodObject<{

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,CAkJrF;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,CAwJrF;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/ridge-vent.js

@@ -56,8 +56,11 @@ export function getRidgeVentLinesForSegment(segment) {
         trim: UNTRIMMED_RIDGE_VENT_BOUNDS_TRIM,
     });
     const { width, depth, minX, maxX, minZ, maxZ } = bounds;
-    if (segment.roofType === 'flat' || segment.roofType === 'shed')
+    if (segment.roofType === 'flat' ||
+        segment.roofType === 'shed' ||
+        segment.roofType === 'conical') {
         return [];
+    }
     const halfW = width / 2;
     const halfD = depth / 2;
     const ridgeZVisible = minZ <= 0 && maxZ >= 0;

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

@@ -4,6 +4,8 @@ export type RoofShapeFaceVertex = {
     y: number;
     z: number;
 };
+export type RoofShapeEaveSide = '+X' | '-X' | '+Z' | '-Z';
+export declare function getRoofShapeEaveSides(type: RoofType): RoofShapeEaveSide[];
 export type RoofShapeInsets = {
     iF?: number;
     iB?: number;
@@ -86,5 +88,7 @@ export declare function getRoofModuleFaces(input: {
     shapeRatios: RoofShapeRatios;
     excludeDutchEndSlopes?: boolean;
     dutchTopRakeThickness?: number;
+    conicalStartAngle?: number;
+    conicalSweepAngle?: number;
 }): RoofShapeFaceVertex[][];
 //# sourceMappingURL=roof-segment-shape.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"roof-segment-shape.d.ts","sourceRoot":"","sources":["../../../src/schema/nodes/roof-segment-shape.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEnE,MAAM,MAAM,mBAAmB,GAAG;IAChC,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,sBAAsB,EAAE,MAAM,CAAA;IAC9B,sBAAsB,EAAE,MAAM,CAAA;IAC9B,kBAAkB,EAAE,MAAM,CAAA;IAC1B,mBAAmB,EAAE,MAAM,CAAA;IAC3B,qBAAqB,EAAE,MAAM,CAAA;IAC7B,eAAe,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB,GAAG,eAAe,CAWlB;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAA;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,eAAe,EAAE,MAAM,CAAA;IACvB,eAAe,EAAE,MAAM,CAAA;IACvB,eAAe,EAAE,MAAM,CAAA;IACvB,eAAe,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,EAAE,EAAE,MAAM,CAAA;IACV,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,eAAe,CAAA;CAC7B,GAAG,qBAAqB,GAAG,IAAI,CAyD/B;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,QAAQ,EAAE,QAAQ,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,OAAO,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,gBAAgB,EAAE,MAAM,CAAA;IACxB,kBAAkB,EAAE,MAAM,CAAA;CAC3B,GAAG,eAAe,CAwBlB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,EAAE,EAAE,MAAM,CAAA;IACV,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,eAAe,CAAA;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,eAAe,CAAA;IAC5B,qBAAqB,CAAC,EAAE,MAAM,CAAA;CAC/B,GAAG,mBAAmB,EAAE,EAAE,CAsF1B;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,IAAI,EAAE,QAAQ,CAAA;IACd,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,EAAE,EAAE,MAAM,CAAA;IACV,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,eAAe,CAAA;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,eAAe,CAAA;IAC5B,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAC/B,qBAAqB,CAAC,EAAE,MAAM,CAAA;CAC/B,GAAG,mBAAmB,EAAE,EAAE,CAqK1B"}
+{"version":3,"file":"roof-segment-shape.d.ts","sourceRoot":"","sources":["../../../src/schema/nodes/roof-segment-shape.ts"],"names":[],"mappings":"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"}

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

@@ -1,4 +1,17 @@
 import { ROOF_SHAPE_DEFAULTS } from './roof-segment';
+export function getRoofShapeEaveSides(type) {
+    switch (type) {
+        case 'conical':
+            return [];
+        case 'shed':
+            return ['+Z'];
+        case 'gable':
+        case 'gambrel':
+            return ['+Z', '-Z'];
+        default:
+            return ['+Z', '-Z', '+X', '-X'];
+    }
+}
 export function getRoofShapeRatios(input) {
     return {
         gambrelLowerWidthRatio: input.gambrelLowerWidthRatio ?? ROOF_SHAPE_DEFAULTS.gambrelLowerWidthRatio,
@@ -61,7 +74,10 @@ export function getRoofShapeInsets(input) {
     let iB = 0;
     let iL = 0;
     let iR = 0;
-    if (input.roofType === 'hip' || input.roofType === 'mansard' || input.roofType === 'dutch') {
+    if (input.roofType === 'hip' ||
+        input.roofType === 'mansard' ||
+        input.roofType === 'dutch' ||
+        input.roofType === 'conical') {
         iF = inset;
         iB = inset;
         iL = inset;
@@ -158,6 +174,53 @@ export function getDutchEndSlopeFaces(input) {
 export function getRoofModuleFaces(input) {
     const v = (x, y, z) => ({ x, y, z });
     const { iF = 0, iB = 0, iL = 0, iR = 0 } = input.insets;
+    if (input.type === 'conical') {
+        const startAngle = Number.isFinite(input.conicalStartAngle) ? input.conicalStartAngle : 0;
+        const requestedSweep = Number.isFinite(input.conicalSweepAngle)
+            ? input.conicalSweepAngle
+            : -Math.PI * 2;
+        const sweepAngle = Math.max(-Math.PI * 2, Math.min(Math.PI * 2, Math.abs(requestedSweep) < 1e-4 ? 1e-4 : requestedSweep));
+        const isFullCone = Math.abs(sweepAngle) >= Math.PI * 2 - 1e-4;
+        const radialSegments = isFullCone
+            ? 48
+            : Math.max(1, Math.ceil((48 * Math.abs(sweepAngle)) / (Math.PI * 2)));
+        const eaveRadius = Math.max(0.005, input.w / 2);
+        const radialInset = (iF + iB + iL + iR) / 4;
+        const baseRadius = Math.max(0.005, eaveRadius - radialInset);
+        const eaveY = input.wh;
+        const peak = v(0, input.wh + Math.max(0.001, input.rh), 0);
+        const ringPointCount = isFullCone ? radialSegments : radialSegments + 1;
+        const bottomRing = Array.from({ length: ringPointCount }, (_, index) => {
+            const angle = startAngle + (index / radialSegments) * sweepAngle;
+            return v(Math.cos(angle) * baseRadius, input.baseY, Math.sin(angle) * baseRadius);
+        });
+        const eaveRing = Array.from({ length: ringPointCount }, (_, index) => {
+            const angle = startAngle + (index / radialSegments) * sweepAngle;
+            return v(Math.cos(angle) * eaveRadius, eaveY, Math.sin(angle) * eaveRadius);
+        });
+        const bottomCenter = v(0, input.baseY, 0);
+        const eaveCenter = v(0, eaveY, 0);
+        const faces = [
+            isFullCone ? [...bottomRing].reverse() : [bottomCenter, ...[...bottomRing].reverse()],
+        ];
+        for (let index = 0; index < radialSegments; index += 1) {
+            const next = isFullCone ? (index + 1) % radialSegments : index + 1;
+            faces.push([bottomRing[index], bottomRing[next], eaveRing[next], eaveRing[index]]);
+        }
+        if (input.rh === 0) {
+            faces.push(isFullCone ? [...eaveRing].reverse() : [eaveCenter, ...[...eaveRing].reverse()]);
+        }
+        else {
+            for (let index = 0; index < radialSegments; index += 1) {
+                const next = isFullCone ? (index + 1) % radialSegments : index + 1;
+                faces.push([eaveRing[index], eaveRing[next], peak]);
+            }
+        }
+        if (!isFullCone) {
+            faces.push([bottomCenter, bottomRing[0], eaveRing[0], peak], [bottomCenter, peak, eaveRing.at(-1), bottomRing.at(-1)]);
+        }
+        return sweepAngle > 0 ? faces.map((face) => [...face].reverse()) : faces;
+    }
     const b1 = v(-input.w / 2 + iL, input.baseY, input.d / 2 - iF);
     const b2 = v(input.w / 2 - iR, input.baseY, input.d / 2 - iF);
     const b3 = v(input.w / 2 - iR, input.baseY, -input.d / 2 + iB);

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

@@ -14,7 +14,9 @@ import type { RoofSegmentNode } from './roof-segment';
  * (`getVol(wallThickness / 2, 0, 0, …)`): the volume is the segment
  * footprint extended outward by `wallThickness / 2`, which drops the eave
  * line by `(wallThickness / 2) · tanθ` and raises the ridge by the same
- * amount so the apex stays at `wallHeight + activeRh`.
+ * amount so the apex stays at `wallHeight + activeRh` unless the eave
+ * hits the CSG minimum. The base stays at 0; the eave is raised to at
+ * least 0.05 above it to avoid sinking the shell into the supporting wall.
  */
 export type RoofWallFaceId = 'front' | 'back' | 'right' | 'left';
 export type RoofSegmentWallFace = {

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

@@ -1 +1 @@
-{"version":3,"file":"roof-segment-walls.d.ts","sourceRoot":"","sources":["../../../src/schema/nodes/roof-segment-walls.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAGrD;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAA;AAEhE,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,cAAc,CAAA;IAClB,6CAA6C;IAC7C,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAA;IACX,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAA;CAC5B,CAAA;AAED,KAAK,iBAAiB,GAAG,IAAI,CAC3B,eAAe,EACf,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,YAAY,GAAG,eAAe,GAAG,OAAO,CAC1E,GACC,OAAO,CACL,IAAI,CACF,eAAe,EACb,wBAAwB,GACxB,yBAAyB,GACzB,wBAAwB,GACxB,yBAAyB,GACzB,oBAAoB,GACpB,qBAAqB,GACrB,uBAAuB,CAC1B,CACF,CAAA;AAqJH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,iBAAiB,EACvB,EAAE,EAAE,cAAc,GACjB,mBAAmB,CAUrB;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,iBAAiB,GAAG,mBAAmB,EAAE,CAStF;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,iBAAiB,EACvB,EAAE,EAAE,cAAc,EAClB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAC9B;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAaxC;AA+CD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,iBAAiB,EACvB,EAAE,EAAE,cAAc,GACjB;IAAE,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAYnD;AAED,yEAAyE;AACzE,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,iBAAiB,EACvB,EAAE,EAAE,cAAc,EAClB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAC9B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAO1B;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,mBAAmB,EACzB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,MAAM,CAWR;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,mBAAmB,EACzB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,MAAM,CASR;AAID;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,mBAAmB,EACzB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GACzB;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAwCjC"}
+{"version":3,"file":"roof-segment-walls.d.ts","sourceRoot":"","sources":["../../../src/schema/nodes/roof-segment-walls.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAGrD;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAA;AAEhE,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,cAAc,CAAA;IAClB,6CAA6C;IAC7C,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAA;IACX,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd;;;OAGG;IACH,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAA;CAC5B,CAAA;AAED,KAAK,iBAAiB,GAAG,IAAI,CAC3B,eAAe,EACf,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,YAAY,GAAG,eAAe,GAAG,OAAO,CAC1E,GACC,OAAO,CACL,IAAI,CACF,eAAe,EACb,wBAAwB,GACxB,yBAAyB,GACzB,wBAAwB,GACxB,yBAAyB,GACzB,oBAAoB,GACpB,qBAAqB,GACrB,uBAAuB,CAC1B,CACF,CAAA;AAqJH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,iBAAiB,EACvB,EAAE,EAAE,cAAc,GACjB,mBAAmB,CAUrB;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,iBAAiB,GAAG,mBAAmB,EAAE,CAStF;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,iBAAiB,EACvB,EAAE,EAAE,cAAc,EAClB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAC9B;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAaxC;AA+CD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,iBAAiB,EACvB,EAAE,EAAE,cAAc,GACjB;IAAE,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAYnD;AAED,yEAAyE;AACzE,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,iBAAiB,EACvB,EAAE,EAAE,cAAc,EAClB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAC9B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAO1B;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,mBAAmB,EACzB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,MAAM,CAWR;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,mBAAmB,EACzB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,MAAM,CASR;AAID;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,mBAAmB,EACzB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GACzB;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAwCjC"}

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

@@ -5,7 +5,7 @@ function getWallVolumeFrame(node) {
     const autoDrop = (wallThickness / 2) * tanTheta;
     const wV = Math.max(0.01, node.width + wallThickness);
     const dV = Math.max(0.01, node.depth + wallThickness);
-    const eaveY = Math.max(0.01, node.wallHeight - autoDrop);
+    const eaveY = Math.max(0.05, node.wallHeight - autoDrop);
     let rh = activeRh;
     if (activeRh > 0) {
         rh = activeRh + autoDrop;

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

@@ -8,6 +8,7 @@ export declare const RoofType: z.ZodEnum<{
     gambrel: "gambrel";
     dutch: "dutch";
     mansard: "mansard";
+    conical: "conical";
 }>;
 export type RoofType = z.infer<typeof RoofType>;
 export declare const MIN_ROOF_SEGMENT_TRIM_SPAN = 0.1;
@@ -70,7 +71,7 @@ export declare const RoofSegmentNode: z.ZodObject<{
         fov: z.ZodOptional<z.ZodNumber>;
         zoom: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
-    metadata: z.ZodDefault<z.ZodOptional<z.ZodJSONSchema>>;
+    metadata: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
     id: z.ZodDefault<z.ZodTemplateLiteral<`rseg_${string}`>>;
     type: z.ZodDefault<z.ZodLiteral<"roof-segment">>;
     material: z.ZodOptional<z.ZodObject<{
@@ -215,9 +216,13 @@ export declare const RoofSegmentNode: z.ZodObject<{
         gambrel: "gambrel";
         dutch: "dutch";
         mansard: "mansard";
+        conical: "conical";
     }>>;
     width: z.ZodDefault<z.ZodNumber>;
     depth: z.ZodDefault<z.ZodNumber>;
+    conicalStartAngle: z.ZodOptional<z.ZodNumber>;
+    conicalSweepAngle: z.ZodOptional<z.ZodNumber>;
+    conicalFullCircle: z.ZodOptional<z.ZodBoolean>;
     trim: z.ZodDefault<z.ZodObject<{
         left: z.ZodDefault<z.ZodNumber>;
         right: z.ZodDefault<z.ZodNumber>;
@@ -242,6 +247,33 @@ export declare const RoofSegmentNode: z.ZodObject<{
     deckThickness: z.ZodDefault<z.ZodNumber>;
     overhang: z.ZodDefault<z.ZodNumber>;
     shingleThickness: z.ZodDefault<z.ZodNumber>;
+    arc: z.ZodOptional<z.ZodObject<{
+        centerX: z.ZodNumber;
+        centerZ: z.ZodNumber;
+        radius: z.ZodNumber;
+    }, z.core.$strip>>;
+    shedSideInfillSpan: z.ZodOptional<z.ZodNumber>;
+    shedSideInfillMinX: z.ZodOptional<z.ZodNumber>;
+    shedSideInfillMaxX: z.ZodOptional<z.ZodNumber>;
+    shedFootprintPieces: z.ZodOptional<z.ZodArray<z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>>>;
+    shedOpenEndSides: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        right: "right";
+        left: "left";
+    }>>>;
+    shedJointFrame: z.ZodOptional<z.ZodObject<{
+        position: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        rotation: z.ZodNumber;
+    }, z.core.$strip>>;
+    shedJointOwnerId: z.ZodOptional<z.ZodString>;
+    shedJointNeighborIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    shedJointScopeId: z.ZodOptional<z.ZodString>;
+    managedByParent: z.ZodDefault<z.ZodBoolean>;
+    wallShell: z.ZodDefault<z.ZodEnum<{
+        auto: "auto";
+        include: "include";
+        omit: "omit";
+    }>>;
+    shedInsetEndPanels: z.ZodDefault<z.ZodBoolean>;
     gambrelLowerWidthRatio: z.ZodDefault<z.ZodNumber>;
     gambrelLowerHeightRatio: z.ZodDefault<z.ZodNumber>;
     mansardSteepWidthRatio: z.ZodDefault<z.ZodNumber>;
@@ -254,6 +286,11 @@ export declare const RoofSegmentNode: z.ZodObject<{
     children: z.ZodDefault<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 export type RoofSegmentNode = z.infer<typeof RoofSegmentNode>;
+export declare function getConicalRoofCoverage(node: Pick<RoofSegmentNode, 'conicalFullCircle' | 'conicalStartAngle' | 'conicalSweepAngle'>): {
+    fullCircle: boolean;
+    startAngle: number;
+    sweepAngle: number;
+};
 export declare function normalizeRoofSegmentTrim(node: Pick<RoofSegmentNode, 'width' | 'depth'> & {
     trim?: Partial<RoofSegmentTrim>;
 }): RoofSegmentTrim;
@@ -322,6 +359,9 @@ export type RoofSegmentVisibleTopBounds = {
 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;
+export declare function isBandedShedSegment(node: Pick<RoofSegmentNode, 'roofType' | 'arc'>): node is Pick<RoofSegmentNode, 'roofType' | 'arc'> & {
+    arc: NonNullable<RoofSegmentNode['arc']>;
+};
 /**
  * Inverse of `getActiveRoofHeight` — recover the pitch a legacy
  * `roofHeight` value would correspond to. Used by the scene migration.