@pascal-app/nodes 0.1.1

package/dist/shared/roof-attachment-fallback-preview.js

@@ -0,0 +1,84 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { emitter, sceneRegistry, } from '@pascal-app/core';
+import { DragBoundingBox } from '@pascal-app/editor';
+import { useEffect, useRef, useState } from 'react';
+import { Vector3 } from 'three';
+const INVALID_PREVIEW_COLOR = 0xef_44_44;
+export function RoofAttachmentFallbackPreview({ activeBuildingId, ghost, isValidRoofTarget, lift = 0, onInvalidTarget, size, validTarget = 'roof', }) {
+    const [position, setPosition] = useState(null);
+    const lastValidTargetEventRef = useRef(null);
+    const localPointRef = useRef(new Vector3());
+    const isValidRoofTargetRef = useRef(isValidRoofTarget);
+    const onInvalidTargetRef = useRef(onInvalidTarget);
+    isValidRoofTargetRef.current = isValidRoofTarget;
+    onInvalidTargetRef.current = onInvalidTarget;
+    useEffect(() => {
+        if (!activeBuildingId) {
+            setPosition(null);
+            lastValidTargetEventRef.current = null;
+            return;
+        }
+        const trackValidHit = (nativeEvent) => {
+            lastValidTargetEventRef.current = nativeEvent;
+            setPosition(null);
+        };
+        const showInvalidAt = (x, y, z) => {
+            setPosition([x, y + lift, z]);
+            onInvalidTargetRef.current?.();
+        };
+        const showInvalidAtWorld = (event) => {
+            const point = localPointRef.current.set(...event.position);
+            const building = sceneRegistry.nodes.get(activeBuildingId);
+            if (building) {
+                building.updateWorldMatrix(true, false);
+                building.worldToLocal(point);
+            }
+            showInvalidAt(point.x, 0, point.z);
+        };
+        const onRoofHit = (event) => {
+            if (isValidRoofTargetRef.current?.(event) === false) {
+                showInvalidAtWorld(event);
+                return;
+            }
+            trackValidHit(event.nativeEvent);
+        };
+        const onGutterHit = (event) => trackValidHit(event.nativeEvent);
+        const onGridMove = (event) => {
+            if (event.nativeEvent === lastValidTargetEventRef.current)
+                return;
+            const [x, y, z] = event.localPosition;
+            showInvalidAt(x, y, z);
+        };
+        if (validTarget === 'roof') {
+            emitter.on('roof:enter', onRoofHit);
+            emitter.on('roof:move', onRoofHit);
+        }
+        else {
+            emitter.on('gutter:enter', onGutterHit);
+            emitter.on('gutter:move', onGutterHit);
+        }
+        emitter.on('grid:move', onGridMove);
+        return () => {
+            if (validTarget === 'roof') {
+                emitter.off('roof:enter', onRoofHit);
+                emitter.off('roof:move', onRoofHit);
+            }
+            else {
+                emitter.off('gutter:enter', onGutterHit);
+                emitter.off('gutter:move', onGutterHit);
+            }
+            emitter.off('grid:move', onGridMove);
+        };
+    }, [activeBuildingId, lift, validTarget]);
+    if (!(activeBuildingId && position))
+        return null;
+    // When ghost is provided, render the ghost instead of DragBoundingBox
+    if (ghost) {
+        return _jsx("group", { position: position, children: ghost });
+    }
+    // Fallback to DragBoundingBox for callers not yet migrated
+    if (!size)
+        return null;
+    return (_jsx(DragBoundingBox, { color: INVALID_PREVIEW_COLOR, nodeId: "roof-attachment-fallback", position: position, size: size }));
+}

package/dist/shared/roof-face-host.d.ts

@@ -0,0 +1,17 @@
+import { type RoofWallFaceId } from '@pascal-app/core';
+import { type ReactNode } from 'react';
+/**
+ * Mounts a roof-hosted wall child inside its host face frame. Children
+ * of roof segments render under the roof's `roof-elements` group (roof
+ * frame); this wrapper applies the segment transform plus the face
+ * frame, both derived from the LIVE-override-merged segment — hosted
+ * nodes therefore track segment handle drags in real time instead of
+ * jumping to their new spot on commit. Inside the frame, children use
+ * plain wall-child position conventions ([u, v, z-from-mid-plane]).
+ */
+export declare function RoofFaceHostFrame({ roofSegmentId, roofFace, children, }: {
+    roofSegmentId: string;
+    roofFace: RoofWallFaceId | undefined;
+    children: ReactNode;
+}): import("react").JSX.Element | null;
+//# sourceMappingURL=roof-face-host.d.ts.map

package/dist/shared/roof-face-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roof-face-host.d.ts","sourceRoot":"","sources":["../../src/shared/roof-face-host.tsx"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,cAAc,EAGpB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,KAAK,SAAS,EAAW,MAAM,OAAO,CAAA;AAE/C;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,aAAa,EACb,QAAQ,EACR,QAAQ,GACT,EAAE;IACD,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,cAAc,GAAG,SAAS,CAAA;IACpC,QAAQ,EAAE,SAAS,CAAA;CACpB,sCAuBA"}

package/dist/shared/roof-face-host.js

@@ -0,0 +1,24 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { getRoofWallFaceFrame, useLiveNodeOverrides, useScene, } from '@pascal-app/core';
+import { useMemo } from 'react';
+/**
+ * Mounts a roof-hosted wall child inside its host face frame. Children
+ * of roof segments render under the roof's `roof-elements` group (roof
+ * frame); this wrapper applies the segment transform plus the face
+ * frame, both derived from the LIVE-override-merged segment — hosted
+ * nodes therefore track segment handle drags in real time instead of
+ * jumping to their new spot on commit. Inside the frame, children use
+ * plain wall-child position conventions ([u, v, z-from-mid-plane]).
+ */
+export function RoofFaceHostFrame({ roofSegmentId, roofFace, children, }) {
+    const storeSegment = useScene((state) => state.nodes[roofSegmentId]);
+    const liveOverride = useLiveNodeOverrides((s) => s.get(roofSegmentId));
+    const segment = useMemo(() => storeSegment && liveOverride
+        ? { ...storeSegment, ...liveOverride }
+        : storeSegment, [storeSegment, liveOverride]);
+    if (segment?.type !== 'roof-segment' || !roofFace)
+        return null;
+    const frame = getRoofWallFaceFrame(segment, roofFace);
+    return (_jsx("group", { position: segment.position, "rotation-y": segment.rotation, children: _jsx("group", { position: frame.origin, "rotation-y": frame.yaw, children: children }) }));
+}

package/dist/shared/roof-opening-host.d.ts

@@ -0,0 +1,66 @@
+import type { AnyNode, AnyNodeId, RoofWallFaceId } from '@pascal-app/core';
+/**
+ * Host-side helpers for openings (door / window) hosted on a roof-segment
+ * wall face: resize-handle limits derived from the face profile, and the
+ * plan-space anchors the 2D floor-plan move path needs. Hosted children
+ * store FACE-LOCAL coords ([u, v, z-from-mid-plane]) + `roofFace`.
+ */
+type RoofHostedOpening = {
+    roofSegmentId?: string;
+    roofFace?: RoofWallFaceId;
+    parentId: string | null;
+    position: [number, number, number];
+    width: number;
+    height: number;
+};
+type SceneReader = {
+    get: (id: AnyNodeId) => unknown;
+};
+/**
+ * Resize-handle width limit for a roof-hosted opening: the opposite edge
+ * is anchored, `growSign` (+1 = door-local +X arrow) is the direction
+ * the dragged edge moves. Null when the node is not roof-hosted.
+ */
+export declare function readRoofFaceWidthMax(node: RoofHostedOpening, scene: SceneReader, growSign: number): number | null;
+/**
+ * Resize-handle height limit for a roof-hosted opening. `growSign` +1 =
+ * bottom edge anchored, top grows up; -1 = top anchored, bottom grows
+ * down. Null when the node is not roof-hosted.
+ */
+export declare function readRoofFaceHeightMax(node: RoofHostedOpening, scene: SceneReader, growSign: number): number | null;
+/**
+ * Level hosting a roof-hosted opening's roof (opening → segment → roof →
+ * level). Null when the parent chain isn't roof-shaped.
+ */
+export declare function getRoofHostedOpeningLevelId(node: {
+    parentId: string | null;
+}, nodes: Record<string, AnyNode | undefined>): AnyNodeId | null;
+/**
+ * The level that owns the wall-snap candidates for an opening (door /
+ * window), across all three parentings the 2D move can start from:
+ *   - roof-hosted: opening → segment → roof → level (`getRoofHostedOpeningLevelId`).
+ *   - wall-hosted (existing opening): parent is a wall → its parent is the level.
+ *   - fresh placement (preset/catalog): the clone is parented straight to the
+ *     LEVEL (`place-preset` sets `parentId: levelId`), so the parent IS the level.
+ *
+ * The fresh-placement case is the subtle one: treating the parent as always a
+ * wall (`parent.parentId`) resolves a fresh opening's level to the BUILDING,
+ * and `collectLevelWallSegments(building)` finds no walls — so a new door /
+ * window never snapped in 2D. Returns null when the parent chain is none of
+ * the above.
+ */
+export declare function getOpeningHostLevelId(node: {
+    parentId: string | null;
+}, nodes: Record<string, AnyNode | undefined>): AnyNodeId | null;
+/**
+ * Level-plan [x, z] of a roof-hosted node — its face-local center mapped
+ * through the face frame, then composed through the segment's and roof's
+ * yaw + position.
+ */
+export declare function getRoofHostedOpeningPlanPoint(node: {
+    parentId: string | null;
+    roofFace?: RoofWallFaceId;
+    position: [number, number, number];
+}, nodes: Record<string, AnyNode | undefined>): [number, number] | null;
+export {};
+//# sourceMappingURL=roof-opening-host.d.ts.map

package/dist/shared/roof-opening-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roof-opening-host.d.ts","sourceRoot":"","sources":["../../src/shared/roof-opening-host.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,SAAS,EAGT,cAAc,EACf,MAAM,kBAAkB,CAAA;AAQzB;;;;;GAKG;AAEH,KAAK,iBAAiB,GAAG;IACvB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,cAAc,CAAA;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,KAAK,WAAW,GAAG;IAAE,GAAG,EAAE,CAAC,EAAE,EAAE,SAAS,KAAK,OAAO,CAAA;CAAE,CAAA;AAStD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,iBAAiB,EACvB,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,IAAI,CAKf;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,iBAAiB,EACvB,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,IAAI,CAKf;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC,GACzC,SAAS,GAAG,IAAI,CAMlB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC,GACzC,SAAS,GAAG,IAAI,CAOlB;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE;IACJ,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,QAAQ,CAAC,EAAE,cAAc,CAAA;IACzB,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CACnC,EACD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC,GACzC,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAqBzB"}

package/dist/shared/roof-opening-host.js

@@ -0,0 +1,98 @@
+import { getMaxRoofRectHeightFromAnchor, getMaxRoofRectWidthFromAnchor, getRoofSegmentWallFace, roofFacePointToSegment, } from '@pascal-app/core';
+function resolveHostFace(node, scene) {
+    if (!(node.roofSegmentId && node.roofFace))
+        return null;
+    const segment = scene.get(node.roofSegmentId);
+    if (segment?.type !== 'roof-segment')
+        return null;
+    return { segment, face: getRoofSegmentWallFace(segment, node.roofFace) };
+}
+/**
+ * Resize-handle width limit for a roof-hosted opening: the opposite edge
+ * is anchored, `growSign` (+1 = door-local +X arrow) is the direction
+ * the dragged edge moves. Null when the node is not roof-hosted.
+ */
+export function readRoofFaceWidthMax(node, scene, growSign) {
+    const host = resolveHostFace(node, scene);
+    if (!host)
+        return null;
+    const anchorU = node.position[0] - (growSign * node.width) / 2;
+    return getMaxRoofRectWidthFromAnchor(host.face, anchorU, growSign, node.position[1], node.height);
+}
+/**
+ * Resize-handle height limit for a roof-hosted opening. `growSign` +1 =
+ * bottom edge anchored, top grows up; -1 = top anchored, bottom grows
+ * down. Null when the node is not roof-hosted.
+ */
+export function readRoofFaceHeightMax(node, scene, growSign) {
+    const host = resolveHostFace(node, scene);
+    if (!host)
+        return null;
+    const anchorV = node.position[1] - (growSign * node.height) / 2;
+    return getMaxRoofRectHeightFromAnchor(host.face, node.position[0], node.width, anchorV, growSign);
+}
+/**
+ * Level hosting a roof-hosted opening's roof (opening → segment → roof →
+ * level). Null when the parent chain isn't roof-shaped.
+ */
+export function getRoofHostedOpeningLevelId(node, nodes) {
+    const segment = node.parentId ? nodes[node.parentId] : undefined;
+    if (segment?.type !== 'roof-segment')
+        return null;
+    const roof = segment.parentId ? nodes[segment.parentId] : undefined;
+    if (roof?.type !== 'roof')
+        return null;
+    return roof.parentId ?? null;
+}
+/**
+ * The level that owns the wall-snap candidates for an opening (door /
+ * window), across all three parentings the 2D move can start from:
+ *   - roof-hosted: opening → segment → roof → level (`getRoofHostedOpeningLevelId`).
+ *   - wall-hosted (existing opening): parent is a wall → its parent is the level.
+ *   - fresh placement (preset/catalog): the clone is parented straight to the
+ *     LEVEL (`place-preset` sets `parentId: levelId`), so the parent IS the level.
+ *
+ * The fresh-placement case is the subtle one: treating the parent as always a
+ * wall (`parent.parentId`) resolves a fresh opening's level to the BUILDING,
+ * and `collectLevelWallSegments(building)` finds no walls — so a new door /
+ * window never snapped in 2D. Returns null when the parent chain is none of
+ * the above.
+ */
+export function getOpeningHostLevelId(node, nodes) {
+    const roofLevelId = getRoofHostedOpeningLevelId(node, nodes);
+    if (roofLevelId)
+        return roofLevelId;
+    const parent = node.parentId ? nodes[node.parentId] : undefined;
+    if (!parent)
+        return null;
+    if (parent.type === 'level')
+        return parent.id;
+    return parent.parentId ?? null;
+}
+/**
+ * Level-plan [x, z] of a roof-hosted node — its face-local center mapped
+ * through the face frame, then composed through the segment's and roof's
+ * yaw + position.
+ */
+export function getRoofHostedOpeningPlanPoint(node, nodes) {
+    const segment = node.parentId ? nodes[node.parentId] : undefined;
+    if (segment?.type !== 'roof-segment' || !node.roofFace)
+        return null;
+    const roof = segment.parentId ? nodes[segment.parentId] : undefined;
+    if (roof?.type !== 'roof')
+        return null;
+    const rotate = (x, z, yaw) => [
+        x * Math.cos(yaw) + z * Math.sin(yaw),
+        -x * Math.sin(yaw) + z * Math.cos(yaw),
+    ];
+    const segLocal = roofFacePointToSegment(segment, node.roofFace, [
+        node.position[0],
+        node.position[1],
+        node.position[2],
+    ]);
+    const [sx, sz] = rotate(segLocal[0], segLocal[2], segment.rotation ?? 0);
+    const segX = sx + segment.position[0];
+    const segZ = sz + segment.position[2];
+    const [rx, rz] = rotate(segX, segZ, roof.rotation ?? 0);
+    return [rx + roof.position[0], rz + roof.position[2]];
+}

package/dist/shared/roof-segment-hit.d.ts

@@ -0,0 +1,34 @@
+import { type RoofNode, type RoofSegmentNode } from '@pascal-app/core';
+export type RoofSegmentHit = {
+    segment: RoofSegmentNode;
+    localX: number;
+    localY: number;
+    localZ: number;
+};
+/**
+ * Resolve which roof-segment the user clicked. Used by every placement
+ * tool that drops a new node onto a roof (box-vent, ridge-vent,
+ * chimney, solar-panel, skylight, dormer).
+ *
+ * The hip/gable case puts every slope at the same roof origin and
+ * differs them only by `rotation-y`. After `worldToLocal`, the hit
+ * point's (x, z) lies inside *every* segment's axis-aligned half-
+ * extents, so a naive first-match returns the wrong slope (typically
+ * segments[0]). We instead score each candidate by
+ * `|localY − getRoofSegmentSurfaceY(localX, localZ)|` and pick the
+ * smallest — the slope the user actually clicked is the one whose
+ * sloped surface passes through the hit point.
+ *
+ *  - Overhang is included in the bbox filter because the visible
+ *    merged-roof mesh extends past `width/2` by the overhang on each
+ *    side; without it, clicks on the eave bands produced `null`.
+ *
+ *  - Fallback: if no segment passes the bbox filter (clicked beyond
+ *    every outer overhang, or registry is stale), return the first
+ *    segment with the click projected into its frame — matches the
+ *    legacy "always commit somewhere" behaviour.
+ *
+ * Returns null only if the roof has zero registered segments.
+ */
+export declare function resolveRoofSegmentHit(roof: RoofNode, wx: number, wy: number, wz: number): RoofSegmentHit | null;
+//# sourceMappingURL=roof-segment-hit.d.ts.map

package/dist/shared/roof-segment-hit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roof-segment-hit.d.ts","sourceRoot":"","sources":["../../src/shared/roof-segment-hit.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,eAAe,EAGrB,MAAM,kBAAkB,CAAA;AAMzB,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,eAAe,CAAA;IACxB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,QAAQ,EACd,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,GACT,cAAc,GAAG,IAAI,CA2CvB"}

package/dist/shared/roof-segment-hit.js

@@ -0,0 +1,72 @@
+import { getRoofSegmentSurfaceY, sceneRegistry, useScene, } from '@pascal-app/core';
+import * as THREE from 'three';
+const worldPoint = new THREE.Vector3();
+const localPoint = new THREE.Vector3();
+/**
+ * Resolve which roof-segment the user clicked. Used by every placement
+ * tool that drops a new node onto a roof (box-vent, ridge-vent,
+ * chimney, solar-panel, skylight, dormer).
+ *
+ * The hip/gable case puts every slope at the same roof origin and
+ * differs them only by `rotation-y`. After `worldToLocal`, the hit
+ * point's (x, z) lies inside *every* segment's axis-aligned half-
+ * extents, so a naive first-match returns the wrong slope (typically
+ * segments[0]). We instead score each candidate by
+ * `|localY − getRoofSegmentSurfaceY(localX, localZ)|` and pick the
+ * smallest — the slope the user actually clicked is the one whose
+ * sloped surface passes through the hit point.
+ *
+ *  - Overhang is included in the bbox filter because the visible
+ *    merged-roof mesh extends past `width/2` by the overhang on each
+ *    side; without it, clicks on the eave bands produced `null`.
+ *
+ *  - Fallback: if no segment passes the bbox filter (clicked beyond
+ *    every outer overhang, or registry is stale), return the first
+ *    segment with the click projected into its frame — matches the
+ *    legacy "always commit somewhere" behaviour.
+ *
+ * Returns null only if the roof has zero registered segments.
+ */
+export function resolveRoofSegmentHit(roof, wx, wy, wz) {
+    worldPoint.set(wx, wy, wz);
+    const state = useScene.getState();
+    let firstSegment = null;
+    let best = null;
+    for (const childId of roof.children ?? []) {
+        const seg = state.nodes[childId];
+        if (seg?.type !== 'roof-segment')
+            continue;
+        const segObj = sceneRegistry.nodes.get(seg.id);
+        if (!segObj)
+            continue;
+        segObj.updateWorldMatrix(true, false);
+        const local = segObj.worldToLocal(localPoint.copy(worldPoint));
+        if (!firstSegment)
+            firstSegment = { seg, segObj };
+        const overhang = seg.overhang ?? 0;
+        const halfW = seg.width / 2 + overhang;
+        const halfD = seg.depth / 2 + overhang;
+        if (Math.abs(local.x) <= halfW && Math.abs(local.z) <= halfD) {
+            const surfaceY = getRoofSegmentSurfaceY(seg, local.x, local.z);
+            const score = Math.abs(local.y - surfaceY);
+            if (!best || score < best.score) {
+                best = {
+                    hit: { segment: seg, localX: local.x, localY: local.y, localZ: local.z },
+                    score,
+                };
+            }
+        }
+    }
+    if (best)
+        return best.hit;
+    if (firstSegment) {
+        const local = firstSegment.segObj.worldToLocal(localPoint.copy(worldPoint));
+        return {
+            segment: firstSegment.seg,
+            localX: local.x,
+            localY: local.y,
+            localZ: local.z,
+        };
+    }
+    return null;
+}

package/dist/shared/roof-surface-placement-guides.d.ts

@@ -0,0 +1,68 @@
+import { type RoofNode, type RoofSegmentNode } from '@pascal-app/core';
+import type { RelativeRoofDragTarget } from './relative-roof-drag';
+export type RoofSurfaceGuideMode = 'side-center' | 'linear-edge';
+export type RoofSurfaceGuideFootprint = {
+    width: number;
+    depth: number;
+    rotation?: number;
+};
+type RoofGuideBounds = {
+    centerX: number;
+    centerZ: number;
+    minX: number;
+    maxX: number;
+    minZ: number;
+    maxZ: number;
+};
+type RoofGuideSide = 'left' | 'right' | 'bottom' | 'top';
+type RoofSiblingSpacingResult<T> = {
+    guides: T[];
+    blockedSides: Record<RoofGuideSide, boolean>;
+};
+export declare function roofSurfaceFootprintFromNode(node: unknown, options?: {
+    segment?: RoofSegmentNode;
+}): RoofSurfaceGuideFootprint;
+export declare function publishRoofSurfacePlacementGuides(args: {
+    roof: RoofNode;
+    segment: RoofSegmentNode;
+    center: readonly [number, number, number];
+    footprint: RoofSurfaceGuideFootprint;
+    mode?: RoofSurfaceGuideMode;
+    movingId?: string;
+}): void;
+export declare function publishRoofSurfaceNodePlacementGuides(args: {
+    roof: RoofNode;
+    segment: RoofSegmentNode;
+    center: readonly [number, number, number];
+    node: unknown;
+    mode?: RoofSurfaceGuideMode;
+    movingId?: string;
+}): void;
+export declare function snapRoofSurfaceNodeTarget(args: {
+    target: RelativeRoofDragTarget;
+    node: unknown;
+    movingId?: string;
+    bypass?: boolean;
+}): RelativeRoofDragTarget;
+export declare function clearRoofSurfacePlacementGuides(): void;
+export declare function roofGuideBounds(center: readonly [number, number, number], footprint: RoofSurfaceGuideFootprint): RoofGuideBounds;
+export declare function roofSiblingSpacingGuides<T>(args: {
+    segment: RoofSegmentNode;
+    movingId?: string;
+    movingBounds: RoofGuideBounds;
+    faceKey: string;
+    dimension: (id: string, from: [number, number], to: [number, number]) => T | null;
+}): T[];
+export declare function roofSiblingSpacing<T>(args: {
+    segment: RoofSegmentNode;
+    movingId?: string;
+    movingBounds: RoofGuideBounds;
+    faceKey: string;
+    dimension: (id: string, from: [number, number], to: [number, number]) => T | null;
+    alignLine?: (id: string, from: [number, number], to: [number, number]) => T | null;
+    badge?: (id: string, at: [number, number], value: number) => T | null;
+    measure?: (from: [number, number], to: [number, number]) => number;
+}): RoofSiblingSpacingResult<T>;
+export declare function roofFaceKey(polygon: readonly (readonly [number, number])[]): string;
+export {};
+//# sourceMappingURL=roof-surface-placement-guides.d.ts.map

package/dist/shared/roof-surface-placement-guides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roof-surface-placement-guides.d.ts","sourceRoot":"","sources":["../../src/shared/roof-surface-placement-guides.ts"],"names":[],"mappings":"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"}