@pascal-app/nodes 1.0.7 → 1.1.0

package/dist/dormer/definition.d.ts

@@ -1,12 +1,241 @@
-import { type NodeDefinition } from '@pascal-app/core';
-import { DormerNode } from './schema.js';
-/**
- * Dormer — a small house-shaped protrusion sitting on top of a roof
- * segment. Windows are hosted child nodes; the legacy window* fields remain
- * in the schema only so scene migration can preserve older dormers.
- *
- * The renderer cuts each hosted window from the dormer shell and mounts
- * the regular WindowNode renderer in the selected wall-face frame.
- */
-export declare const dormerDefinition: NodeDefinition<typeof DormerNode>;
+export declare const dormerDefinition: import("@pascal-app/core").NodeDefinition<import("zod").ZodObject<{
+    object: import("zod").ZodDefault<import("zod").ZodLiteral<"node">>;
+    name: import("zod").ZodOptional<import("zod").ZodString>;
+    parentId: import("zod").ZodDefault<import("zod").ZodNullable<import("zod").ZodString>>;
+    visible: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodBoolean>>;
+    camera: import("zod").ZodOptional<import("zod").ZodObject<{
+        position: import("zod").ZodTuple<[import("zod").ZodNumber, import("zod").ZodNumber, import("zod").ZodNumber], null>;
+        target: import("zod").ZodTuple<[import("zod").ZodNumber, import("zod").ZodNumber, import("zod").ZodNumber], null>;
+        mode: import("zod").ZodDefault<import("zod").ZodEnum<{
+            orthographic: "orthographic";
+            perspective: "perspective";
+        }>>;
+        fov: import("zod").ZodOptional<import("zod").ZodNumber>;
+        zoom: import("zod").ZodOptional<import("zod").ZodNumber>;
+    }, import("zod/v4/core").$strip>>;
+    metadata: import("zod").ZodDefault<import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>>;
+    provenance: import("zod").ZodOptional<import("zod").ZodObject<{
+        refs: import("zod").ZodArray<import("zod").ZodObject<{
+            ns: import("zod").ZodOptional<import("zod").ZodString>;
+            id: import("zod").ZodString;
+            role: import("zod").ZodOptional<import("zod").ZodEnum<{
+                absorbed: "absorbed";
+                alias: "alias";
+                derived: "derived";
+                piece: "piece";
+                primary: "primary";
+            }>>;
+        }, import("zod/v4/core").$strip>>;
+        lineage: import("zod").ZodOptional<import("zod").ZodObject<{
+            op: import("zod").ZodEnum<{
+                attach: "attach";
+                convert: "convert";
+                duplicate: "duplicate";
+                import: "import";
+                "make-independent": "make-independent";
+                merge: "merge";
+                promote: "promote";
+                split: "split";
+            }>;
+            fromIds: import("zod").ZodArray<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>>;
+    }, import("zod/v4/core").$strip>>;
+    id: import("zod").ZodDefault<import("zod").ZodTemplateLiteral<`dormer_${string}`>>;
+    type: import("zod").ZodDefault<import("zod").ZodLiteral<"dormer">>;
+    material: import("zod").ZodOptional<import("zod").ZodObject<{
+        id: import("zod").ZodOptional<import("zod").ZodString>;
+        preset: import("zod").ZodOptional<import("zod").ZodCatch<import("zod").ZodEnum<{
+            brick: "brick";
+            concrete: "concrete";
+            custom: "custom";
+            glass: "glass";
+            marble: "marble";
+            metal: "metal";
+            plaster: "plaster";
+            tile: "tile";
+            white: "white";
+            wood: "wood";
+        }>>>;
+        properties: import("zod").ZodOptional<import("zod").ZodObject<{
+            color: import("zod").ZodDefault<import("zod").ZodString>;
+            roughness: import("zod").ZodDefault<import("zod").ZodNumber>;
+            metalness: import("zod").ZodDefault<import("zod").ZodNumber>;
+            opacity: import("zod").ZodDefault<import("zod").ZodNumber>;
+            transparent: import("zod").ZodDefault<import("zod").ZodBoolean>;
+            side: import("zod").ZodDefault<import("zod").ZodEnum<{
+                back: "back";
+                double: "double";
+                front: "front";
+            }>>;
+        }, import("zod/v4/core").$strip>>;
+        texture: import("zod").ZodOptional<import("zod").ZodObject<{
+            url: import("zod").ZodString;
+            repeat: import("zod").ZodOptional<import("zod").ZodTuple<[import("zod").ZodNumber, import("zod").ZodNumber], null>>;
+            scale: import("zod").ZodOptional<import("zod").ZodNumber>;
+            offset: import("zod").ZodOptional<import("zod").ZodTuple<[import("zod").ZodNumber, import("zod").ZodNumber], null>>;
+            normalMap: import("zod").ZodOptional<import("zod").ZodString>;
+            normalScale: import("zod").ZodOptional<import("zod").ZodNumber>;
+            bumpMap: import("zod").ZodOptional<import("zod").ZodString>;
+            bumpScale: import("zod").ZodOptional<import("zod").ZodNumber>;
+        }, import("zod/v4/core").$strip>>;
+    }, import("zod/v4/core").$strip>>;
+    materialPreset: import("zod").ZodOptional<import("zod").ZodString>;
+    topMaterial: import("zod").ZodOptional<import("zod").ZodObject<{
+        id: import("zod").ZodOptional<import("zod").ZodString>;
+        preset: import("zod").ZodOptional<import("zod").ZodCatch<import("zod").ZodEnum<{
+            brick: "brick";
+            concrete: "concrete";
+            custom: "custom";
+            glass: "glass";
+            marble: "marble";
+            metal: "metal";
+            plaster: "plaster";
+            tile: "tile";
+            white: "white";
+            wood: "wood";
+        }>>>;
+        properties: import("zod").ZodOptional<import("zod").ZodObject<{
+            color: import("zod").ZodDefault<import("zod").ZodString>;
+            roughness: import("zod").ZodDefault<import("zod").ZodNumber>;
+            metalness: import("zod").ZodDefault<import("zod").ZodNumber>;
+            opacity: import("zod").ZodDefault<import("zod").ZodNumber>;
+            transparent: import("zod").ZodDefault<import("zod").ZodBoolean>;
+            side: import("zod").ZodDefault<import("zod").ZodEnum<{
+                back: "back";
+                double: "double";
+                front: "front";
+            }>>;
+        }, import("zod/v4/core").$strip>>;
+        texture: import("zod").ZodOptional<import("zod").ZodObject<{
+            url: import("zod").ZodString;
+            repeat: import("zod").ZodOptional<import("zod").ZodTuple<[import("zod").ZodNumber, import("zod").ZodNumber], null>>;
+            scale: import("zod").ZodOptional<import("zod").ZodNumber>;
+            offset: import("zod").ZodOptional<import("zod").ZodTuple<[import("zod").ZodNumber, import("zod").ZodNumber], null>>;
+            normalMap: import("zod").ZodOptional<import("zod").ZodString>;
+            normalScale: import("zod").ZodOptional<import("zod").ZodNumber>;
+            bumpMap: import("zod").ZodOptional<import("zod").ZodString>;
+            bumpScale: import("zod").ZodOptional<import("zod").ZodNumber>;
+        }, import("zod/v4/core").$strip>>;
+    }, import("zod/v4/core").$strip>>;
+    topMaterialPreset: import("zod").ZodOptional<import("zod").ZodString>;
+    sideMaterial: import("zod").ZodOptional<import("zod").ZodObject<{
+        id: import("zod").ZodOptional<import("zod").ZodString>;
+        preset: import("zod").ZodOptional<import("zod").ZodCatch<import("zod").ZodEnum<{
+            brick: "brick";
+            concrete: "concrete";
+            custom: "custom";
+            glass: "glass";
+            marble: "marble";
+            metal: "metal";
+            plaster: "plaster";
+            tile: "tile";
+            white: "white";
+            wood: "wood";
+        }>>>;
+        properties: import("zod").ZodOptional<import("zod").ZodObject<{
+            color: import("zod").ZodDefault<import("zod").ZodString>;
+            roughness: import("zod").ZodDefault<import("zod").ZodNumber>;
+            metalness: import("zod").ZodDefault<import("zod").ZodNumber>;
+            opacity: import("zod").ZodDefault<import("zod").ZodNumber>;
+            transparent: import("zod").ZodDefault<import("zod").ZodBoolean>;
+            side: import("zod").ZodDefault<import("zod").ZodEnum<{
+                back: "back";
+                double: "double";
+                front: "front";
+            }>>;
+        }, import("zod/v4/core").$strip>>;
+        texture: import("zod").ZodOptional<import("zod").ZodObject<{
+            url: import("zod").ZodString;
+            repeat: import("zod").ZodOptional<import("zod").ZodTuple<[import("zod").ZodNumber, import("zod").ZodNumber], null>>;
+            scale: import("zod").ZodOptional<import("zod").ZodNumber>;
+            offset: import("zod").ZodOptional<import("zod").ZodTuple<[import("zod").ZodNumber, import("zod").ZodNumber], null>>;
+            normalMap: import("zod").ZodOptional<import("zod").ZodString>;
+            normalScale: import("zod").ZodOptional<import("zod").ZodNumber>;
+            bumpMap: import("zod").ZodOptional<import("zod").ZodString>;
+            bumpScale: import("zod").ZodOptional<import("zod").ZodNumber>;
+        }, import("zod/v4/core").$strip>>;
+    }, import("zod/v4/core").$strip>>;
+    sideMaterialPreset: import("zod").ZodOptional<import("zod").ZodString>;
+    wallMaterial: import("zod").ZodOptional<import("zod").ZodObject<{
+        id: import("zod").ZodOptional<import("zod").ZodString>;
+        preset: import("zod").ZodOptional<import("zod").ZodCatch<import("zod").ZodEnum<{
+            brick: "brick";
+            concrete: "concrete";
+            custom: "custom";
+            glass: "glass";
+            marble: "marble";
+            metal: "metal";
+            plaster: "plaster";
+            tile: "tile";
+            white: "white";
+            wood: "wood";
+        }>>>;
+        properties: import("zod").ZodOptional<import("zod").ZodObject<{
+            color: import("zod").ZodDefault<import("zod").ZodString>;
+            roughness: import("zod").ZodDefault<import("zod").ZodNumber>;
+            metalness: import("zod").ZodDefault<import("zod").ZodNumber>;
+            opacity: import("zod").ZodDefault<import("zod").ZodNumber>;
+            transparent: import("zod").ZodDefault<import("zod").ZodBoolean>;
+            side: import("zod").ZodDefault<import("zod").ZodEnum<{
+                back: "back";
+                double: "double";
+                front: "front";
+            }>>;
+        }, import("zod/v4/core").$strip>>;
+        texture: import("zod").ZodOptional<import("zod").ZodObject<{
+            url: import("zod").ZodString;
+            repeat: import("zod").ZodOptional<import("zod").ZodTuple<[import("zod").ZodNumber, import("zod").ZodNumber], null>>;
+            scale: import("zod").ZodOptional<import("zod").ZodNumber>;
+            offset: import("zod").ZodOptional<import("zod").ZodTuple<[import("zod").ZodNumber, import("zod").ZodNumber], null>>;
+            normalMap: import("zod").ZodOptional<import("zod").ZodString>;
+            normalScale: import("zod").ZodOptional<import("zod").ZodNumber>;
+            bumpMap: import("zod").ZodOptional<import("zod").ZodString>;
+            bumpScale: import("zod").ZodOptional<import("zod").ZodNumber>;
+        }, import("zod/v4/core").$strip>>;
+    }, import("zod/v4/core").$strip>>;
+    wallMaterialPreset: import("zod").ZodOptional<import("zod").ZodString>;
+    roofSegmentId: import("zod").ZodOptional<import("zod").ZodString>;
+    position: import("zod").ZodDefault<import("zod").ZodTuple<[import("zod").ZodNumber, import("zod").ZodNumber, import("zod").ZodNumber], null>>;
+    rotation: import("zod").ZodDefault<import("zod").ZodNumber>;
+    width: import("zod").ZodDefault<import("zod").ZodNumber>;
+    depth: import("zod").ZodDefault<import("zod").ZodNumber>;
+    height: import("zod").ZodDefault<import("zod").ZodNumber>;
+    roofType: import("zod").ZodDefault<import("zod").ZodEnum<{
+        barrel: "barrel";
+        conical: "conical";
+        dutch: "dutch";
+        flat: "flat";
+        gable: "gable";
+        gambrel: "gambrel";
+        hip: "hip";
+        mansard: "mansard";
+        shed: "shed";
+    }>>;
+    roofHeight: import("zod").ZodDefault<import("zod").ZodNumber>;
+    shedHighSide: import("zod").ZodDefault<import("zod").ZodEnum<{
+        back: "back";
+        front: "front";
+    }>>;
+    wallSkirtHeight: import("zod").ZodDefault<import("zod").ZodNumber>;
+    windowWidth: import("zod").ZodDefault<import("zod").ZodNumber>;
+    windowHeight: import("zod").ZodDefault<import("zod").ZodNumber>;
+    windowOffsetX: import("zod").ZodDefault<import("zod").ZodNumber>;
+    windowOffsetY: import("zod").ZodDefault<import("zod").ZodNumber>;
+    windowFrameThickness: import("zod").ZodDefault<import("zod").ZodNumber>;
+    windowFrameDepth: import("zod").ZodDefault<import("zod").ZodNumber>;
+    windowColumns: import("zod").ZodDefault<import("zod").ZodNumber>;
+    windowRows: import("zod").ZodDefault<import("zod").ZodNumber>;
+    windowDividerThickness: import("zod").ZodDefault<import("zod").ZodNumber>;
+    windowShape: import("zod").ZodDefault<import("zod").ZodEnum<{
+        arch: "arch";
+        rectangle: "rectangle";
+        rounded: "rounded";
+    }>>;
+    windowArchHeight: import("zod").ZodDefault<import("zod").ZodNumber>;
+    windowCornerRadii: import("zod").ZodDefault<import("zod").ZodTuple<[import("zod").ZodNumber, import("zod").ZodNumber, import("zod").ZodNumber, import("zod").ZodNumber], null>>;
+    windowSill: import("zod").ZodDefault<import("zod").ZodBoolean>;
+    windowSillDepth: import("zod").ZodDefault<import("zod").ZodNumber>;
+    windowSillThickness: import("zod").ZodDefault<import("zod").ZodNumber>;
+    children: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodDefault<import("zod").ZodTemplateLiteral<`window_${string}`>>>>;
+}, import("zod/v4/core").$strip>>;
 //# sourceMappingURL=definition.d.ts.map

package/dist/dormer/definition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/dormer/definition.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAA;AAKzB,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAqPrC;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,EAAE,cAAc,CAAC,OAAO,UAAU,CAgF9D,CAAA"}
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/dormer/definition.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCAG5B,CAAA"}

package/dist/dormer/definition.edit.d.ts

@@ -0,0 +1,4 @@
+import type { NodeEditContribution } from '../definition-contributions.js';
+import type { DormerNode } from './schema.js';
+export declare const dormerEditContribution: NodeEditContribution<typeof DormerNode>;
+//# sourceMappingURL=definition.edit.d.ts.map

package/dist/dormer/definition.edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.edit.d.ts","sourceRoot":"","sources":["../../src/dormer/definition.edit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAIvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAuM1C,eAAO,MAAM,sBAAsB,EAAE,oBAAoB,CAAC,OAAO,UAAU,CAyB1E,CAAA"}

package/dist/dormer/definition.edit.js

@@ -0,0 +1,214 @@
+import { buildDormerFloorplan } from './floorplan.js';
+import { dormerPaint } from './paint.js';
+import { dormerParametrics } from './parametrics.js';
+const SIDE_HANDLE_OFFSET = 0.25;
+const ROTATE_CORNER_OFFSET = 0.35;
+const ROTATE_RING_OFFSET = 0.08;
+// Schema/parametrics ranges — keep these aligned with `dormerParametrics`
+// so the in-world drag and the inspector slider clamp identically.
+const MIN_DIM = 0.5;
+const MIN_HEIGHT = 0;
+// Clamp used for handle Y placement so side chevrons stay reachable on
+// dormers whose wall is flat (`height ≈ 0`). The dormer body is
+// `height + roofHeight` tall; if that collapses too, the side arrows
+// would bury into the deck — this floor keeps them visible.
+const MIN_BODY_DISPLAY = 0.3;
+// Mid-Y of the dormer body in dormer-local frame. Y=0 is the eave
+// (where wall meets skirt); body extends up to `height + roofHeight`.
+// Side chevrons sit at the body midpoint so they read as "this is the
+// dormer's footprint" rather than floating at the apex or the eave.
+function getBodyMidY(n) {
+    return Math.max(n.height + n.roofHeight, MIN_BODY_DISPLAY) / 2;
+}
+// Width arrow on the +X (right) or -X (left) side. Asymmetric resize:
+// dragging one arrow grows the dormer outward from its own edge while
+// the opposite edge stays world-fixed in segment frame. The dormer's
+// registered ref frame is dormer-local (renderer applies position +
+// rotation on the registered group), so placements are in dormer-local
+// coords — no per-arrow rotation/translation compensation here.
+//
+// `apply` recomputes `position` so the anchored edge stays at the same
+// segment-local point even when the dormer is Y-rotated: project the
+// dormer's local +X onto segment frame via (cos r, -sin r), find the
+// anchored edge's segment-local XZ from the pre-drag node, then place
+// the new center half a new-width away from that anchor in the same
+// direction. Mirrors chimney + roof-segment width handle math.
+function dormerWidthHandle(side) {
+    const sign = side === 'right' ? 1 : -1;
+    return {
+        kind: 'linear-resize',
+        axis: 'x',
+        // 'min' = -X edge anchored (right arrow grows the +X edge outward).
+        // 'max' = +X edge anchored (left arrow grows the -X edge outward).
+        anchor: side === 'right' ? 'min' : 'max',
+        // Default 'parent' portal (no `'grandparent'` escape). Arrows
+        // portal into the host roof segment's registered mesh, which lives
+        // inside the roof renderer's `<group name="segments-wrapper">`.
+        // That wrapper is `visible={false}` by default; `RoofEditSystem`
+        // imperatively flips it to `visible={true}` whenever any accessory
+        // hosted on a segment of this roof is selected, so the portaled
+        // arrows become visible during selection without us reaching for
+        // `portal: 'grandparent'` — which trips the same "Color target has
+        // no corresponding fragment stage output" WebGPU pipeline error
+        // chimney already documents.
+        min: MIN_DIM,
+        currentValue: (n) => n.width,
+        apply: (initial, newWidth) => {
+            const rotY = initial.rotation ?? 0;
+            const armX = Math.cos(rotY);
+            const armZ = -Math.sin(rotY);
+            const anchorX = initial.position[0] - sign * (initial.width / 2) * armX;
+            const anchorZ = initial.position[2] - sign * (initial.width / 2) * armZ;
+            const newCenterX = anchorX + sign * (newWidth / 2) * armX;
+            const newCenterZ = anchorZ + sign * (newWidth / 2) * armZ;
+            return {
+                width: newWidth,
+                position: [newCenterX, initial.position[1], newCenterZ],
+            };
+        },
+        placement: {
+            position: (n) => [sign * (n.width / 2 + SIDE_HANDLE_OFFSET), getBodyMidY(n), 0],
+            // Flip the left chevron so it points outward toward -X. The
+            // generic LinearArrow only auto-orients for axis 'z'; +X / -X
+            // facing is up to the descriptor.
+            rotationY: () => (side === 'right' ? 0 : Math.PI),
+        },
+    };
+}
+// Depth arrow on the +Z (front) or -Z (back) side. Asymmetric resize:
+// dragging one arrow grows the dormer outward from its own edge while
+// the opposite edge stays world-fixed in segment frame — same pattern
+// as `dormerWidthHandle`, just on the Z axis. `apply` recomputes
+// `position` so the anchored edge stays at the same segment-local point
+// even when the dormer is Y-rotated: project the dormer's local +Z onto
+// segment frame via (sin r, cos r), find the anchored edge's segment-
+// local XZ from the pre-drag node, then place the new center half a new-
+// depth away from that anchor in the same direction.
+function dormerDepthHandle(side) {
+    const sign = side === 'front' ? 1 : -1;
+    return {
+        kind: 'linear-resize',
+        axis: 'z',
+        // 'min' = -Z edge anchored (front arrow grows the +Z edge outward).
+        // 'max' = +Z edge anchored (back arrow grows the -Z edge outward).
+        anchor: side === 'front' ? 'min' : 'max',
+        min: MIN_DIM,
+        currentValue: (n) => n.depth,
+        apply: (initial, newDepth) => {
+            const rotY = initial.rotation ?? 0;
+            const armX = Math.sin(rotY);
+            const armZ = Math.cos(rotY);
+            const anchorX = initial.position[0] - sign * (initial.depth / 2) * armX;
+            const anchorZ = initial.position[2] - sign * (initial.depth / 2) * armZ;
+            const newCenterX = anchorX + sign * (newDepth / 2) * armX;
+            const newCenterZ = anchorZ + sign * (newDepth / 2) * armZ;
+            return {
+                depth: newDepth,
+                position: [newCenterX, initial.position[1], newCenterZ],
+            };
+        },
+        placement: {
+            position: (n) => [0, getBodyMidY(n), sign * (n.depth / 2 + SIDE_HANDLE_OFFSET)],
+            // The renderer auto-yaws axis-'z' chevrons by -π/2 so the default
+            // points +Z (front). Flip the back chevron 180° to point -Z.
+            rotationY: () => (side === 'front' ? 0 : Math.PI),
+        },
+    };
+}
+// Wall-height tracker — dashed vertical leader from the eave (y=0) up
+// to a draggable cube at the wall top (y=height), centred on the
+// footprint. Reads as "the dormer wall is THIS tall" without claiming
+// the roof apex. Same `linear-resize axis='y'` pipeline as every other
+// height handle; `shape: 'tracker'` only swaps the visual.
+function dormerWallHeightHandle() {
+    return {
+        kind: 'linear-resize',
+        axis: 'y',
+        anchor: 'min',
+        shape: 'tracker',
+        min: MIN_HEIGHT,
+        currentValue: (n) => n.height,
+        apply: (_n, newValue) => ({ height: newValue }),
+        placement: {
+            position: (n) => [0, Math.max(n.height, 0.001), 0],
+        },
+        trackerBaseY: () => 0,
+    };
+}
+// Whole-dormer rotation gizmo at the +X / +Z corner of the footprint,
+// guide ring traces the corner-diagonal radius on hover / drag.
+// Dormer-local frame is the registered group (renderer applies
+// node.position + node.rotation there), so the default rotation pivot
+// (rideObject origin = dormer center) is correct — no
+// `rotationCenter` override needed.
+function dormerRotateHandle() {
+    return {
+        kind: 'arc-resize',
+        axis: 'angular',
+        shape: 'rotate',
+        // Negate the cursor delta to match three.js Y-rotation handedness
+        // (cursor atan2 ticks opposite-handed from `rotation-y`).
+        apply: (initial, delta) => ({ rotation: (initial.rotation ?? 0) - delta }),
+        placement: {
+            position: (n) => {
+                const halfX = n.width / 2 + ROTATE_CORNER_OFFSET;
+                const halfZ = n.depth / 2 + ROTATE_CORNER_OFFSET;
+                return [halfX, getBodyMidY(n), halfZ];
+            },
+            // The two-headed icon's natural bias points along +X; aim it at
+            // the corner (45° outward from the dormer's local frame).
+            rotationY: () => -Math.PI / 4,
+        },
+        decoration: {
+            kind: 'ring',
+            radius: (n) => Math.hypot(n.width / 2, n.depth / 2) + ROTATE_RING_OFFSET,
+            y: (n) => getBodyMidY(n),
+        },
+    };
+}
+const dormerHandles = [
+    dormerWidthHandle('right'),
+    dormerWidthHandle('left'),
+    dormerDepthHandle('front'),
+    dormerDepthHandle('back'),
+    dormerWallHeightHandle(),
+    dormerRotateHandle(),
+    // The wall-skirt (downward chevron), roof-height (peak chevron), and
+    // the asymmetric front/back depth split stay out for now. Re-adding
+    // any of them previously fired the "Color target has no
+    // corresponding fragment stage output" WebGPU pipeline error chimney
+    // already documented for its flue / cap-thickness / cap-overhang
+    // extras — only reproducible while `portal: 'grandparent'` was set,
+    // which we no longer rely on (RoofEditSystem reveals the wrapper
+    // instead). The shapes themselves are valid; if the count budget
+    // turns out to also be sensitive without grandparent portal, keep
+    // the current compact set.
+    // dormerWallSkirtHandle(),
+    // dormerRoofHeightHandle(),
+];
+export const dormerEditContribution = {
+    capabilities: {
+        // Paint dispatch for the wall / side / top surface split. The
+        // editor's selection-manager routes paint hover / click /
+        // preview through this entry rather than carrying a kind-name
+        // arm.
+        paint: dormerPaint,
+    },
+    affordanceTools: {
+        // Drag-to-place tool for duplicate + move. Reuses the placement
+        // ghost preview but seeds it from the moving (cloned) node so the
+        // duplicate keeps the source's dimensions, materials, and window
+        // options.
+        move: () => import('./move-tool.js'),
+    },
+    parametrics: dormerParametrics,
+    handles: dormerHandles,
+    floorplan: buildDormerFloorplan,
+    preview: () => import('./preview.js'),
+    tool: () => import('./tool.js'),
+    toolHints: [
+        { key: 'Left click', label: 'Place dormer on roof' },
+        { key: 'R / Shift+R', label: 'Rotate ghost ±15°' },
+        { key: 'Esc', label: 'Cancel' },
+    ],
+};