@pascal-app/nodes 1.0.6 → 1.1.0

package/dist/column/definition.edit.js

@@ -0,0 +1,323 @@
+import { withHostedChildren } from '../shared/hosted-resize.js';
+import { rebuildScriptedSize } from '../shared/scripted-opening-handles.js';
+import { columnFootprintHalf } from './bounds.js';
+import { columnEditPatch, isManagedColumn } from './edit-policy.js';
+import { buildColumnFloorplan, computeColumnFloorplanLevelData } from './floorplan.js';
+import { columnResizeAffordance, columnRotateAffordance } from './floorplan-affordances.js';
+import { columnFloorplanMoveTarget } from './floorplan-move.js';
+import { columnHostedPolicy } from './hosted-resize.js';
+import { columnPaint } from './paint.js';
+import { columnParametrics } from './parametrics.js';
+import { columnPlaceOption, postBaseOption } from './post-options.js';
+const ROUND_CROSS_SECTIONS = new Set([
+    'round',
+    'octagonal',
+    'sixteen-sided',
+]);
+// Limits + offsets shared with the in-world arrows. Mirrors the floors
+// the renderer clamps to (`Math.max(0.2, node.height)` etc.) so a drag
+// can't push values past what the renderer will accept.
+const SIDE_HANDLE_OFFSET = 0.18;
+const HEIGHT_HANDLE_OFFSET = 0.22;
+const BRACE_HANDLE_OFFSET = 0.3;
+const SPREAD_HANDLE_OFFSET = 0.22;
+const ROTATE_CORNER_OFFSET = 0.32;
+const ROTATE_RING_OFFSET = 0.04;
+const MOVE_FRONT_OFFSET = 0.35;
+const MIN_COLUMN_HEIGHT = 0.2;
+const MIN_COLUMN_WIDTH = 0.1;
+const MIN_COLUMN_DEPTH = 0.1;
+const MIN_COLUMN_RADIUS = 0.05;
+const MIN_BRACE_DIMENSION = 0.04;
+const MIN_BRACE_BOTTOM_SPREAD = 0.2;
+const MIN_BRACE_TOP_SPREAD = 0;
+function columnHeightHandle() {
+    return {
+        kind: 'linear-resize',
+        axis: 'y',
+        anchor: 'min',
+        min: MIN_COLUMN_HEIGHT,
+        currentValue: (n) => n.height,
+        apply: (_n, newValue) => ({ height: newValue }),
+        placement: {
+            position: (n) => [0, n.height + HEIGHT_HANDLE_OFFSET, 0],
+        },
+    };
+}
+function columnRadiusHandle() {
+    return {
+        kind: 'radial-resize',
+        axis: 'x',
+        min: MIN_COLUMN_RADIUS,
+        currentValue: (n) => n.radius,
+        apply: (n, newValue) => columnEditPatch(n, { radius: newValue }),
+        placement: {
+            position: (n) => [n.radius + SIDE_HANDLE_OFFSET, n.height / 2, 0],
+        },
+        // Guide ring traces the column's footprint at mid-height while the
+        // user is hovering or dragging the radius arrow — clarifies which
+        // edge the drag controls on round / octagonal / sixteen-sided shafts.
+        decoration: {
+            kind: 'ring',
+            radius: (n) => n.radius + SIDE_HANDLE_OFFSET * 0.5,
+            y: (n) => n.height / 2,
+        },
+    };
+}
+function columnAxisHandle(axis) {
+    return {
+        kind: 'linear-resize',
+        axis,
+        anchor: 'center',
+        min: axis === 'x' ? MIN_COLUMN_WIDTH : MIN_COLUMN_DEPTH,
+        currentValue: (n) => (axis === 'x' ? n.width : n.depth),
+        apply: (n, newValue) => columnEditPatch(n, axis === 'x' ? { width: newValue } : { depth: newValue }),
+        placement: {
+            position: (n) => {
+                const half = axis === 'x' ? n.width / 2 : n.depth / 2;
+                return axis === 'x'
+                    ? [half + SIDE_HANDLE_OFFSET, n.height / 2, 0]
+                    : [0, n.height / 2, half + SIDE_HANDLE_OFFSET];
+            },
+        },
+    };
+}
+function columnUniformHandle() {
+    // Square columns keep width === depth. We anchor the arrow on the +X
+    // side and write BOTH fields from the same delta.
+    return {
+        kind: 'linear-resize',
+        axis: 'x',
+        anchor: 'center',
+        min: MIN_COLUMN_WIDTH,
+        currentValue: (n) => n.width,
+        apply: (n, newValue) => columnEditPatch(n, { width: newValue, depth: newValue }),
+        placement: {
+            position: (n) => [n.width / 2 + SIDE_HANDLE_OFFSET, n.height / 2, 0],
+        },
+    };
+}
+// Bottom-spread arrow — sits just outside the right foot of the splay
+// (a-frame / x-brace etc.), one beam-width above the floor plate so it
+// clears the support legs. Drags symmetrically: anchor='center' so
+// pointer Δ of d grows the full leg-to-leg distance by 2d, both legs
+// moving ±d. Defaults mirror the renderer fall-throughs.
+function columnBraceBottomSpreadHandle() {
+    return {
+        kind: 'linear-resize',
+        axis: 'x',
+        anchor: 'center',
+        min: MIN_BRACE_BOTTOM_SPREAD,
+        currentValue: (n) => Math.max(MIN_BRACE_BOTTOM_SPREAD, n.braceBottomSpread ?? Math.max(n.width * 3, 1.2)),
+        apply: (_n, newValue) => ({ braceBottomSpread: newValue }),
+        placement: {
+            position: (n) => {
+                const spread = Math.max(MIN_BRACE_BOTTOM_SPREAD, n.braceBottomSpread ?? Math.max(n.width * 3, 1.2));
+                return [spread / 2 + SPREAD_HANDLE_OFFSET, 0.08, 0];
+            },
+        },
+    };
+}
+// Top-spread arrow — at the right tip of the brace's top edge. Same
+// symmetric anchor as the bottom spread. For a-frame this is the small
+// "pinch" at the top; for y/v-frame and x-brace it's the wider opening.
+function columnBraceTopSpreadHandle() {
+    return {
+        kind: 'linear-resize',
+        axis: 'x',
+        anchor: 'center',
+        min: MIN_BRACE_TOP_SPREAD,
+        currentValue: (n) => Math.max(MIN_BRACE_TOP_SPREAD, n.braceTopSpread ?? 0.12),
+        apply: (_n, newValue) => ({ braceTopSpread: newValue }),
+        placement: {
+            position: (n) => {
+                const spread = Math.max(MIN_BRACE_TOP_SPREAD, n.braceTopSpread ?? 0.12);
+                return [spread / 2 + SPREAD_HANDLE_OFFSET, n.height + 0.08, 0];
+            },
+        },
+    };
+}
+function columnBraceHandle(axis) {
+    return {
+        kind: 'linear-resize',
+        axis,
+        anchor: 'center',
+        min: MIN_BRACE_DIMENSION,
+        currentValue: (n) => (axis === 'x' ? (n.braceWidth ?? n.width) : (n.braceDepth ?? n.depth)),
+        apply: (_n, newValue) => (axis === 'x' ? { braceWidth: newValue } : { braceDepth: newValue }),
+        placement: {
+            position: (n) => {
+                // Position outside any splay so the arrow clears the legs.
+                const half = axis === 'x'
+                    ? Math.max(n.braceBottomSpread ?? 0, n.braceTopSpread ?? 0, n.braceWidth ?? n.width) / 2
+                    : (n.braceDepth ?? n.depth) / 2;
+                return axis === 'x'
+                    ? [half + BRACE_HANDLE_OFFSET, n.height / 2, 0]
+                    : [0, n.height / 2, half + BRACE_HANDLE_OFFSET];
+            },
+        },
+    };
+}
+// Which supports surface bottom-spread / top-spread in the renderer. Phase
+// 1 covers the simple two-leg / single-foot supports; x-brace / k-brace /
+// tripod / trestle / portal-frame / box-frame will hook the same handles
+// in a follow-up once we audit their leg geometry.
+const STYLES_WITH_BOTTOM_SPREAD = new Set(['a-frame']);
+const STYLES_WITH_TOP_SPREAD = new Set([
+    'a-frame',
+    'y-frame',
+    'v-frame',
+]);
+// Whole-column rotation gizmo — same pattern as the elevator. Curved
+// two-headed arrow at the +X / +Z corner of the footprint, a guide ring
+// at the corner-diagonal radius on hover/drag. `apply` negates the
+// angular delta so dragging the cursor CCW around the column rotates
+// the column CCW (cursor atan2 ticks opposite-handed from three.js Ry).
+function columnRotateHandle() {
+    return {
+        kind: 'arc-resize',
+        axis: 'angular',
+        shape: 'rotate',
+        apply: (initial, delta) => ({ rotation: (initial.rotation ?? 0) - delta }),
+        placement: {
+            // Offset along +Z only so the gizmo sticks out the front of the
+            // column rather than diagonally at the corner — keeps the rotate
+            // arrow from crowding the +X side handles (radius / axis / uniform)
+            // while still reading as attached to the column.
+            position: (n) => {
+                const { halfX, halfZ } = columnFootprintHalf(n);
+                const yMid = Math.max(n.height, MIN_COLUMN_HEIGHT) / 2;
+                return [halfX, yMid, halfZ + ROTATE_CORNER_OFFSET];
+            },
+            // Fixed −45° tilt — leans the curve clockwise (as seen from above)
+            // toward the column's front face.
+            rotationY: () => -Math.PI / 4,
+        },
+        decoration: {
+            kind: 'ring',
+            radius: (n) => {
+                const { halfX, halfZ } = columnFootprintHalf(n);
+                return Math.hypot(halfX, halfZ) + ROTATE_RING_OFFSET;
+            },
+            y: (n) => Math.max(n.height, MIN_COLUMN_HEIGHT) / 2,
+        },
+    };
+}
+function columnMoveHandle() {
+    return {
+        kind: 'translate',
+        placement: {
+            // Low to the floor at the front edge (matches the item move grip) so it
+            // reads as a floor-move grip and stays clear of the body resize / rotate
+            // handles that sit at mid-height.
+            position: (n) => {
+                const { halfZ } = columnFootprintHalf(n);
+                return [0, 0.02, halfZ + MOVE_FRONT_OFFSET];
+            },
+        },
+        apply: (_n, pos) => ({ position: [pos[0], pos[1], pos[2]] }),
+        snapExtents: (n) => {
+            const { halfX, halfZ } = columnFootprintHalf(n);
+            const dimX = Math.max(halfX * 2, MIN_COLUMN_WIDTH);
+            const dimZ = Math.max(halfZ * 2, MIN_COLUMN_DEPTH);
+            const swap = Math.abs(Math.sin(n.rotation ?? 0)) > 0.9;
+            return [swap ? dimZ : dimX, swap ? dimX : dimZ];
+        },
+    };
+}
+function columnHandles(node) {
+    if (node.source) {
+        const declared = new Set(node.source.manifest.params.map((param) => param.id));
+        const sizes = [];
+        if (declared.has('height'))
+            sizes.push(columnHeightHandle());
+        if (declared.has('width'))
+            sizes.push(columnAxisHandle('x'));
+        if (declared.has('depth'))
+            sizes.push(columnAxisHandle('z'));
+        return [
+            ...sizes.map((handle) => ({
+                ...handle,
+                commit: (initial, patch) => rebuildScriptedSize(initial, patch),
+            })),
+            columnRotateHandle(),
+            columnMoveHandle(),
+        ];
+    }
+    // 1. Height (universal).
+    // 2. Footprint arrows depending on supportStyle + crossSection:
+    //    - non-vertical supports → braceWidth + braceDepth (skips crossSection)
+    //      plus per-style spread arrows at the splay endpoints.
+    //    - round / octagonal / sixteen-sided → single radius arrow
+    //    - square                            → uniform width+depth
+    //    - rectangular                       → width + depth (independent)
+    const handles = [];
+    const managedByLeanTo = isManagedColumn(node);
+    if (!managedByLeanTo)
+        handles.push(columnHeightHandle());
+    if (node.supportStyle !== 'vertical') {
+        handles.push(columnBraceHandle('x'), columnBraceHandle('z'));
+        if (STYLES_WITH_BOTTOM_SPREAD.has(node.supportStyle)) {
+            handles.push(columnBraceBottomSpreadHandle());
+        }
+        if (STYLES_WITH_TOP_SPREAD.has(node.supportStyle)) {
+            handles.push(columnBraceTopSpreadHandle());
+        }
+    }
+    else if (managedByLeanTo) {
+        // Lean-to sync owns the post's structural height and footprint. Keep
+        // rotation user-owned so asymmetric styles such as K-braces can be flipped.
+    }
+    else if (ROUND_CROSS_SECTIONS.has(node.crossSection)) {
+        handles.push(columnRadiusHandle());
+    }
+    else if (node.crossSection === 'square') {
+        handles.push(columnUniformHandle());
+    }
+    else {
+        handles.push(columnAxisHandle('x'), columnAxisHandle('z'));
+    }
+    handles.push(columnRotateHandle());
+    if (!managedByLeanTo)
+        handles.push(columnMoveHandle());
+    return handles.map((handle) => withHostedChildren(handle, columnHostedPolicy));
+}
+export const columnEditContribution = {
+    snapProfile: 'item',
+    facingIndicator: true,
+    capabilities: {
+        paint: columnPaint,
+    },
+    parametrics: columnParametrics,
+    handles: columnHandles,
+    preview: () => import('./renderer.js').then(({ ColumnPreview }) => ({ default: ColumnPreview })),
+    // Registry-driven placement tool — renders a translucent `ColumnPreview`
+    // ghost at the cursor (mirroring the shelf build tool) instead of the
+    // bare sphere the legacy editor-side `ColumnTool` showed. `ToolManager`'s
+    // registry-first path mounts this and skips the legacy `<ColumnTool>`.
+    tool: () => import('./tool.js'),
+    // One family with the Post tool: a column, or a framing post that stands up to the beam over it.
+    toolOptions: [columnPlaceOption, postBaseOption],
+    toolHints: [
+        { key: 'Left click', label: 'Place column' },
+        { key: 'Esc', label: 'Cancel' },
+    ],
+    computeFloorplanLevelData: computeColumnFloorplanLevelData,
+    floorplanDependsOnSiblings: true,
+    floorplan: buildColumnFloorplan,
+    // 2D body move routes through this kind-specific target so the column
+    // aligns by its footprint *edges* (and snaps flush to wall faces) instead
+    // of the overlay's generic free-translate path, which aligned by bbox
+    // centre and gathered candidates from SVG bounding boxes only. Mirrors the
+    // shelf move target.
+    floorplanMoveTarget: columnFloorplanMoveTarget,
+    // 2D drag affordances — `column-resize` handles every dimension arrow
+    // the floor-plan builder emits per cross-section / support style (the
+    // payload's `dim` field discriminates radius / uniform / width / depth
+    // / brace-width / brace-depth / spreads). `column-rotate` powers the
+    // corner rotate-arrow.
+    floorplanAffordances: {
+        'column-resize': columnResizeAffordance,
+        'column-rotate': columnRotateAffordance,
+    },
+};