@pascal-app/nodes 1.0.3 → 1.0.5

package/dist/stair/metal-guard.js

@@ -0,0 +1,79 @@
+/**
+ * One coherent metal guard laid out along a rail path, as oriented boxes — a
+ * fabricated steel guardrail in metres: a slim square post at each end (and
+ * every bay ≤ 4 ft between), welded to a flat baseplate that mounts it to the
+ * tread rather than embedding below it, a flat top rail and a bottom rail that
+ * follow the path with a fitting block closing every interior corner, and
+ * slender square balusters spanning the two rails. It shares the path sampling,
+ * corner finding and newel/picket stations in `guard-path.ts` with the baluster,
+ * deck post-and-rail, cable, boards and glass guards, so a straight flight, a
+ * chained L/U landing turn, a winder, a curved or spiral sweep and an integrated
+ * top landing all read as the same guard; only the sections, the surface-mounted
+ * feet and the slim infill differ. Pure data — no Three.js, no React.
+ *
+ * Unlike the wood guards, a steel post is not sunk into the structure: it stands
+ * on the nosing line on a baseplate, the mounting foot that grounds it. The
+ * infill is plumb slender bars spanning rail to rail, so nothing crosses the
+ * walking volume on a slope and every member meets another.
+ *
+ * `reach` runs the rails that far past the top vertex along the final slope to
+ * die into a post standing there; `topPost: false` then omits the top post.
+ * `postThrough` runs the posts past the top rail with a small cap of their own.
+ */
+import { buildGuardChassis, guardPickets, } from './guard-path.js';
+// Fabricated steel guardrail, in metres.
+const POST = 0.04; // a slim 1½ in square steel post
+const BASEPLATE_W = 0.1; // the welded foot plate that mounts the post…
+const BASEPLATE_T = 0.008; // …a thin flat plate sitting on the nosing line
+const TOP_RAIL_W = 0.05; // a flat 2 in top rail across the run
+const TOP_RAIL_T = 0.03;
+const BOTTOM_RAIL_W = 0.038; // a slimmer bottom rail across the run
+const BOTTOM_RAIL_T = 0.025;
+const BOTTOM_CLEAR = 0.08; // underside of the bottom rail over the nosing line
+const INFILL = 0.016; // a 5⁄8 in square baluster
+const INFILL_PITCH = 0.11; // on centre; clears under the 4 in sphere with the bar
+/** The widest clear gap left between balusters, in metres (0.1016 m = 4 in sphere). */
+const INFILL_MAX_GAP = 0.1016;
+const POST_ABOVE_RAIL = 0.0762; // a through-post stands this far above the top rail…
+const POST_CAP_T = 0.0254; // …under a 1 in cap of its own
+const POST_CAP_OVERHANG = 0.0381;
+/** The metal guard's two rails, bottom-to-top: a slim bottom rail held off the
+ * nosing line and a flat top rail with its top at the guard height. Shared with
+ * the flight connector so a bridge carries the same rails as the guards it joins. */
+export function metalGuardRails(railHeight) {
+    return [
+        { y: BOTTOM_CLEAR + BOTTOM_RAIL_T / 2, across: BOTTOM_RAIL_W, vertical: BOTTOM_RAIL_T },
+        { y: railHeight - TOP_RAIL_T / 2, across: TOP_RAIL_W, vertical: TOP_RAIL_T },
+    ];
+}
+/** The flat baseplate welded under a post foot, sitting on the nosing line. */
+function baseplate(x, footY, z) {
+    return {
+        center: [x, footY + BASEPLATE_T / 2, z],
+        size: [BASEPLATE_W, BASEPLATE_T, BASEPLATE_W],
+        direction: [0, 1, 0],
+    };
+}
+export function buildMetalGuard(points, options) {
+    const { railHeight } = options;
+    const chassis = buildGuardChassis(points, options, metalGuardRails(railHeight), {
+        width: POST,
+        embed: 0,
+        top: -TOP_RAIL_T,
+        throughTop: POST_ABOVE_RAIL,
+        capThickness: POST_CAP_T,
+        capOverhang: POST_CAP_OVERHANG,
+        foot: baseplate,
+    }, {
+        picketPitch: INFILL_PITCH,
+        picketMinPitch: INFILL + 0.02,
+        picketMaxPitch: INFILL_MAX_GAP + INFILL,
+    });
+    if (!chassis)
+        return [];
+    const { path, boxes } = chassis;
+    if (path.kind === 'pivot')
+        return boxes;
+    boxes.push(...guardPickets(path, INFILL, POST, BOTTOM_CLEAR + BOTTOM_RAIL_T, railHeight - TOP_RAIL_T));
+    return boxes;
+}

package/dist/stair/paint.d.ts

@@ -1,2 +1,34 @@
+import { type AnyNode, type PaintPreviewArgs, type PaintResolveArgs } from '@pascal-app/core';
 export declare const stairPaint: import("@pascal-app/core").PaintCapability;
+declare const segmentPaint: import("@pascal-app/core").PaintCapability;
+export declare const stairSegmentPaint: {
+    materialTarget?: import("@pascal-app/core").MaterialTarget;
+    roomScope?: boolean;
+    resolveRole: (args: PaintResolveArgs) => string | null;
+    roleLabel?: (node: AnyNode, role: string) => string | null;
+    buildPatch: (args: import("@pascal-app/core").PaintPatchArgs) => Partial<AnyNode>;
+    commit?: (args: import("@pascal-app/core").PaintPatchArgs) => void;
+    applyPreview: (args: PaintPreviewArgs) => (() => void) | null;
+    getEffectiveMaterial: (args: Parameters<NonNullable<typeof segmentPaint.getEffectiveMaterial>>[0]) => {
+        material: {
+            id?: string | undefined;
+            preset?: "brick" | "concrete" | "custom" | "glass" | "marble" | "metal" | "plaster" | "tile" | "white" | "wood" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "back" | "double" | "front";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        materialPreset: string | undefined;
+    } | null;
+};
+export {};
 //# sourceMappingURL=paint.d.ts.map

package/dist/stair/paint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paint.d.ts","sourceRoot":"","sources":["../../src/stair/paint.ts"],"names":[],"mappings":"AA+FA,eAAO,MAAM,UAAU,4CAIrB,CAAA"}
+{"version":3,"file":"paint.d.ts","sourceRoot":"","sources":["../../src/stair/paint.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EAGZ,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EAMtB,MAAM,kBAAkB,CAAA;AAwHzB,eAAO,MAAM,UAAU,4CAKrB,CAAA;AAEF,QAAA,MAAM,YAAY,4CAMhB,CAAA;AACF,eAAO,MAAM,iBAAiB;;;;;;;;iCAGpB,UAAU,CAAC,WAAW,CAAC,OAAO,YAAY,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;CAa7E,CAAA"}

package/dist/stair/paint.js

@@ -1,6 +1,8 @@
-import { buildSlotPreviewMaterial, createSlotPaintCapability } from '../shared/slot-paint';
+import { getEffectiveStairSurfaceMaterial, parseMaterialRef, } from '@pascal-app/core';
+import { buildSlotPreviewMaterial, createSlotPaintCapability, declaredSlotLook, } from '../shared/slot-paint.js';
+import { swapPreviewMaterial } from '../shared/swap-preview-material.js';
 function isStairSlotId(value) {
-    return value === 'treads' || value === 'body' || value === 'railing';
+    return value === 'treads' || value === 'body' || value === 'railing' || value === 'infill';
 }
 function resolveStairPaintRole(args) {
     const userData = args.hitObject?.userData;
@@ -15,9 +17,10 @@ function resolveStairPaintRole(args) {
 }
 function previewStairSlot(args) {
     const { role, root, material, materialPreset } = args;
+    const nodes = args.nodes ?? {};
     if (!isStairSlotId(role))
         return null;
-    const preview = buildSlotPreviewMaterial(material, materialPreset);
+    const preview = buildSlotPreviewMaterial(material, materialPreset, args.materials ?? {});
     if (!preview)
         return () => { };
     const restores = [];
@@ -27,27 +30,34 @@ function previewStairSlot(args) {
             return;
         const userData = mesh.userData;
         if (userData.slotId === role) {
-            const previous = mesh.material;
-            mesh.material = preview;
-            restores.push(() => {
-                mesh.material = previous;
-            });
+            restores.push(swapPreviewMaterial(mesh, preview));
             return;
         }
         if (!Array.isArray(userData.slotIds))
             return;
-        const materialIndex = userData.slotIds.indexOf(role);
-        if (materialIndex < 0)
+        if (!userData.slotIds.includes(role))
             return;
         if (!Array.isArray(mesh.material))
             return;
-        const previous = mesh.material;
-        const next = previous.slice();
-        next[materialIndex] = preview;
-        mesh.material = next;
-        restores.push(() => {
-            mesh.material = previous;
-        });
+        const next = mesh.material.slice();
+        let changed = false;
+        for (const [index, slotId] of userData.slotIds.entries()) {
+            if (slotId !== role)
+                continue;
+            const segmentId = userData.segmentIds?.[index];
+            const segment = segmentId ? nodes[segmentId] : undefined;
+            if (args.node.type === 'stair' &&
+                segment?.type === 'stair-segment' &&
+                (slotLook(segment, role, args.materials ?? {}) ||
+                    segment.material !== undefined ||
+                    typeof segment.materialPreset === 'string'))
+                continue;
+            next[index] = preview;
+            changed = true;
+        }
+        if (!changed)
+            return;
+        restores.push(swapPreviewMaterial(mesh, next));
     });
     if (restores.length === 0)
         return null;
@@ -56,31 +66,60 @@ function previewStairSlot(args) {
             restores[index]?.();
     };
 }
+function slotLook(node, role, materials) {
+    const parsed = parseMaterialRef(node.slots?.[role]);
+    if (!parsed)
+        return null;
+    if (parsed.kind === 'library')
+        return { material: undefined, materialPreset: `library:${parsed.id}` };
+    const entry = materials[parsed.id];
+    return entry ? { material: entry.material, materialPreset: undefined } : null;
+}
 function legacyEffective(node, role) {
-    if (!isStairSlotId(role))
+    if (!isStairSlotId(role) || role === 'infill')
         return null;
-    const stair = node;
-    const perSlot = role === 'treads'
-        ? { material: stair.treadMaterial, materialPreset: stair.treadMaterialPreset }
-        : role === 'body'
-            ? { material: stair.sideMaterial, materialPreset: stair.sideMaterialPreset }
-            : { material: stair.railingMaterial, materialPreset: stair.railingMaterialPreset };
-    if (perSlot.material !== undefined || typeof perSlot.materialPreset === 'string') {
-        return {
-            material: perSlot.material,
-            materialPreset: typeof perSlot.materialPreset === 'string' ? perSlot.materialPreset : undefined,
-        };
-    }
-    if (stair.material !== undefined || typeof stair.materialPreset === 'string') {
-        return {
-            material: stair.material,
-            materialPreset: typeof stair.materialPreset === 'string' ? stair.materialPreset : undefined,
-        };
+    if (node.type === 'stair-segment') {
+        return node.material !== undefined || typeof node.materialPreset === 'string'
+            ? { material: node.material, materialPreset: node.materialPreset }
+            : null;
     }
-    return null;
+    if (node.type !== 'stair')
+        return null;
+    const spec = getEffectiveStairSurfaceMaterial(node, role === 'treads' ? 'tread' : role === 'body' ? 'side' : 'railing');
+    return spec.material !== undefined || spec.materialPreset !== undefined
+        ? { material: spec.material, materialPreset: spec.materialPreset }
+        : null;
+}
+function segmentFallbackLook(segment, role, nodes, materials) {
+    const own = legacyEffective(segment, role);
+    if (own)
+        return own;
+    const parent = segment.parentId ? nodes[segment.parentId] : undefined;
+    return parent?.type === 'stair'
+        ? (slotLook(parent, role, materials) ??
+            legacyEffective(parent, role) ??
+            declaredSlotLook(parent, role))
+        : declaredSlotLook(segment, role);
 }
 export const stairPaint = createSlotPaintCapability({
     resolveRole: resolveStairPaintRole,
     applyPreview: previewStairSlot,
     legacyEffective,
+    erasedLook: ({ node, role }) => legacyEffective(node, role) ?? declaredSlotLook(node, role),
+});
+const segmentPaint = createSlotPaintCapability({
+    resolveRole: resolveStairPaintRole,
+    applyPreview: previewStairSlot,
+    legacyEffective,
+    erasedLook: ({ node, role, nodes, materials }) => segmentFallbackLook(node, role, nodes ?? {}, materials ?? {}),
 });
+export const stairSegmentPaint = {
+    ...segmentPaint,
+    getEffectiveMaterial: (args) => {
+        if (args.role !== 'treads' && args.role !== 'body')
+            return null;
+        const look = segmentPaint.getEffectiveMaterial?.(args) ??
+            segmentFallbackLook(args.node, args.role, args.nodes, args.materials ?? {});
+        return look ? { material: look.material, materialPreset: look.materialPreset } : null;
+    },
+};

package/dist/stair/panel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"panel.d.ts","sourceRoot":"","sources":["../../src/stair/panel.tsx"],"names":[],"mappings":"AAuEA,MAAM,CAAC,OAAO,UAAU,UAAU,uCAwjBjC"}
+{"version":3,"file":"panel.d.ts","sourceRoot":"","sources":["../../src/stair/panel.tsx"],"names":[],"mappings":"AA4FA,MAAM,CAAC,OAAO,UAAU,UAAU,uCAo4BjC"}

package/dist/stair/panel.js

@@ -1,19 +1,29 @@
 'use client';
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { getLevelDisplayName, resolveStairTotalRise, runAsSingleSceneHistoryStep, StairSegmentNode as StairSegmentNodeSchema, useScene, } from '@pascal-app/core';
-import { ActionButton, ActionGroup, duplicateStairSubtree, formatLinearMeasurement, getStairLevelOptions, MetricControl, PanelSection, PanelWrapper, resolveStairDestinationLevel, resolveStairFromLevelId, resolveStairToLevelId, SegmentedControl, SliderControl, ToggleControl, triggerSFX, useEditor, } from '@pascal-app/editor';
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { getBoundarySurfaces, getLevelDisplayName, measureStair, planStairPreset, planStairRiseEdit, planStairSizingEdit, proposeStairLayouts, resolveStairArcDimensions, resolveStairTotalRise, runAsSingleSceneHistoryStep, StairSegmentNode as StairSegmentNodeSchema, useRegistryVersion, useScene, } from '@pascal-app/core';
+import { ActionButton, ActionGroup, duplicateNodeAndPickUp, formatLinearMeasurement, getStairLevelOptions, MetricControl, PanelSection, PanelWrapper, resolveStairDestinationLevel, resolveStairFromLevelId, resolveStairToLevelId, SegmentedControl, SelectControl, SliderControl, ToggleControl, triggerSFX, useEditor, } from '@pascal-app/editor';
 import { useViewer } from '@pascal-app/viewer';
 import { Copy, Move, Plus, Trash2 } from 'lucide-react';
-import { useCallback, useMemo } from 'react';
+import { useCallback, useMemo, useState } from 'react';
 import { useShallow } from 'zustand/react/shallow';
-import { getStairDestinationUpdates } from './destination';
-import { getStairTypeChange } from './stair-type';
+import { StairConstructionControls } from './construction-controls.js';
+import { getStairDestinationUpdates } from './destination.js';
+import { StairRailingControls } from './railing-controls.js';
+import { getStairTypeChange } from './stair-type.js';
 const RAILING_MODE_OPTIONS = [
     { label: 'None', value: 'none' },
     { label: 'Left', value: 'left' },
     { label: 'Right', value: 'right' },
     { label: 'Both', value: 'both' },
 ];
+const RAILING_STYLE_OPTIONS = [
+    { label: 'Balusters', value: 'balusters' },
+    { label: 'Post & rail', value: 'post-and-rail' },
+    { label: 'Cable', value: 'cable' },
+    { label: 'Boards', value: 'boards' },
+    { label: 'Glass', value: 'glass' },
+    { label: 'Metal', value: 'metal' },
+];
 const STAIR_TYPE_OPTIONS = [
     { label: 'Straight', value: 'straight' },
     { label: 'Curved', value: 'curved' },
@@ -40,6 +50,14 @@ export default function StairPanel() {
     const createNode = useScene((s) => s.createNode);
     const setMovingNode = useEditor((s) => s.setMovingNode);
     const nodes = useScene((s) => s.nodes);
+    const [presetTurn, setPresetTurn] = useState('left');
+    const [turningStrategy, setTurningStrategy] = useState('landing');
+    const [innerGap, setInnerGap] = useState(0);
+    const [walkingLineOffset, setWalkingLineOffset] = useState(0.5);
+    const [division, setDivision] = useState('equal-going');
+    const [riseError, setRiseError] = useState(null);
+    const installedPlugins = useScene((s) => s.installedPlugins);
+    useRegistryVersion();
     const node = useScene((s) => selectedId ? s.nodes[selectedId] : undefined);
     const levels = useMemo(() => (node?.type === 'stair' ? getStairLevelOptions(nodes, node) : []), [node, nodes]);
     const candidateDecks = useMemo(() => {
@@ -72,7 +90,24 @@ export default function StairPanel() {
     const handleUpdate = useCallback((updates) => {
         if (!selectedId)
             return;
-        updateNode(selectedId, updates);
+        const scene = useScene.getState();
+        const current = scene.nodes[selectedId];
+        if (current?.type === 'stair' && typeof updates.totalRise === 'number') {
+            try {
+                const changes = planStairRiseEdit(current, updates.totalRise, scene.nodes);
+                changes[0].data = updates;
+                scene.updateNodes(changes);
+                setRiseError(null);
+            }
+            catch (error) {
+                if (!(error instanceof RangeError))
+                    throw error;
+                setRiseError({ id: current.id, message: error.message });
+            }
+        }
+        else {
+            updateNode(selectedId, updates);
+        }
     }, [selectedId, updateNode]);
     const handleClose = useCallback(() => {
         setSelection({ selectedIds: [] });
@@ -174,15 +209,8 @@ export default function StairPanel() {
         setSelection({ selectedIds: [segmentId] });
     }, [setSelection]);
     const handleDuplicate = useCallback(() => {
-        if (!node)
-            return;
-        triggerSFX('sfx:item-pick');
-        try {
-            duplicateStairSubtree(node.id, { mode: 'move' });
-        }
-        catch (e) {
-            console.error('Failed to duplicate stair', e);
-        }
+        if (node)
+            duplicateNodeAndPickUp(node);
     }, [node]);
     const handleMove = useCallback(() => {
         if (node) {
@@ -209,10 +237,130 @@ export default function StairPanel() {
     const deckNode = node.deckSlabId ? nodes[node.deckSlabId] : undefined;
     const attachedDeck = deckNode?.type === 'slab' ? deckNode : undefined;
     const resolvedRise = resolveStairTotalRise(node, nodes);
-    return (_jsxs(PanelWrapper, { icon: "/icons/stairs.webp", onClose: handleClose, title: node.name || 'Staircase', width: 300, children: [_jsx(PanelSection, { title: "Type", children: _jsx(SegmentedControl, { onChange: handleStairTypeChange, options: STAIR_TYPE_OPTIONS, value: node.stairType ?? 'straight' }) }), _jsx(PanelSection, { title: "Opening", children: _jsxs("div", { className: "space-y-3", children: [attachedDeck ? null : (_jsx(ToggleControl, { checked: (node.slabOpeningMode ?? 'none') === 'destination', label: "Auto Cutout", onChange: handleAutoCutoutChange })), _jsxs("div", { className: "space-y-1.5", children: [_jsx("div", { className: "px-1 text-[11px] text-muted-foreground uppercase tracking-[0.14em]", children: "From Level" }), _jsx("select", { className: "h-9 w-full rounded-lg border border-border/50 bg-[#2C2C2E] px-3 text-foreground text-sm", onChange: (event) => handleFromLevelChange(event.target.value), value: resolvedFromLevelId ?? '', children: levels.map((level) => (_jsx("option", { value: level.id, children: getLevelDisplayName(level) }, level.id))) })] }), _jsxs("div", { className: "space-y-1.5", children: [_jsx("div", { className: "px-1 text-[11px] text-muted-foreground uppercase tracking-[0.14em]", children: "To" }), _jsxs("select", { className: "h-9 w-full rounded-lg border border-border/50 bg-[#2C2C2E] px-3 text-foreground text-sm", onChange: (event) => handleDestinationChange(event.target.value), value: attachedDeck ? attachedDeck.id : (resolvedToLevelId ?? ''), children: [levels.map((level) => (_jsx("option", { value: level.id, children: getLevelDisplayName(level) }, level.id))), candidateDecks.map((deck) => (_jsx("option", { value: deck.id, children: deck.name || 'Deck' }, deck.id)))] })] }), _jsxs("div", { className: "space-y-1.5", children: [_jsx("div", { className: "px-1 text-[11px] text-muted-foreground uppercase tracking-[0.14em]", children: "Rise" }), _jsx(SegmentedControl, { onChange: (value) => handleUpdate(value === 'custom' ? { totalRise: resolvedRise } : { totalRise: undefined }), options: [
+    const measurements = measureStair(node, nodes);
+    const applySizing = (fitRun) => {
+        const scene = useScene.getState();
+        const current = scene.nodes[node.id];
+        if (current?.type !== 'stair')
+            return;
+        try {
+            scene.updateNodes(planStairSizingEdit(current, scene.nodes, fitRun));
+            setRiseError(null);
+        }
+        catch (error) {
+            if (!(error instanceof RangeError))
+                throw error;
+            setRiseError({ id: current.id, message: error.message });
+        }
+    };
+    const layoutOptions = proposeStairLayouts(node, nodes)
+        .filter((option) => option.layout === 'straight' || option.turn === presetTurn)
+        .map((option) => {
+        try {
+            return {
+                ...option,
+                footprint: planStairPreset(node, nodes, {
+                    layout: option.layout,
+                    turn: presetTurn,
+                    turningStrategy,
+                    innerGap,
+                    walkingLineOffset,
+                    division,
+                }).footprint,
+            };
+        }
+        catch (error) {
+            if (!(error instanceof RangeError))
+                throw error;
+            return { ...option, footprint: null };
+        }
+    });
+    const applyPreset = (layout) => {
+        const scene = useScene.getState();
+        const current = scene.nodes[node.id];
+        if (current?.type !== 'stair')
+            return;
+        try {
+            const plan = planStairPreset(current, scene.nodes, {
+                layout,
+                turn: presetTurn,
+                turningStrategy,
+                innerGap,
+                walkingLineOffset,
+                division,
+            });
+            runAsSingleSceneHistoryStep(useScene, () => {
+                scene.deleteNodes(plan.removeIds);
+                for (const segment of plan.segments) {
+                    if (scene.nodes[segment.id])
+                        scene.updateNode(segment.id, segment);
+                    else
+                        scene.createNode(segment, current.id);
+                }
+                scene.updateNode(current.id, plan.stair);
+            });
+            setRiseError(null);
+        }
+        catch (error) {
+            if (!(error instanceof RangeError))
+                throw error;
+            setRiseError({ id: current.id, message: error.message });
+        }
+    };
+    const minimumRise = Math.max(0.001, (node.stairType === 'straight'
+        ? segments
+            .filter((segment) => segment.segmentType === 'landing')
+            .reduce((sum, segment) => sum + segment.height, 0)
+        : 0) + 0.001);
+    const surfaceLevelId = node.destinationSurfaceId && node.parentId === node.destinationSurfaceId
+        ? nodes[node.parentId]?.parentId
+        : node.parentId;
+    const boundarySurfaces = getBoundarySurfaces(nodes, surfaceLevelId, installedPlugins);
+    const connectedSurface = node.destinationSurfaceId
+        ? nodes[node.destinationSurfaceId]
+        : undefined;
+    return (_jsxs(PanelWrapper, { icon: "/icons/stairs.webp", onClose: handleClose, title: node.name || 'Staircase', width: 300, children: [_jsx(PanelSection, { title: "Type", children: _jsx(SegmentedControl, { onChange: handleStairTypeChange, options: STAIR_TYPE_OPTIONS, value: node.stairType ?? 'straight' }) }), _jsxs(PanelSection, { title: "Layout", children: [_jsx(SegmentedControl, { value: presetTurn, onChange: setPresetTurn, options: [
+                            { label: 'Left turn', value: 'left' },
+                            { label: 'Right turn', value: 'right' },
+                        ] }), _jsx(SegmentedControl, { value: turningStrategy, onChange: setTurningStrategy, options: [
+                            { label: 'Landing', value: 'landing' },
+                            { label: 'Winder', value: 'winder' },
+                        ] }), turningStrategy === 'winder' && (_jsxs(_Fragment, { children: [_jsx(MetricControl, { label: "Inner gap", unit: "m", min: 0, step: 0.05, precision: 2, value: innerGap, onChange: setInnerGap }), _jsx(MetricControl, { label: "Walking line offset", unit: "m", min: 0.001, step: 0.05, precision: 2, value: walkingLineOffset, onChange: setWalkingLineOffset }), _jsx(SegmentedControl, { value: division, onChange: setDivision, options: [
+                                    { label: 'Equal going', value: 'equal-going' },
+                                    { label: 'Equal angle', value: 'equal-angle' },
+                                ] })] })), _jsx("div", { className: "grid grid-cols-3 gap-2", children: layoutOptions.map((option) => {
+                            const label = option.layout === 'straight' ? 'Straight' : `${option.layout.toUpperCase()} turn`;
+                            return (_jsxs("button", { type: "button", "aria-label": `Apply ${label} layout`, disabled: !option.footprint, onClick: () => applyPreset(option.layout), className: "flex min-h-24 flex-col items-center justify-center gap-2 rounded-lg border border-border/60 bg-muted/30 px-1 py-3 text-foreground transition-colors hover:border-foreground/40 hover:bg-muted/60 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:cursor-not-allowed disabled:opacity-40", children: [_jsx("svg", { "aria-hidden": "true", width: "32", height: "32", viewBox: "0 0 32 32", fill: "none", children: _jsx("path", { d: option.layout === 'straight'
+                                                ? 'M16 27V5'
+                                                : option.layout === 'l'
+                                                    ? 'M7 27V7H27'
+                                                    : 'M7 27V7H25V27', stroke: "currentColor", strokeWidth: "6", strokeLinecap: "square", strokeLinejoin: "miter", transform: presetTurn === 'right' ? 'translate(32 0) scale(-1 1)' : undefined }) }), _jsx("span", { className: "text-xs font-medium", children: label }), _jsx("span", { className: "text-center text-[11px] leading-tight text-muted-foreground", children: option.footprint
+                                            ? `${formatLinearMeasurement(option.footprint.width, unit, metricNotation)} × ${formatLinearMeasurement(option.footprint.length, unit, metricNotation)}`
+                                            : 'Unavailable' })] }, option.layout));
+                        }) })] }), _jsxs(PanelSection, { title: "Sizing", children: [_jsxs("details", { className: "px-1 text-xs", children: [_jsx("summary", { className: "cursor-pointer py-2 text-muted-foreground", children: "Measurements" }), _jsxs("div", { className: "space-y-2 px-1 text-xs", children: [measurements.flights.map((flight, index) => (_jsxs("div", { children: ["Flight ", index + 1, ": ", flight.count, " risers \u00B7 R", ' ', flight.riserHeight === null
+                                                ? '—'
+                                                : formatLinearMeasurement(flight.riserHeight, unit, metricNotation), ' ', "\u00B7 T", ' ', flight.going === null
+                                                ? '—'
+                                                : formatLinearMeasurement(flight.going, unit, metricNotation), ' ', "\u00B7 ", flight.slope === null ? '—' : `${((flight.slope * 180) / Math.PI).toFixed(1)}°`] }, flight.nodeId))), _jsxs("div", { children: ["Headroom:", ' ', measurements.headroom.status === 'unresolved'
+                                                ? 'Not evaluated'
+                                                : measurements.headroom.minimum === null
+                                                    ? 'No overhead surface'
+                                                    : formatLinearMeasurement(measurements.headroom.minimum, unit, metricNotation)] }), _jsx("div", { className: "text-muted-foreground", children: "Floors, ceilings and stairs only." })] })] }), [...new Set(measurements.diagnostics.map((diagnostic) => diagnostic.message))].map((message) => (_jsx("div", { role: "status", className: "rounded-lg bg-muted/40 px-3 py-2 text-xs text-muted-foreground", children: message }, message))), _jsxs("details", { className: "space-y-3", children: [_jsx("summary", { className: "cursor-pointer px-1 py-2 text-xs text-muted-foreground", children: "Design targets" }), _jsx(MetricControl, { label: "Target max riser", unit: "m", precision: 3, step: 0.005, min: 0.001, value: measurements.targets.maxRiserHeight, onChange: (value) => handleUpdate({ designTargets: { ...measurements.targets, maxRiserHeight: value } }) }), _jsx(MetricControl, { label: "Target minimum going", unit: "m", precision: 3, step: 0.01, min: 0.001, value: measurements.targets.minimumGoing, onChange: (value) => handleUpdate({ designTargets: { ...measurements.targets, minimumGoing: value } }) }), _jsx(MetricControl, { label: "Target going", unit: "m", precision: 3, step: 0.01, min: 0.001, value: measurements.targets.targetGoing, onChange: (value) => handleUpdate({ designTargets: { ...measurements.targets, targetGoing: value } }) }), _jsx(MetricControl, { label: "Target headroom", unit: "m", precision: 2, step: 0.05, min: 0.001, value: measurements.targets.minimumHeadroom, onChange: (value) => handleUpdate({ designTargets: { ...measurements.targets, minimumHeadroom: value } }) })] }), _jsx(ActionButton, { className: "flex-none", label: "Fit uniform risers", onClick: () => applySizing(false) }), _jsx(ActionButton, { className: "flex-none", label: "Fit risers and going", onClick: () => applySizing(true) })] }), node.stairType === 'straight' &&
+                (boundarySurfaces.length > 0 || node.destinationSurfaceId) && (_jsx(PanelSection, { title: "Surface connection", children: _jsxs("div", { className: "space-y-2", children: [_jsx(ToggleControl, { checked: node.autoSurfaceSnap !== false, label: "Snap to nearby surfaces", onChange: (checked) => handleUpdate({ autoSurfaceSnap: checked }) }), _jsx("p", { className: "px-1 text-[11px] text-muted-foreground", children: node.autoSurfaceSnap !== false
+                                ? connectedSurface
+                                    ? `Connected to ${connectedSurface.name || 'surface'}. Move the stair to connect to another edge.`
+                                    : 'Drag near a deck, patio, concrete slab, or landing edge to fit the stair.'
+                                : 'Moving this stair keeps its current rise, steps, and run.' })] }) })), _jsx(PanelSection, { title: "Opening", children: _jsxs("div", { className: "space-y-3", children: [attachedDeck ? null : (_jsx(ToggleControl, { checked: (node.slabOpeningMode ?? 'none') === 'destination', label: "Auto Cutout", onChange: handleAutoCutoutChange })), _jsxs("div", { className: "space-y-1.5", children: [_jsx("div", { className: "px-1 text-[11px] text-muted-foreground uppercase tracking-[0.14em]", children: "From Level" }), _jsx("select", { className: "h-9 w-full rounded-lg border border-border/50 bg-black/4 dark:bg-[#2C2C2E] px-3 text-foreground text-sm", onChange: (event) => handleFromLevelChange(event.target.value), value: resolvedFromLevelId ?? '', children: levels.map((level) => (_jsx("option", { value: level.id, children: getLevelDisplayName(level) }, level.id))) })] }), _jsxs("div", { className: "space-y-1.5", children: [_jsx("div", { className: "px-1 text-[11px] text-muted-foreground uppercase tracking-[0.14em]", children: "To" }), _jsxs("select", { className: "h-9 w-full rounded-lg border border-border/50 bg-black/4 dark:bg-[#2C2C2E] px-3 text-foreground text-sm", onChange: (event) => handleDestinationChange(event.target.value), value: attachedDeck ? attachedDeck.id : (resolvedToLevelId ?? ''), children: [levels.map((level) => (_jsx("option", { value: level.id, children: getLevelDisplayName(level) }, level.id))), candidateDecks.map((deck) => (_jsx("option", { value: deck.id, children: deck.name || 'Deck' }, deck.id)))] })] }), _jsxs("div", { className: "space-y-1.5", children: [_jsx("div", { className: "px-1 text-[11px] text-muted-foreground uppercase tracking-[0.14em]", children: "Rise" }), _jsx(SegmentedControl, { onChange: (value) => handleUpdate(value === 'custom' ? { totalRise: resolvedRise } : { totalRise: undefined }), options: [
                                         { label: attachedDeck ? 'Follows deck' : 'Follows level', value: 'follows' },
                                         { label: 'Custom rise', value: 'custom' },
-                                    ], value: node.totalRise == null ? 'follows' : 'custom' }), node.totalRise == null ? (_jsxs("div", { className: "px-1 text-[11px] text-muted-foreground", children: ["Currently ", formatLinearMeasurement(resolvedRise, unit, metricNotation)] })) : (_jsx(MetricControl, { label: "Rise", max: 1000, min: 0.2, onChange: (value) => handleUpdate({ totalRise: value }), precision: 2, step: 0.05, unit: "m", value: resolvedRise }))] }), attachedDeck ? null : (_jsxs(_Fragment, { children: [_jsx(SegmentedControl, { onChange: (value) => handleAutoCutoutChange(value === 'destination'), options: STAIR_SLAB_OPENING_OPTIONS, value: node.slabOpeningMode ?? 'none' }), (node.slabOpeningMode ?? 'none') === 'destination' ? (_jsx(MetricControl, { label: "Opening Offset", max: 0.5, min: 0, onChange: (value) => handleUpdate({ openingOffset: value }), precision: 2, step: 0.01, unit: "m", value: node.openingOffset ?? 0 })) : null] })), node.stairType === 'spiral' && (_jsxs(_Fragment, { children: [_jsxs("div", { className: "space-y-1.5", children: [_jsx("div", { className: "px-1 text-[11px] text-muted-foreground uppercase tracking-[0.14em]", children: "Landing" }), _jsx(SegmentedControl, { onChange: (value) => handleUpdate({ topLandingMode: value }), options: TOP_LANDING_MODE_OPTIONS, value: node.topLandingMode ?? 'none' })] }), (node.topLandingMode ?? 'none') === 'integrated' && (_jsx(MetricControl, { label: "Top Landing", max: 5, min: 0.3, onChange: (value) => handleUpdate({ topLandingDepth: value }), precision: 2, step: 0.05, unit: "m", value: node.topLandingDepth ?? 0.9 }))] }))] }) }), node.stairType === 'straight' && (_jsxs(PanelSection, { title: "Segments", children: [_jsx("div", { className: "flex flex-col gap-1", children: segments.map((seg, i) => (_jsxs("button", { className: "flex items-center justify-between rounded-lg border border-border/50 bg-[#2C2C2E] px-3 py-2 text-foreground text-sm transition-colors hover:bg-[#3e3e3e]", onClick: () => handleSelectSegment(seg.id), type: "button", children: [_jsx("span", { className: "truncate", children: seg.name || `Segment ${i + 1}` }), _jsx("span", { className: "text-muted-foreground text-xs capitalize", children: seg.segmentType })] }, seg.id))) }), _jsxs("div", { className: "flex gap-1.5", children: [_jsx(ActionButton, { icon: _jsx(Plus, { className: "h-3.5 w-3.5" }), label: "Add flight", onClick: handleAddFlight }), _jsx(ActionButton, { icon: _jsx(Plus, { className: "h-3.5 w-3.5" }), label: "Add landing", onClick: handleAddLanding })] })] })), (node.stairType === 'curved' || node.stairType === 'spiral') && (_jsxs(PanelSection, { title: "Geometry", children: [_jsx(MetricControl, { label: "Width", max: 10, min: 0.4, onChange: (value) => handleUpdate({ width: value }), precision: 2, step: 0.05, unit: "m", value: node.width ?? 1 }), _jsx(MetricControl, { label: "Steps", max: 32, min: 2, onChange: (value) => handleUpdate({ stepCount: Math.max(2, Math.round(value)) }), precision: 0, step: 1, unit: "", value: Math.max(2, Math.round(node.stepCount ?? 10)) }), node.stairType !== 'spiral' && (_jsx(ToggleControl, { checked: node.fillToFloor ?? true, label: "Fit To Floor", onChange: (checked) => handleUpdate({ fillToFloor: checked }) })), (node.stairType === 'spiral' || !(node.fillToFloor ?? true)) && (_jsx(MetricControl, { label: "Thickness", max: 1, min: 0.02, onChange: (value) => handleUpdate({ thickness: value }), precision: 2, step: 0.01, unit: "m", value: node.thickness ?? 0.25 })), _jsx(MetricControl, { label: "Inner Radius", max: 10, min: node.stairType === 'spiral' ? 0.05 : 0.2, onChange: (value) => handleUpdate({ innerRadius: value }), precision: 2, step: 0.05, unit: "m", value: node.innerRadius ?? 0.9 }), _jsx(SliderControl, { label: "Sweep", max: node.stairType === 'spiral' ? 720 : 270, min: node.stairType === 'spiral' ? -720 : -270, onChange: (degrees) => handleUpdate({ sweepAngle: (degrees * Math.PI) / 180 }), precision: 0, step: 1, unit: "\u00B0", value: Math.round(((node.sweepAngle ?? Math.PI / 2) * 180) / Math.PI) }), node.stairType === 'spiral' && (_jsxs(_Fragment, { children: [_jsx(ToggleControl, { checked: node.showCenterColumn ?? true, label: "Center Column", onChange: (checked) => handleUpdate({ showCenterColumn: checked }) }), _jsx(ToggleControl, { checked: node.showStepSupports ?? true, label: "Step Supports", onChange: (checked) => handleUpdate({ showStepSupports: checked }) })] }))] })), _jsxs(PanelSection, { title: "Position", children: [_jsx(SliderControl, { label: "X", onChange: (v) => {
+                                    ], value: node.totalRise == null ? 'follows' : 'custom' }), node.totalRise == null ? (_jsxs("div", { className: "px-1 text-[11px] text-muted-foreground", children: ["Currently ", formatLinearMeasurement(resolvedRise, unit, metricNotation)] })) : (_jsx(MetricControl, { label: "Rise", min: minimumRise, onChange: (value) => handleUpdate({ totalRise: value }), precision: 2, step: 0.05, unit: "m", value: resolvedRise }))] }), riseError?.id === node.id ? (_jsx("div", { role: "alert", className: "text-destructive text-xs", children: riseError.message })) : null, attachedDeck ? null : (_jsxs(_Fragment, { children: [_jsx(SegmentedControl, { onChange: (value) => handleAutoCutoutChange(value === 'destination'), options: STAIR_SLAB_OPENING_OPTIONS, value: node.slabOpeningMode ?? 'none' }), (node.slabOpeningMode ?? 'none') === 'destination' ? (_jsx(MetricControl, { label: "Opening Offset", min: 0, onChange: (value) => handleUpdate({ openingOffset: value }), precision: 2, step: 0.01, unit: "m", value: node.openingOffset ?? 0 })) : null] })), node.stairType === 'spiral' && (_jsxs(_Fragment, { children: [_jsxs("div", { className: "space-y-1.5", children: [_jsx("div", { className: "px-1 text-[11px] text-muted-foreground uppercase tracking-[0.14em]", children: "Landing" }), _jsx(SegmentedControl, { onChange: (value) => handleUpdate({ topLandingMode: value }), options: TOP_LANDING_MODE_OPTIONS, value: node.topLandingMode ?? 'none' })] }), (node.topLandingMode ?? 'none') === 'integrated' && (_jsx(MetricControl, { label: "Top Landing", max: Math.PI * 2 * resolveStairArcDimensions(node, resolvedRise).walkingRadius, min: 0.001, onChange: (value) => handleUpdate({ topLandingDepth: value }), precision: 2, step: 0.05, unit: "m", value: node.topLandingDepth ?? 0.9 }))] }))] }) }), node.stairType === 'straight' && (_jsxs(PanelSection, { title: "Segments", children: [_jsx("div", { className: "flex flex-col gap-1", children: segments.map((seg, i) => (_jsxs("button", { className: "flex items-center justify-between rounded-lg border border-border/50 bg-black/4 dark:bg-[#2C2C2E] px-3 py-2 text-foreground text-sm transition-colors hover:bg-black/8 dark:hover:bg-[#3e3e3e]", onClick: () => handleSelectSegment(seg.id), type: "button", children: [_jsx("span", { className: "truncate", children: seg.name || `Segment ${i + 1}` }), _jsx("span", { className: "text-muted-foreground text-xs capitalize", children: seg.segmentType })] }, seg.id))) }), _jsxs("div", { className: "flex gap-1.5", children: [_jsx(ActionButton, { icon: _jsx(Plus, { className: "h-3.5 w-3.5" }), label: "Add flight", onClick: handleAddFlight }), _jsx(ActionButton, { icon: _jsx(Plus, { className: "h-3.5 w-3.5" }), label: "Add landing", onClick: handleAddLanding })] })] })), (node.stairType === 'curved' || node.stairType === 'spiral') && (_jsxs(PanelSection, { title: "Geometry", children: [_jsx(MetricControl, { label: "Width", min: 0.001, onChange: (value) => handleUpdate({ width: value }), precision: 2, step: 0.05, unit: "m", value: node.width ?? 1 }), _jsx(MetricControl, { label: "Steps", min: 2, onChange: (value) => handleUpdate({ stepCount: Math.max(2, Math.round(value)) }), precision: 0, step: 1, unit: "", value: Math.max(2, Math.round(node.stepCount ?? 10)) }), node.stairType !== 'spiral' && (_jsx(ToggleControl, { checked: node.fillToFloor ?? true, label: "Fit To Floor", onChange: (checked) => handleUpdate({ fillToFloor: checked }) })), (node.stairType === 'spiral' || !(node.fillToFloor ?? true)) && (_jsx(MetricControl, { label: "Thickness", min: 0.001, onChange: (value) => handleUpdate({ thickness: value }), precision: 2, step: 0.01, unit: "m", value: node.thickness ?? 0.25 })), _jsx(MetricControl, { label: "Inner Radius", min: 0.001, onChange: (value) => handleUpdate({ innerRadius: value }), precision: 2, step: 0.05, unit: "m", value: node.innerRadius ?? 0.9 }), _jsx(SegmentedControl, { value: node.sweepAngle < 0 ? 'negative' : 'positive', onChange: (value) => handleUpdate({
+                            sweepAngle: Math.abs(node.sweepAngle) * (value === 'negative' ? -1 : 1),
+                        }), options: [
+                            { label: 'Clockwise', value: 'positive' },
+                            { label: 'Counterclockwise', value: 'negative' },
+                        ] }), _jsx(SliderControl, { label: "Sweep", min: 0.01, onChange: (degrees) => handleUpdate({
+                            sweepAngle: (Math.sign(node.sweepAngle || 1) * (degrees * Math.PI)) / 180,
+                        }), precision: 0, step: 1, unit: "\u00B0", value: Math.round((Math.abs(node.sweepAngle ?? Math.PI / 2) * 180) / Math.PI) }), node.stairType === 'spiral' && (_jsxs(_Fragment, { children: [_jsx(ToggleControl, { checked: node.showCenterColumn ?? true, label: "Center Column", onChange: (checked) => handleUpdate({ showCenterColumn: checked }) }), _jsx(ToggleControl, { checked: node.showStepSupports ?? true, label: "Step Supports", onChange: (checked) => handleUpdate({ showStepSupports: checked }) })] }))] })), _jsx(PanelSection, { title: "Construction", children: _jsx(StairConstructionControls, { node: node, onChange: (construction) => handleUpdate({ construction }) }) }), _jsxs(PanelSection, { title: "Position", children: [_jsx(SliderControl, { label: "X", onChange: (v) => {
                             const pos = [...node.position];
                             pos[0] = v;
                             handleUpdate({ position: pos });
@@ -232,5 +380,8 @@ export default function StairPanel() {
                                 } }), _jsx(ActionButton, { label: "+45\u00B0", onClick: () => {
                                     triggerSFX('sfx:item-rotate');
                                     handleUpdate({ rotation: node.rotation + Math.PI / 4 });
-                                } })] })] }), _jsxs(PanelSection, { title: "Railing", children: [_jsx(SegmentedControl, { onChange: (value) => handleUpdate({ railingMode: value }), options: RAILING_MODE_OPTIONS, value: node.railingMode ?? 'none' }), (node.railingMode ?? 'none') !== 'none' && (_jsx(SliderControl, { label: "Height", max: 1.4, min: 0.7, onChange: (value) => handleUpdate({ railingHeight: value }), precision: 2, step: 0.02, unit: "m", value: node.railingHeight ?? 0.92 }))] }), _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 })] }) })] }));
+                                } })] })] }), _jsxs(PanelSection, { title: "Railing", children: [_jsx(StairRailingControls, { node: node, onChange: handleUpdate }), _jsx(SegmentedControl, { onChange: (value) => handleUpdate({ railingMode: value }), options: RAILING_MODE_OPTIONS, value: node.railingMode ?? 'none' }), (node.railingMode ?? 'none') !== 'none' && (_jsxs(_Fragment, { children: [_jsx(SelectControl, { label: "Style", onChange: (value) => handleUpdate({
+                                    railingStyle: value,
+                                    ...(value === 'glass' || value === 'metal' ? { railingPath: 'continuous' } : {}),
+                                }), options: RAILING_STYLE_OPTIONS, value: node.railingStyle ?? 'balusters' }), _jsx(SliderControl, { label: "Height", min: 0.001, onChange: (value) => handleUpdate({ railingHeight: value }), precision: 2, step: 0.02, unit: "m", value: node.railingHeight ?? 0.92 })] }))] }), _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-600 dark:text-red-400" }), label: "Delete", onClick: handleDelete })] }) })] }));
 }

package/dist/stair/parametrics.d.ts

@@ -1,3 +1,3 @@
-import type { ParametricDescriptor, StairNode } from '@pascal-app/core';
+import { type ParametricDescriptor, type StairNode } from '@pascal-app/core';
 export declare const stairParametrics: ParametricDescriptor<StairNode>;
 //# sourceMappingURL=parametrics.d.ts.map

package/dist/stair/parametrics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parametrics.d.ts","sourceRoot":"","sources":["../../src/stair/parametrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAEvE,eAAO,MAAM,gBAAgB,EAAE,oBAAoB,CAAC,SAAS,CAuK5D,CAAA"}
+{"version":3,"file":"parametrics.d.ts","sourceRoot":"","sources":["../../src/stair/parametrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,oBAAoB,EAAqB,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAI/F,eAAO,MAAM,gBAAgB,EAAE,oBAAoB,CAAC,SAAS,CAsL5D,CAAA"}