@pascal-app/nodes 0.1.1

package/dist/turbine-vent/panel.js

@@ -0,0 +1,127 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { getActiveRoofHeight, TurbineVentNode as TurbineVentSchema, useLiveNodeOverrides, useScene, } from '@pascal-app/core';
+import { ActionButton, ActionGroup, PanelSection, PanelWrapper, SegmentedControl, SliderControl, triggerSFX, useEditor, } from '@pascal-app/editor';
+import { useViewer } from '@pascal-app/viewer';
+import { Copy, Move, Pause, Play, Trash2 } from 'lucide-react';
+import { useCallback, useRef } from 'react';
+// Speed restored when resuming a paused turbine that has no remembered
+// speed yet (matches the schema default).
+const DEFAULT_SPIN_SPEED = 0.8;
+/**
+ * Inspector panel for a placed turbine vent. Exposes style + dimensions +
+ * spin speed plus Move / Duplicate / Delete wired into the same
+ * ghost-preview drag flow the placement tool uses (see `./move-tool.tsx`).
+ * Mirrors the box-vent panel.
+ */
+export default function TurbineVentPanel() {
+    const selectedId = useViewer((s) => s.selection.selectedIds[0]);
+    const setSelection = useViewer((s) => s.setSelection);
+    const updateNode = useScene((s) => s.updateNode);
+    const deleteNode = useScene((s) => s.deleteNode);
+    const setMovingNode = useEditor((s) => s.setMovingNode);
+    const storeNode = useScene((s) => selectedId ? s.nodes[selectedId] : undefined);
+    const overrides = useLiveNodeOverrides((s) => selectedId
+        ? s.get(selectedId)
+        : undefined);
+    const node = storeNode && overrides ? { ...storeNode, ...overrides } : storeNode;
+    const segment = useScene((s) => node?.roofSegmentId
+        ? s.nodes[node.roofSegmentId]
+        : undefined);
+    const previewProp = useCallback((updates) => {
+        if (!selectedId)
+            return;
+        useLiveNodeOverrides.getState().set(selectedId, updates);
+    }, [selectedId]);
+    const commitProp = useCallback((updates) => {
+        if (!selectedId)
+            return;
+        updateNode(selectedId, updates);
+        useLiveNodeOverrides.getState().clear(selectedId);
+    }, [selectedId, updateNode]);
+    const handleUpdate = commitProp;
+    const handleClose = useCallback(() => {
+        setSelection({ selectedIds: [] });
+    }, [setSelection]);
+    const handleBack = useCallback(() => {
+        if (node?.roofSegmentId) {
+            setSelection({ selectedIds: [node.roofSegmentId] });
+        }
+    }, [node?.roofSegmentId, setSelection]);
+    const handleMove = useCallback(() => {
+        if (!node)
+            return;
+        triggerSFX('sfx:item-pick');
+        setMovingNode(node);
+        setSelection({ selectedIds: [] });
+    }, [node, setMovingNode, setSelection]);
+    const handleDuplicate = useCallback(() => {
+        if (!node)
+            return;
+        triggerSFX('sfx:item-pick');
+        const parentId = node.roofSegmentId;
+        if (!parentId)
+            return;
+        const state = useScene.getState();
+        const meta = typeof node.metadata === 'object' && node.metadata !== null
+            ? node.metadata
+            : {};
+        const cloneInput = {
+            ...node,
+            id: undefined,
+            metadata: { ...meta, isNew: true },
+        };
+        const cloned = TurbineVentSchema.parse(cloneInput);
+        state.createNode(cloned, parentId);
+        state.dirtyNodes.add(parentId);
+        setMovingNode(cloned);
+        setSelection({ selectedIds: [] });
+    }, [node, setMovingNode, setSelection]);
+    const handleDelete = useCallback(() => {
+        if (!(selectedId && node))
+            return;
+        triggerSFX('sfx:item-delete');
+        const segmentId = node.roofSegmentId;
+        if (segmentId) {
+            const state = useScene.getState();
+            const seg = state.nodes[segmentId];
+            if (seg) {
+                state.updateNode(segmentId, {
+                    children: (seg.children ?? []).filter((id) => id !== selectedId),
+                });
+            }
+        }
+        deleteNode(selectedId);
+        if (segmentId) {
+            useScene.getState().dirtyNodes.add(segmentId);
+            setSelection({ selectedIds: [segmentId] });
+        }
+        else {
+            setSelection({ selectedIds: [] });
+        }
+    }, [selectedId, node, deleteNode, setSelection]);
+    // Play / pause the idle spin. Pausing remembers the current speed so
+    // Play restores it (falling back to the default if it was never running).
+    const lastSpeedRef = useRef(DEFAULT_SPIN_SPEED);
+    const isSpinning = (node?.spinSpeed ?? 0) > 0;
+    const handleToggleSpin = useCallback(() => {
+        if (!node)
+            return;
+        const current = node.spinSpeed ?? 0;
+        if (current > 0) {
+            lastSpeedRef.current = current;
+            handleUpdate({ spinSpeed: 0 });
+        }
+        else {
+            handleUpdate({
+                spinSpeed: lastSpeedRef.current > 0 ? lastSpeedRef.current : DEFAULT_SPIN_SPEED,
+            });
+        }
+    }, [node, handleUpdate]);
+    if (!(node && node.type === 'turbine-vent' && selectedId))
+        return null;
+    return (_jsxs(PanelWrapper, { icon: "/icons/roof.webp", onBack: node.roofSegmentId ? handleBack : undefined, onClose: handleClose, title: node.name || 'Turbine Vent', width: 300, children: [_jsx(PanelSection, { title: "Style", children: _jsx(SegmentedControl, { onChange: (v) => handleUpdate({ style: v }), options: [
+                        { label: 'Globe', value: 'globe' },
+                        { label: 'Cylinder', value: 'cylinder' },
+                    ], value: node.style ?? 'globe' }) }), _jsxs(PanelSection, { title: "Dimensions", children: [_jsx(SliderControl, { label: "Diameter", max: 0.7, min: 0.15, onChange: (v) => previewProp({ diameter: v }), onCommit: (v) => handleUpdate({ diameter: v }), precision: 2, restoreOnCommit: false, step: 0.01, unit: "m", value: Math.round(node.diameter * 100) / 100 }), _jsx(SliderControl, { label: "Height", max: 0.9, min: 0.2, onChange: (v) => previewProp({ height: v }), onCommit: (v) => handleUpdate({ height: v }), precision: 2, restoreOnCommit: false, step: 0.01, unit: "m", value: Math.round(node.height * 100) / 100 }), _jsx(SliderControl, { label: "Neck Height", max: Math.max(0.04, node.height * 0.5), min: 0.02, onChange: (v) => previewProp({ neckHeight: v }), onCommit: (v) => handleUpdate({ neckHeight: v }), precision: 2, restoreOnCommit: false, step: 0.01, unit: "m", value: Math.round((node.neckHeight ?? 0.09) * 100) / 100 }), _jsx(SliderControl, { label: "Vanes", max: 36, min: 6, onChange: (v) => previewProp({ vaneCount: Math.round(v) }), onCommit: (v) => handleUpdate({ vaneCount: Math.round(v) }), precision: 0, restoreOnCommit: false, step: 1, unit: "", value: Math.round(node.vaneCount ?? 20) })] }), _jsxs(PanelSection, { title: "Motion", children: [_jsx(ActionGroup, { children: _jsx(ActionButton, { icon: isSpinning ? _jsx(Pause, { className: "h-3.5 w-3.5" }) : _jsx(Play, { className: "h-3.5 w-3.5" }), label: isSpinning ? 'Pause' : 'Play', onClick: handleToggleSpin }) }), _jsx(SliderControl, { label: "Spin Speed", max: 4, min: 0, onChange: (v) => previewProp({ spinSpeed: v }), onCommit: (v) => handleUpdate({ spinSpeed: v }), precision: 1, restoreOnCommit: false, step: 0.1, unit: "rad/s", value: Math.round((node.spinSpeed ?? 0) * 10) / 10 })] }), _jsxs(PanelSection, { title: "Position", children: [_jsx(SliderControl, { label: "X", max: Math.round(((segment?.width ?? 10) / 2) * 100) / 100, min: -Math.round(((segment?.width ?? 10) / 2) * 100) / 100, onChange: (v) => previewProp({ position: [v, node.position[1] ?? 0, node.position[2] ?? 0] }), onCommit: (v) => handleUpdate({ position: [v, node.position[1] ?? 0, node.position[2] ?? 0] }), precision: 2, restoreOnCommit: false, step: 0.05, unit: "m", value: Math.round((node.position[0] ?? 0) * 100) / 100 }), _jsx(SliderControl, { label: "Y", max: Math.max((segment?.wallHeight ?? 3) + (segment ? getActiveRoofHeight(segment) : 3) + 2, (node.position[1] ?? 0) + 0.1), min: Math.min(0, (node.position[1] ?? 0) - 0.5), onChange: (v) => previewProp({ position: [node.position[0] ?? 0, v, node.position[2] ?? 0] }), onCommit: (v) => handleUpdate({ position: [node.position[0] ?? 0, v, node.position[2] ?? 0] }), precision: 2, restoreOnCommit: false, step: 0.05, unit: "m", value: Math.round((node.position[1] ?? 0) * 100) / 100 }), _jsx(SliderControl, { label: "Z", max: Math.round(((segment?.depth ?? 10) / 2) * 100) / 100, min: -Math.round(((segment?.depth ?? 10) / 2) * 100) / 100, onChange: (v) => previewProp({ position: [node.position[0] ?? 0, node.position[1] ?? 0, v] }), onCommit: (v) => handleUpdate({ position: [node.position[0] ?? 0, node.position[1] ?? 0, v] }), precision: 2, restoreOnCommit: false, step: 0.05, unit: "m", value: Math.round((node.position[2] ?? 0) * 100) / 100 }), _jsx(SliderControl, { label: "Rotation", max: 180, min: -180, onChange: (deg) => previewProp({ rotation: (deg * Math.PI) / 180 }), onCommit: (deg) => handleUpdate({ rotation: (deg * Math.PI) / 180 }), precision: 0, restoreOnCommit: false, step: 1, unit: "\u00B0", value: Math.round(((node.rotation ?? 0) * 180) / Math.PI) })] }), _jsx(PanelSection, { title: "Actions", children: _jsxs(ActionGroup, { children: [_jsx(ActionButton, { icon: _jsx(Move, { className: "h-3.5 w-3.5" }), label: "Move", onClick: handleMove }), _jsx(ActionButton, { icon: _jsx(Copy, { className: "h-3.5 w-3.5" }), label: "Duplicate", onClick: handleDuplicate }), _jsx(ActionButton, { className: "hover:bg-red-500/20", icon: _jsx(Trash2, { className: "h-3.5 w-3.5 text-red-400" }), label: "Delete", onClick: handleDelete })] }) })] }));
+}

package/dist/turbine-vent/parametrics.d.ts

@@ -0,0 +1,9 @@
+import type { ParametricDescriptor } from '@pascal-app/core';
+import type { TurbineVentNode } from './schema';
+/**
+ * Inspector descriptor for the turbine vent. Move / Duplicate need the
+ * kind-owned ghost-preview flow (see `./move-tool.tsx`), so the panel
+ * hosts those actions itself instead of relying on the generic inspector.
+ */
+export declare const turbineVentParametrics: ParametricDescriptor<TurbineVentNode>;
+//# sourceMappingURL=parametrics.d.ts.map

package/dist/turbine-vent/parametrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parametrics.d.ts","sourceRoot":"","sources":["../../src/turbine-vent/parametrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAE/C;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,oBAAoB,CAAC,eAAe,CA4BxE,CAAA"}

package/dist/turbine-vent/parametrics.js

@@ -0,0 +1,34 @@
+/**
+ * Inspector descriptor for the turbine vent. Move / Duplicate need the
+ * kind-owned ghost-preview flow (see `./move-tool.tsx`), so the panel
+ * hosts those actions itself instead of relying on the generic inspector.
+ */
+export const turbineVentParametrics = {
+    customPanel: () => import('./panel'),
+    groups: [
+        {
+            label: 'Style',
+            fields: [
+                {
+                    key: 'style',
+                    kind: 'enum',
+                    options: ['globe', 'cylinder'],
+                    display: 'segmented',
+                },
+            ],
+        },
+        {
+            label: 'Dimensions',
+            fields: [
+                { key: 'diameter', kind: 'number', unit: 'm', min: 0.15, max: 0.7, step: 0.01 },
+                { key: 'height', kind: 'number', unit: 'm', min: 0.2, max: 0.9, step: 0.01 },
+                { key: 'neckHeight', kind: 'number', unit: 'm', min: 0.02, max: 0.3, step: 0.01 },
+                { key: 'vaneCount', kind: 'number', unit: '', min: 6, max: 36, step: 1 },
+            ],
+        },
+        {
+            label: 'Motion',
+            fields: [{ key: 'spinSpeed', kind: 'number', unit: 'rad/s', min: 0, max: 4, step: 0.1 }],
+        },
+    ],
+};

package/dist/turbine-vent/preview.d.ts

@@ -0,0 +1,14 @@
+import type { TurbineVentNode } from './schema';
+/**
+ * Translucent ghost of a turbine vent, used by the placement tool's
+ * cursor and the move-tool preview. Builds the combined (non-spinning)
+ * geometry through the shared pure builder so the ghost shape stays in
+ * lockstep with the committed vent. Raycast is disabled so the preview
+ * doesn't intercept the cursor ray feeding the placement tool.
+ */
+declare const TurbineVentPreview: ({ node, invalid }: {
+    node: TurbineVentNode;
+    invalid?: boolean;
+}) => import("react").JSX.Element;
+export default TurbineVentPreview;
+//# sourceMappingURL=preview.d.ts.map

package/dist/turbine-vent/preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../src/turbine-vent/preview.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAE/C;;;;;;GAMG;AACH,QAAA,MAAM,kBAAkB,GAAI,mBAAmB;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,gCAgD1F,CAAA;AAED,eAAe,kBAAkB,CAAA"}

package/dist/turbine-vent/preview.js

@@ -0,0 +1,38 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useMemo } from 'react';
+import * as THREE from 'three';
+import { INVALID_GHOST_COLOR } from '../shared/ghost-materials';
+import { buildTurbineVentGeometry } from './geometry';
+/**
+ * Translucent ghost of a turbine vent, used by the placement tool's
+ * cursor and the move-tool preview. Builds the combined (non-spinning)
+ * geometry through the shared pure builder so the ghost shape stays in
+ * lockstep with the committed vent. Raycast is disabled so the preview
+ * doesn't intercept the cursor ray feeding the placement tool.
+ */
+const TurbineVentPreview = ({ node, invalid }) => {
+    // biome-ignore lint/correctness/useExhaustiveDependencies: deps deliberately list the build inputs; depending on the whole object would rebuild on unrelated field changes.
+    const geometry = useMemo(() => buildTurbineVentGeometry(node), [node.style, node.diameter, node.height, node.neckHeight, node.vaneCount, node.baseOverhang]);
+    const material = useMemo(() => new THREE.MeshStandardMaterial({
+        color: invalid ? INVALID_GHOST_COLOR : 0xff_ff_ff,
+        emissive: invalid ? INVALID_GHOST_COLOR : 0x6c_a3_ff,
+        emissiveIntensity: 0.18,
+        roughness: 0.6,
+        metalness: 0.2,
+        transparent: true,
+        opacity: invalid ? 0.4 : 0.35,
+        depthWrite: false,
+        side: THREE.DoubleSide,
+    }), [invalid]);
+    const edgesGeometry = useMemo(() => new THREE.EdgesGeometry(geometry, 25), [geometry]);
+    useEffect(() => () => {
+        geometry.dispose();
+        edgesGeometry.dispose();
+        material.dispose();
+    }, [geometry, edgesGeometry, material]);
+    return (_jsxs("group", { "rotation-y": node.rotation ?? 0, children: [_jsx("mesh", { geometry: geometry, material: material, raycast: () => {
+                    /* disabled — see component-level note */
+                } }), _jsx("lineSegments", { geometry: edgesGeometry, renderOrder: 1000, children: _jsx("lineBasicMaterial", { color: 0x6c_a3_ff, depthTest: false, opacity: 0.95, transparent: true }) })] }));
+};
+export default TurbineVentPreview;

package/dist/turbine-vent/renderer.d.ts

@@ -0,0 +1,18 @@
+import { type TurbineVentNode } from '@pascal-app/core';
+/**
+ * Turbine vent renderer. Reproduces the box-vent transform stack
+ * (segment → slope tilt → yaw) so the vent rides whatever roof face it
+ * sits on, then adds the one thing no other vent has: the head spins.
+ *
+ * The mesh is split into a static base (flange + throat) and a head
+ * (finned crown + cap + knob) mounted in an inner `<group>` that
+ * `useFrame` rotates about its own vertical axis at `node.spinSpeed`
+ * rad/s (0 = static). The spin lives entirely below the registered ref
+ * group, so the handle frame — read off the registered group — is
+ * untouched.
+ */
+declare const TurbineVentRenderer: ({ node: storeNode }: {
+    node: TurbineVentNode;
+}) => import("react").JSX.Element | null;
+export default TurbineVentRenderer;
+//# sourceMappingURL=renderer.d.ts.map

package/dist/turbine-vent/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../src/turbine-vent/renderer.tsx"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,eAAe,EAIrB,MAAM,kBAAkB,CAAA;AAsBzB;;;;;;;;;;;GAWG;AACH,QAAA,MAAM,mBAAmB,GAAI,qBAAqB;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,uCA4I1E,CAAA;AAED,eAAe,mBAAmB,CAAA"}

package/dist/turbine-vent/renderer.js

@@ -0,0 +1,107 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useLiveNodeOverrides, useRegistry, useScene, } from '@pascal-app/core';
+import { createMaterial, createMaterialFromPresetRef, createSurfaceRoleMaterial, useNodeEvents, useViewer, } from '@pascal-app/viewer';
+import { useFrame } from '@react-three/fiber';
+import { useEffect, useMemo, useRef } from 'react';
+import * as THREE from 'three';
+import { getAnalyticalNormal, surfaceQuatFromNormal } from '../shared/roof-surface';
+import { useSegmentTrimClippedGeometry } from '../shared/use-segment-trim-clip';
+import { buildTurbineVentBase, buildTurbineVentHead } from './geometry';
+const defaultMaterial = new THREE.MeshStandardMaterial({
+    color: 0xff_ff_ff,
+    roughness: 0.6,
+    metalness: 0.35,
+});
+/**
+ * Turbine vent renderer. Reproduces the box-vent transform stack
+ * (segment → slope tilt → yaw) so the vent rides whatever roof face it
+ * sits on, then adds the one thing no other vent has: the head spins.
+ *
+ * The mesh is split into a static base (flange + throat) and a head
+ * (finned crown + cap + knob) mounted in an inner `<group>` that
+ * `useFrame` rotates about its own vertical axis at `node.spinSpeed`
+ * rad/s (0 = static). The spin lives entirely below the registered ref
+ * group, so the handle frame — read off the registered group — is
+ * untouched.
+ */
+const TurbineVentRenderer = ({ node: storeNode }) => {
+    const ref = useRef(null);
+    const headRef = useRef(null);
+    useRegistry(storeNode.id, 'turbine-vent', ref);
+    const handlers = useNodeEvents(storeNode, 'turbine-vent');
+    const shading = useViewer((s) => s.shading);
+    const textures = useViewer((s) => s.textures);
+    const colorPreset = useViewer((s) => s.colorPreset);
+    const sceneTheme = useViewer((s) => s.sceneTheme);
+    // Merge live overrides (panel slider drags) on top of the store node so
+    // the mesh updates frame-by-frame without polluting undo history.
+    const overrides = useLiveNodeOverrides((s) => s.get(storeNode.id));
+    const node = overrides
+        ? { ...storeNode, ...overrides }
+        : storeNode;
+    const segment = useScene((state) => node.roofSegmentId
+        ? state.nodes[node.roofSegmentId]
+        : undefined);
+    // biome-ignore lint/correctness/useExhaustiveDependencies: deps deliberately list the build inputs; depending on the whole object would rebuild on unrelated field changes.
+    const baseGeometry = useMemo(() => buildTurbineVentBase(node), [node.diameter, node.height, node.neckHeight, node.baseOverhang]);
+    // biome-ignore lint/correctness/useExhaustiveDependencies: deps deliberately list the build inputs; depending on the whole object would rebuild on unrelated field changes.
+    const headGeometry = useMemo(() => buildTurbineVentHead(node), [node.style, node.diameter, node.height, node.neckHeight, node.vaneCount]);
+    useEffect(() => () => baseGeometry.dispose(), [baseGeometry]);
+    useEffect(() => () => headGeometry.dispose(), [headGeometry]);
+    // Idle spin. `delta` keeps it frame-rate independent; speed 0 holds the
+    // head still (the default — turbines start paused). Reads `node.spinSpeed`
+    // through the render closure so the panel slider / Play toggle take effect
+    // live.
+    const spin = node.spinSpeed ?? 0;
+    useFrame((_, delta) => {
+        if (headRef.current && spin !== 0) {
+            headRef.current.rotation.y += spin * delta;
+        }
+    });
+    // Orient the vent to whatever roof face it sits on — same analytical
+    // normal the box-vent / solar-panel / skylight share.
+    const surfaceQuat = useMemo(() => {
+        if (!segment)
+            return new THREE.Quaternion();
+        const normal = getAnalyticalNormal(node.position[0] ?? 0, node.position[2] ?? 0, segment);
+        return surfaceQuatFromNormal(normal, new THREE.Quaternion());
+    }, [segment, node.position[0], node.position[2]]);
+    const material = useMemo(() => {
+        if (!textures || (!node.material && !node.materialPreset)) {
+            return createSurfaceRoleMaterial('roof', colorPreset, THREE.FrontSide, sceneTheme);
+        }
+        return node.material
+            ? createMaterial(node.material, shading)
+            : (createMaterialFromPresetRef(node.materialPreset, shading) ?? defaultMaterial);
+    }, [textures, colorPreset, sceneTheme, shading, node.material, node.materialPreset]);
+    // Compose slope tilt + yaw onto a single quaternion so the registered
+    // ref's local frame is vent-mesh-local (handles read this frame).
+    const yAxis = useMemo(() => new THREE.Vector3(0, 1, 0), []);
+    const composedQuat = useMemo(() => {
+        const yawQuat = new THREE.Quaternion().setFromAxisAngle(yAxis, node.rotation ?? 0);
+        return new THREE.Quaternion().copy(surfaceQuat).multiply(yawQuat);
+    }, [surfaceQuat, node.rotation, yAxis]);
+    const neckHForClip = Math.max(0.02, Math.min(node.neckHeight ?? 0.09, Math.max(0.12, node.height) * 0.5));
+    // Map vent-local geometry into the host segment's local frame (where the trim
+    // cut prisms live). The base sits at the inner group's pose; the head is
+    // nested one level deeper at [0, neckH, 0], so its clip matrix composes that
+    // offset. (When the head is spinning — opt-in, default paused — the cut edge
+    // rotates with it, which is acceptable for the animation.)
+    const baseLocalToSegment = useMemo(() => new THREE.Matrix4().compose(new THREE.Vector3(node.position[0] ?? 0, node.position[1] ?? 0, node.position[2] ?? 0), composedQuat, new THREE.Vector3(1, 1, 1)), [node.position[0], node.position[1], node.position[2], composedQuat]);
+    const headLocalToSegment = useMemo(() => new THREE.Matrix4()
+        .copy(baseLocalToSegment)
+        .multiply(new THREE.Matrix4().makeTranslation(0, neckHForClip, 0)), [baseLocalToSegment, neckHForClip]);
+    const clippedBase = useSegmentTrimClippedGeometry(baseGeometry, segment, baseLocalToSegment);
+    const clippedHead = useSegmentTrimClippedGeometry(headGeometry, segment, headLocalToSegment);
+    if (!segment)
+        return null;
+    // Replicate the parent segment's roof-local transform — see the long
+    // note in box-vent's renderer for why segment-local coords must be
+    // bridged through the segment frame here.
+    const segPos = segment.position ?? [0, 0, 0];
+    const segRotY = segment.rotation ?? 0;
+    const neckH = Math.max(0.02, Math.min(node.neckHeight ?? 0.09, Math.max(0.12, node.height) * 0.5));
+    return (_jsx("group", { position: segPos, "rotation-y": segRotY, children: _jsxs("group", { position: [node.position[0] ?? 0, node.position[1] ?? 0, node.position[2] ?? 0], quaternion: composedQuat, ref: ref, visible: node.visible, children: [_jsx("mesh", { castShadow: true, geometry: clippedBase ?? baseGeometry, material: material, name: "turbine-vent-base", receiveShadow: true, ...handlers }), _jsx("group", { position: [0, neckH, 0], ref: headRef, children: _jsx("mesh", { castShadow: true, geometry: clippedHead ?? headGeometry, material: material, name: "turbine-vent-head", receiveShadow: true, ...handlers }) })] }) }));
+};
+export default TurbineVentRenderer;

package/dist/turbine-vent/schema.d.ts

@@ -0,0 +1,2 @@
+export { TurbineVentNode } from '@pascal-app/core';
+//# sourceMappingURL=schema.d.ts.map

package/dist/turbine-vent/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/turbine-vent/schema.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/turbine-vent/schema.js

@@ -0,0 +1,3 @@
+// Schema lives in core (referenced by the AnyNode union). Re-export so
+// every turbine-vent-related import stays inside @pascal-app/nodes/turbine-vent.
+export { TurbineVentNode } from '@pascal-app/core';

package/dist/turbine-vent/tool.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Turbine-vent placement tool. Mounts when the palette activates the
+ * turbine-vent kind; listens for `roof:*` events; on click commits a new
+ * `TurbineVentNode` parented to the targeted segment with segment-local
+ * coordinates. Mirrors the box-vent placement flow.
+ */
+declare const TurbineVentTool: () => import("react").JSX.Element;
+export default TurbineVentTool;
+//# sourceMappingURL=tool.d.ts.map

package/dist/turbine-vent/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/turbine-vent/tool.tsx"],"names":[],"mappings":"AA4BA;;;;;GAKG;AACH,QAAA,MAAM,eAAe,mCA4HpB,CAAA;AAED,eAAe,eAAe,CAAA"}

package/dist/turbine-vent/tool.js

@@ -0,0 +1,111 @@
+'use client';
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { emitter, sceneRegistry, TurbineVentNode, useScene, } from '@pascal-app/core';
+import { triggerSFX } from '@pascal-app/editor';
+import { useViewer } from '@pascal-app/viewer';
+import { useEffect, useMemo, useRef, useState } from 'react';
+import * as THREE from 'three';
+import { RoofAttachmentFallbackPreview } from '../shared/roof-attachment-fallback-preview';
+import { resolveRoofSegmentHit } from '../shared/roof-segment-hit';
+import { getAnalyticalNormal, getDownSlopeYaw, surfaceQuatFromNormal } from '../shared/roof-surface';
+import { clearRoofSurfacePlacementGuides, publishRoofSurfacePlacementGuides, roofSurfaceFootprintFromNode, } from '../shared/roof-surface-placement-guides';
+import { turbineVentDefinition } from './definition';
+import TurbineVentPreview from './preview';
+const worldPoint = new THREE.Vector3();
+/**
+ * Turbine-vent placement tool. Mounts when the palette activates the
+ * turbine-vent kind; listens for `roof:*` events; on click commits a new
+ * `TurbineVentNode` parented to the targeted segment with segment-local
+ * coordinates. Mirrors the box-vent placement flow.
+ */
+const TurbineVentTool = () => {
+    const activeBuildingId = useViewer((s) => s.selection.buildingId);
+    const setSelection = useViewer((s) => s.setSelection);
+    const [previewPos, setPreviewPos] = useState(null);
+    const [previewSurfaceQuat, setPreviewSurfaceQuat] = useState(null);
+    const [previewYaw, setPreviewYaw] = useState(0);
+    const [previewRotation, setPreviewRotation] = useState(0);
+    const lastSnapRef = useRef(null);
+    const previewNode = useMemo(() => TurbineVentNode.parse({
+        ...turbineVentDefinition.defaults(),
+        name: 'Turbine Vent',
+        position: [0, 0, 0],
+        rotation: previewRotation,
+    }), [previewRotation]);
+    useEffect(() => {
+        if (!activeBuildingId)
+            return;
+        const worldToBuildingLocal = (wx, wy, wz) => {
+            const buildingObj = sceneRegistry.nodes.get(activeBuildingId);
+            if (!buildingObj)
+                return [wx, wy, wz];
+            worldPoint.set(wx, wy, wz);
+            buildingObj.worldToLocal(worldPoint);
+            return [worldPoint.x, worldPoint.y, worldPoint.z];
+        };
+        const updatePreview = (event) => {
+            const wx = event.position[0];
+            const wy = event.position[1];
+            const wz = event.position[2];
+            const sx = Math.round(wx * 20) / 20;
+            const sz = Math.round(wz * 20) / 20;
+            const prev = lastSnapRef.current;
+            if (event.nativeEvent?.shiftKey !== true && (!prev || prev[0] !== sx || prev[1] !== sz)) {
+                triggerSFX('sfx:grid-snap');
+                lastSnapRef.current = [sx, sz];
+            }
+            const hit = resolveRoofSegmentHit(event.node, wx, wy, wz);
+            if (!hit)
+                return;
+            const normal = getAnalyticalNormal(hit.localX, hit.localZ, hit.segment);
+            setPreviewSurfaceQuat(surfaceQuatFromNormal(normal, new THREE.Quaternion()));
+            setPreviewYaw((event.node.rotation ?? 0) + (hit.segment.rotation ?? 0));
+            setPreviewRotation(getDownSlopeYaw(hit.localX, hit.localZ, hit.segment));
+            setPreviewPos(worldToBuildingLocal(wx, wy, wz));
+            publishRoofSurfacePlacementGuides({
+                roof: event.node,
+                segment: hit.segment,
+                center: [hit.localX, hit.localY, hit.localZ],
+                footprint: roofSurfaceFootprintFromNode({
+                    ...previewNode,
+                    rotation: getDownSlopeYaw(hit.localX, hit.localZ, hit.segment),
+                }),
+            });
+            event.stopPropagation();
+        };
+        const onClick = (event) => {
+            const hit = resolveRoofSegmentHit(event.node, event.position[0], event.position[1], event.position[2]);
+            if (!hit)
+                return;
+            const state = useScene.getState();
+            const vent = TurbineVentNode.parse({
+                ...turbineVentDefinition.defaults(),
+                name: 'Turbine Vent',
+                roofSegmentId: hit.segment.id,
+                position: [hit.localX, hit.localY, hit.localZ],
+                rotation: getDownSlopeYaw(hit.localX, hit.localZ, hit.segment),
+            });
+            state.createNode(vent, hit.segment.id);
+            state.dirtyNodes.add(hit.segment.id);
+            setSelection({ selectedIds: [vent.id] });
+            triggerSFX('sfx:item-place');
+            clearRoofSurfacePlacementGuides();
+            event.stopPropagation();
+        };
+        emitter.on('roof:move', updatePreview);
+        emitter.on('roof:enter', updatePreview);
+        emitter.on('roof:click', onClick);
+        return () => {
+            emitter.off('roof:move', updatePreview);
+            emitter.off('roof:enter', updatePreview);
+            emitter.off('roof:click', onClick);
+            clearRoofSurfacePlacementGuides();
+        };
+    }, [activeBuildingId, setSelection, previewNode]);
+    return (_jsxs(_Fragment, { children: [_jsx(RoofAttachmentFallbackPreview, { activeBuildingId: activeBuildingId, ghost: _jsx(TurbineVentPreview, { node: previewNode, invalid: true }), onInvalidTarget: () => {
+                    setPreviewPos(null);
+                    setPreviewSurfaceQuat(null);
+                    clearRoofSurfacePlacementGuides();
+                } }), activeBuildingId && previewPos && previewSurfaceQuat && (_jsx("group", { position: previewPos, children: _jsx("group", { "rotation-y": previewYaw, children: _jsx("group", { quaternion: previewSurfaceQuat, children: _jsx(TurbineVentPreview, { node: previewNode }) }) }) }))] }));
+};
+export default TurbineVentTool;

package/dist/wall/curve-tool.d.ts

@@ -0,0 +1,14 @@
+import { type WallNode } from '@pascal-app/core';
+/**
+ * Phase 5 Stage D — wall curve tool (kind-owned).
+ *
+ * 1:1 port of the legacy `CurveWallTool`. Same snap pipeline,
+ * history dance, activation grace. The wall variant uses
+ * `useScene.temporal.getState().pause()` / `.resume()` directly rather
+ * than the depth-counted `pauseSceneHistory` helpers — matches legacy.
+ */
+export declare const CurveWallTool: React.FC<{
+    node: WallNode;
+}>;
+export default CurveWallTool;
+//# sourceMappingURL=curve-tool.d.ts.map

package/dist/wall/curve-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"curve-tool.d.ts","sourceRoot":"","sources":["../../src/wall/curve-tool.tsx"],"names":[],"mappings":"AAEA,OAAO,EAUL,KAAK,QAAQ,EACd,MAAM,kBAAkB,CAAA;AAazB;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CA6ItD,CAAA;AAED,eAAe,aAAa,CAAA"}