@pascal-app/core 0.7.0 → 0.9.1

package/dist/events/bus.d.ts

@@ -1,17 +1,25 @@
 import type { ThreeEvent } from '@react-three/fiber';
 import type { Object3D } from 'three';
-import type { BuildingNode, CeilingNode, ColumnNode, DoorNode, FenceNode, GuideNode, ItemNode, LevelNode, RoofNode, RoofSegmentNode, SiteNode, SlabNode, SpawnNode, StairNode, StairSegmentNode, WallNode, WindowNode, ZoneNode } from '../schema';
+import type { BoxVentNode, BuildingNode, CeilingNode, ChimneyNode, ColumnNode, CupolaNode, DoorNode, DormerNode, DownspoutNode, ElevatorNode, EyebrowVentNode, FenceNode, GuideNode, GutterNode, ItemNode, LevelNode, RidgeVentNode, RoofNode, RoofSegmentNode, ScanNode, ShelfNode, SiteNode, SkylightNode, SlabNode, SolarPanelNode, SpawnNode, StairNode, StairSegmentNode, TurbineVentNode, WallNode, WindowNode, ZoneNode } from '../schema';
 import type { AnyNode } from '../schema/types';
 export interface GridEvent {
     /** World-space intersection point on the grid plane. */
     position: [number, number, number];
     /**
-     * Building-local intersection point, relative to the currently selected building.
+     * Building-local intersection point — relative to the currently selected building.
      * Equals `position` when no building is selected.
-     * Use this for placing or committing anything that lives inside a building
-     * (walls, slabs, items, etc.).
+     * Use this for placing/committing anything that lives inside a building (walls, slabs, items, etc.).
      */
     localPosition: [number, number, number];
+    faceIndex?: number;
+    /**
+     * Optional: the hit Three.js object. Present when the grid event was
+     * synthesized from a R3F mesh hit (the legacy grid-plane mesh path);
+     * absent when emitted by the canvas-level raycaster in
+     * `use-grid-events.ts`, where there is no specific mesh to attribute
+     * the intersection to.
+     */
+    object?: Object3D;
     nativeEvent: ThreeEvent<PointerEvent>;
 }
 export interface NodeEvent<T extends AnyNode = AnyNode> {
@@ -23,6 +31,7 @@ export interface NodeEvent<T extends AnyNode = AnyNode> {
     object: Object3D;
     stopPropagation: () => void;
     nativeEvent: ThreeEvent<PointerEvent>;
+    viaHandle?: boolean;
 }
 export type WallEvent = NodeEvent<WallNode>;
 export type FenceEvent = NodeEvent<FenceNode>;
@@ -31,6 +40,7 @@ export type SiteEvent = NodeEvent<SiteNode>;
 export type BuildingEvent = NodeEvent<BuildingNode>;
 export type LevelEvent = NodeEvent<LevelNode>;
 export type ZoneEvent = NodeEvent<ZoneNode>;
+export type ShelfEvent = NodeEvent<ShelfNode>;
 export type SlabEvent = NodeEvent<SlabNode>;
 export type SpawnEvent = NodeEvent<SpawnNode>;
 export type CeilingEvent = NodeEvent<CeilingNode>;
@@ -41,6 +51,20 @@ export type StairEvent = NodeEvent<StairNode>;
 export type StairSegmentEvent = NodeEvent<StairSegmentNode>;
 export type WindowEvent = NodeEvent<WindowNode>;
 export type DoorEvent = NodeEvent<DoorNode>;
+export type ElevatorEvent = NodeEvent<ElevatorNode>;
+export type ScanEvent = NodeEvent<ScanNode>;
+export type GuideEvent = NodeEvent<GuideNode>;
+export type BoxVentEvent = NodeEvent<BoxVentNode>;
+export type RidgeVentEvent = NodeEvent<RidgeVentNode>;
+export type TurbineVentEvent = NodeEvent<TurbineVentNode>;
+export type CupolaEvent = NodeEvent<CupolaNode>;
+export type EyebrowVentEvent = NodeEvent<EyebrowVentNode>;
+export type GutterEvent = NodeEvent<GutterNode>;
+export type ChimneyEvent = NodeEvent<ChimneyNode>;
+export type SolarPanelEvent = NodeEvent<SolarPanelNode>;
+export type SkylightEvent = NodeEvent<SkylightNode>;
+export type DormerEvent = NodeEvent<DormerNode>;
+export type DownspoutEvent = NodeEvent<DownspoutNode>;
 export declare const eventSuffixes: readonly ["click", "move", "enter", "leave", "pointerdown", "pointerup", "context-menu", "double-click"];
 export type EventSuffix = (typeof eventSuffixes)[number];
 type NodeEvents<T extends string, E> = {
@@ -64,15 +88,24 @@ export interface ThumbnailGenerateEvent {
     /**
      * When true, snap levels to their true positions before capturing (for a
      * consistent auto-thumbnail angle) and defer the capture if the tab is
-     * hidden, the background auto-save path. Omit for user-driven captures
+     * hidden — the background auto-save path. Omit for user-driven captures
      * that should fire immediately from the current camera pose.
      */
     snapLevels?: boolean;
+    /**
+     * When true, keep the rendered alpha channel — emits a transparent PNG
+     * without baking the scene background into the output. Used by the
+     * preset capture flow so saved preset thumbnails composite cleanly on
+     * any palette background.
+     */
+    transparent?: boolean;
 }
 export interface CameraControlFitSceneEvent {
     /**
-     * XZ-plane axis-aligned bounds for camera framing. Omitted values let the
-     * listener choose its default framing pose.
+     * XZ-plane axis-aligned bounds of the scene's geometry, computed from the
+     * scene graph (see `@pascal-app/editor`'s `computeSceneBoundsXZ`). The
+     * viewer's camera-controls listener frames the camera onto this box.
+     * Omitted values fall back to the camera's default pose.
      */
     bounds?: {
         min: [number, number];
@@ -115,16 +148,6 @@ type WindowAnimationEvents = {
         field: 'operationState';
     };
 };
-type PresetEvents = {
-    'preset:generate-thumbnail': {
-        presetId: string;
-        nodeId: string;
-    };
-    'preset:thumbnail-updated': {
-        presetId: string;
-        thumbnailUrl: string;
-    };
-};
 type ThumbnailEvents = {
     'thumbnail:before-capture': undefined;
     'thumbnail:after-capture': undefined;
@@ -145,7 +168,13 @@ type AIChatEvents = {
         }[];
     };
 };
-type EditorEvents = GridEvents & NodeEvents<'wall', WallEvent> & NodeEvents<'fence', FenceEvent> & NodeEvents<'item', ItemEvent> & NodeEvents<'site', SiteEvent> & NodeEvents<'building', BuildingEvent> & NodeEvents<'level', LevelEvent> & NodeEvents<'zone', ZoneEvent> & NodeEvents<'slab', SlabEvent> & NodeEvents<'spawn', SpawnEvent> & NodeEvents<'ceiling', CeilingEvent> & NodeEvents<'column', ColumnEvent> & NodeEvents<'roof', RoofEvent> & NodeEvents<'roof-segment', RoofSegmentEvent> & NodeEvents<'stair', StairEvent> & NodeEvents<'stair-segment', StairSegmentEvent> & NodeEvents<'window', WindowEvent> & NodeEvents<'door', DoorEvent> & CameraControlEvents & ToolEvents & GuideEvents & DoorAnimationEvents & WindowAnimationEvents & PresetEvents & ThumbnailEvents & SnapshotEvents & AIChatEvents;
+export interface RoomPresetCreateEvent {
+    zoneId: ZoneNode['id'];
+}
+type RoomPresetEvents = {
+    'room-preset:create': RoomPresetCreateEvent;
+};
+type EditorEvents = GridEvents & NodeEvents<'wall', WallEvent> & NodeEvents<'fence', FenceEvent> & NodeEvents<'item', ItemEvent> & NodeEvents<'site', SiteEvent> & NodeEvents<'building', BuildingEvent> & NodeEvents<'elevator', ElevatorEvent> & NodeEvents<'level', LevelEvent> & NodeEvents<'zone', ZoneEvent> & NodeEvents<'slab', SlabEvent> & NodeEvents<'shelf', ShelfEvent> & NodeEvents<'spawn', SpawnEvent> & NodeEvents<'ceiling', CeilingEvent> & NodeEvents<'column', ColumnEvent> & NodeEvents<'roof', RoofEvent> & NodeEvents<'roof-segment', RoofSegmentEvent> & NodeEvents<'stair', StairEvent> & NodeEvents<'stair-segment', StairSegmentEvent> & NodeEvents<'window', WindowEvent> & NodeEvents<'door', DoorEvent> & NodeEvents<'scan', ScanEvent> & NodeEvents<'guide', GuideEvent> & NodeEvents<'box-vent', BoxVentEvent> & NodeEvents<'ridge-vent', RidgeVentEvent> & NodeEvents<'turbine-vent', TurbineVentEvent> & NodeEvents<'cupola', CupolaEvent> & NodeEvents<'eyebrow-vent', EyebrowVentEvent> & NodeEvents<'gutter', GutterEvent> & NodeEvents<'chimney', ChimneyEvent> & NodeEvents<'solar-panel', SolarPanelEvent> & NodeEvents<'skylight', SkylightEvent> & NodeEvents<'dormer', DormerEvent> & NodeEvents<'downspout', DownspoutEvent> & CameraControlEvents & ToolEvents & GuideEvents & DoorAnimationEvents & WindowAnimationEvents & ThumbnailEvents & SnapshotEvents & AIChatEvents & RoomPresetEvents;
 export declare const emitter: import("mitt").Emitter<EditorEvents>;
 export {};
 //# sourceMappingURL=bus.d.ts.map

package/dist/events/bus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bus.d.ts","sourceRoot":"","sources":["../../src/events/bus.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bus.d.ts","sourceRoot":"","sources":["../../src/events/bus.ts"],"names":[],"mappings":"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"}

package/dist/events/bus.js

@@ -1,5 +1,5 @@
 import mitt from 'mitt';
-// Event suffixes, exported for use in hooks
+// Event suffixes - exported for use in hooks
 export const eventSuffixes = [
     'click',
     'move',

package/dist/hooks/scene-registry/scene-registry.d.ts

@@ -1,29 +1,13 @@
 import type * as THREE from 'three';
+type ByTypeMap = {
+    [kind: string]: Set<string>;
+};
 export declare const sceneRegistry: {
     nodes: Map<string, THREE.Object3D<THREE.Object3DEventMap>>;
-    byType: {
-        site: Set<string>;
-        building: Set<string>;
-        ceiling: Set<string>;
-        column: Set<string>;
-        level: Set<string>;
-        wall: Set<string>;
-        fence: Set<string>;
-        item: Set<string>;
-        slab: Set<string>;
-        spawn: Set<string>;
-        zone: Set<string>;
-        roof: Set<string>;
-        'roof-segment': Set<string>;
-        stair: Set<string>;
-        'stair-segment': Set<string>;
-        scan: Set<string>;
-        guide: Set<string>;
-        window: Set<string>;
-        door: Set<string>;
-    };
+    byType: ByTypeMap;
     /** Remove all entries. Call when unloading a scene to prevent stale 3D refs. */
     clear(): void;
 };
-export declare function useRegistry(id: string, type: keyof typeof sceneRegistry.byType, ref: React.RefObject<THREE.Object3D>): void;
+export declare function useRegistry(id: string, type: string, ref: React.RefObject<THREE.Object3D>): void;
+export {};
 //# sourceMappingURL=scene-registry.d.ts.map

package/dist/hooks/scene-registry/scene-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scene-registry.d.ts","sourceRoot":"","sources":["../../../src/hooks/scene-registry/scene-registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAA;AAEnC,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;IA4BxB,gFAAgF;;CAOjF,CAAA;AAED,wBAAgB,WAAW,CACzB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,OAAO,aAAa,CAAC,MAAM,EACvC,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,QAkBrC"}
+{"version":3,"file":"scene-registry.d.ts","sourceRoot":"","sources":["../../../src/hooks/scene-registry/scene-registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAA;AAYnC,KAAK,SAAS,GAAG;IAAE,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAA;CAAE,CAAA;AA2BhD,eAAO,MAAM,aAAa;;;IAQxB,gFAAgF;;CAOjF,CAAA;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,QAiBzF"}

package/dist/hooks/scene-registry/scene-registry.js

@@ -1,35 +1,42 @@
 'use client';
 import { useLayoutEffect } from 'react';
+const byTypeStore = new Map();
+const byTypeProxy = new Proxy({}, {
+    get(_target, key) {
+        if (typeof key !== 'string')
+            return undefined;
+        let set = byTypeStore.get(key);
+        if (!set) {
+            set = new Set();
+            byTypeStore.set(key, set);
+        }
+        return set;
+    },
+    ownKeys() {
+        return Array.from(byTypeStore.keys());
+    },
+    has(_target, key) {
+        return typeof key === 'string' && byTypeStore.has(key);
+    },
+    getOwnPropertyDescriptor(_target, key) {
+        if (typeof key !== 'string')
+            return undefined;
+        const set = byTypeStore.get(key);
+        if (!set)
+            return undefined;
+        return { configurable: true, enumerable: true, value: set, writable: false };
+    },
+});
 export const sceneRegistry = {
     // Master lookup: ID -> Object3D
     nodes: new Map(),
-    // Categorized lookups: Type -> Set of IDs
-    // Using a Set is faster for adding/deleting than an Array
-    byType: {
-        site: new Set(),
-        building: new Set(),
-        ceiling: new Set(),
-        column: new Set(),
-        level: new Set(),
-        wall: new Set(),
-        fence: new Set(),
-        item: new Set(),
-        slab: new Set(),
-        spawn: new Set(),
-        zone: new Set(),
-        roof: new Set(),
-        'roof-segment': new Set(),
-        stair: new Set(),
-        'stair-segment': new Set(),
-        scan: new Set(),
-        guide: new Set(),
-        window: new Set(),
-        door: new Set(),
-    },
+    // Categorized lookups: Kind -> Set of IDs. Backed by a Proxy so any kind
+    // gets a Set on first touch — no hardcoded list.
+    byType: byTypeProxy,
     /** Remove all entries. Call when unloading a scene to prevent stale 3D refs. */
     clear() {
         this.nodes.clear();
-        for (const set of Object.values(this.byType)) {
+        for (const set of byTypeStore.values()) {
             set.clear();
         }
     },
@@ -41,9 +48,9 @@ export function useRegistry(id, type, ref) {
             return;
         // 1. Add to master map
         sceneRegistry.nodes.set(id, obj);
-        // 2. Add to type-specific set
+        // 2. Add to type-specific set — Proxy auto-creates on first access.
         sceneRegistry.byType[type].add(id);
-        // 4. Cleanup when component unmounts
+        // 3. Cleanup when component unmounts
         return () => {
             sceneRegistry.nodes.delete(id);
             sceneRegistry.byType[type].delete(id);

package/dist/hooks/spatial-grid/floor-placed-elevation.d.ts

@@ -0,0 +1,14 @@
+import type { FloorPlacedConfig, FloorPlacedFootprint, FloorPlacedFootprintContext, FloorPlacedFootprintsResolver } from '../../registry/types';
+import type { AnyNode } from '../../schema';
+export type FloorPlacedElevationArgs = {
+    node: AnyNode;
+    nodes: Record<string, AnyNode>;
+    position: [number, number, number];
+    rotation?: unknown;
+    levelId?: string | null;
+};
+export declare function getFloorPlacedFootprints(floorPlaced: FloorPlacedConfig, node: AnyNode, ctx?: FloorPlacedFootprintContext): FloorPlacedFootprint[];
+export declare function getFloorPlacedElevation({ node, nodes, position, rotation, levelId, }: FloorPlacedElevationArgs): number;
+export declare function getFloorStackedPosition(args: FloorPlacedElevationArgs): [number, number, number];
+export type { FloorPlacedFootprint, FloorPlacedFootprintContext, FloorPlacedFootprintsResolver };
+//# sourceMappingURL=floor-placed-elevation.d.ts.map

package/dist/hooks/spatial-grid/floor-placed-elevation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"floor-placed-elevation.d.ts","sourceRoot":"","sources":["../../../src/hooks/spatial-grid/floor-placed-elevation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACpB,2BAA2B,EAC3B,6BAA6B,EAC9B,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,EAAE,OAAO,EAAa,MAAM,cAAc,CAAA;AAGtD,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,OAAO,CAAA;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB,CAAA;AAkBD,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,iBAAiB,EAC9B,IAAI,EAAE,OAAO,EACb,GAAG,CAAC,EAAE,2BAA2B,GAChC,oBAAoB,EAAE,CAMxB;AAED,wBAAgB,uBAAuB,CAAC,EACtC,IAAI,EACJ,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,OAAO,GACR,EAAE,wBAAwB,GAAG,MAAM,CAiCnC;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,wBAAwB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAGhG;AAED,YAAY,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,6BAA6B,EAAE,CAAA"}

package/dist/hooks/spatial-grid/floor-placed-elevation.js

@@ -0,0 +1,51 @@
+import { nodeRegistry } from '../../registry';
+import { spatialGridManager } from './spatial-grid-manager';
+function finiteSlabElevation(elevation) {
+    return Number.isFinite(elevation) ? elevation : 0;
+}
+function withPositionAndRotation({ node, position, rotation, }) {
+    return {
+        ...node,
+        position,
+        ...(rotation !== undefined ? { rotation } : {}),
+    };
+}
+export function getFloorPlacedFootprints(floorPlaced, node, ctx) {
+    const rawFootprints = floorPlaced.footprints?.(node, ctx);
+    if (rawFootprints)
+        return [...rawFootprints];
+    const footprint = floorPlaced.footprint?.(node, ctx);
+    return footprint ? [footprint] : [];
+}
+export function getFloorPlacedElevation({ node, nodes, position, rotation, levelId, }) {
+    const floorPlaced = nodeRegistry.get(node.type)?.capabilities?.floorPlaced;
+    if (!floorPlaced)
+        return 0;
+    const effectiveNode = withPositionAndRotation({ node, position, rotation });
+    if (floorPlaced.applies && !floorPlaced.applies(effectiveNode))
+        return 0;
+    const parentId = effectiveNode.parentId ?? null;
+    const parent = parentId ? nodes[parentId] : null;
+    if (parentId && !parent)
+        return 0;
+    if (parent && parent.type !== 'level')
+        return 0;
+    if (!parent && !levelId)
+        return 0;
+    const resolvedLevelId = parent?.type === 'level' ? parent.id : levelId;
+    if (!resolvedLevelId)
+        return 0;
+    let maxElevation = Number.NEGATIVE_INFINITY;
+    for (const footprint of getFloorPlacedFootprints(floorPlaced, effectiveNode, { nodes })) {
+        const footprintPosition = footprint.position ?? position;
+        const elevation = finiteSlabElevation(spatialGridManager.getSlabElevationForItem(resolvedLevelId, footprintPosition, footprint.dimensions, footprint.rotation));
+        if (elevation > maxElevation) {
+            maxElevation = elevation;
+        }
+    }
+    return maxElevation === Number.NEGATIVE_INFINITY ? 0 : maxElevation;
+}
+export function getFloorStackedPosition(args) {
+    const [x, y, z] = args.position;
+    return [x, y + getFloorPlacedElevation(args), z];
+}

package/dist/hooks/spatial-grid/floor-placed-elevation.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=floor-placed-elevation.test.d.ts.map

package/dist/hooks/spatial-grid/floor-placed-elevation.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"floor-placed-elevation.test.d.ts","sourceRoot":"","sources":["../../../src/hooks/spatial-grid/floor-placed-elevation.test.ts"],"names":[],"mappings":""}

package/dist/hooks/spatial-grid/floor-placed-elevation.test.js

@@ -0,0 +1,273 @@
+import { beforeEach, describe, expect, test } from 'bun:test';
+import { z } from 'zod';
+import { nodeRegistry, registerNode } from '../../registry';
+import { getFloorPlacedElevation, getFloorStackedPosition } from './floor-placed-elevation';
+import { spatialGridManager } from './spatial-grid-manager';
+const LEVEL_ID = 'level_test';
+function makeDefinition(kind, capabilities = {}) {
+    return {
+        kind,
+        schemaVersion: 1,
+        schema: z.object({ type: z.literal(kind) }),
+        category: 'utility',
+        defaults: () => ({}),
+        capabilities,
+    };
+}
+function makeLevel() {
+    return {
+        id: LEVEL_ID,
+        type: 'level',
+        object: 'node',
+        parentId: null,
+        visible: true,
+        metadata: {},
+        children: [],
+        level: 0,
+    };
+}
+function makeFloorNode(overrides = {}) {
+    return {
+        id: 'item_test',
+        type: 'item',
+        object: 'node',
+        parentId: LEVEL_ID,
+        visible: true,
+        metadata: {},
+        children: [],
+        position: [0, 0, 0],
+        rotation: [0, 0, 0],
+        scale: [1, 1, 1],
+        asset: {
+            id: 'asset_test',
+            category: 'test',
+            name: 'Test',
+            thumbnail: '',
+            src: 'asset:test',
+            dimensions: [1, 1, 1],
+            source: 'library',
+        },
+        ...overrides,
+    };
+}
+function addSlab(polygon, elevation, id = `slab_${elevation}`) {
+    const slab = {
+        id,
+        type: 'slab',
+        object: 'node',
+        parentId: LEVEL_ID,
+        visible: true,
+        metadata: {},
+        children: [],
+        polygon,
+        holes: [],
+        holeMetadata: [],
+        elevation,
+        autoFromWalls: false,
+    };
+    spatialGridManager.handleNodeCreated(slab, LEVEL_ID);
+}
+function nodesFor(...nodes) {
+    return Object.fromEntries(nodes.map((node) => [node.id, node]));
+}
+describe('floor-placed elevation resolver', () => {
+    beforeEach(() => {
+        nodeRegistry._reset();
+        spatialGridManager.clear();
+    });
+    test('returns 0 without a floorPlaced capability', () => {
+        registerNode(makeDefinition('item'));
+        addSlab([
+            [-1, -1],
+            [1, -1],
+            [1, 1],
+            [-1, 1],
+        ], 0.4);
+        const level = makeLevel();
+        const node = makeFloorNode();
+        expect(getFloorPlacedElevation({
+            node,
+            nodes: nodesFor(level, node),
+            position: [0, 0, 0],
+            rotation: [0, 0, 0],
+        })).toBe(0);
+    });
+    test('returns 0 when applies returns false', () => {
+        registerNode(makeDefinition('item', {
+            floorPlaced: {
+                footprint: () => ({ dimensions: [1, 1, 1], rotation: [0, 0, 0] }),
+                applies: () => false,
+            },
+        }));
+        addSlab([
+            [-1, -1],
+            [1, -1],
+            [1, 1],
+            [-1, 1],
+        ], 0.4);
+        const level = makeLevel();
+        const node = makeFloorNode();
+        expect(getFloorPlacedElevation({
+            node,
+            nodes: nodesFor(level, node),
+            position: [0, 0, 0],
+            rotation: [0, 0, 0],
+        })).toBe(0);
+    });
+    test('clamps non-finite slab elevation to 0', () => {
+        registerNode(makeDefinition('item', {
+            floorPlaced: {
+                footprint: () => ({ dimensions: [1, 1, 1], rotation: [0, 0, 0] }),
+            },
+        }));
+        const original = spatialGridManager.getSlabElevationForItem;
+        spatialGridManager.getSlabElevationForItem = (() => Number.NaN);
+        try {
+            const level = makeLevel();
+            const node = makeFloorNode();
+            expect(getFloorPlacedElevation({
+                node,
+                nodes: nodesFor(level, node),
+                position: [0, 0, 0],
+                rotation: [0, 0, 0],
+            })).toBe(0);
+        }
+        finally {
+            spatialGridManager.getSlabElevationForItem = original;
+        }
+    });
+    test('returns 0 for a non-level direct parent', () => {
+        registerNode(makeDefinition('item', {
+            floorPlaced: {
+                footprint: () => ({ dimensions: [1, 1, 1], rotation: [0, 0, 0] }),
+            },
+        }));
+        addSlab([
+            [-1, -1],
+            [1, -1],
+            [1, 1],
+            [-1, 1],
+        ], 0.4);
+        const level = makeLevel();
+        const shelf = {
+            id: 'shelf_test',
+            type: 'shelf',
+            parentId: LEVEL_ID,
+        };
+        const node = makeFloorNode({ parentId: shelf.id });
+        expect(getFloorPlacedElevation({
+            node,
+            nodes: nodesFor(level, shelf, node),
+            position: [0, 0, 0],
+            rotation: [0, 0, 0],
+        })).toBe(0);
+    });
+    test('returns 0 when the declared parent is missing', () => {
+        registerNode(makeDefinition('item', {
+            floorPlaced: {
+                footprint: () => ({ dimensions: [1, 1, 1], rotation: [0, 0, 0] }),
+            },
+        }));
+        addSlab([
+            [-1, -1],
+            [1, -1],
+            [1, 1],
+            [-1, 1],
+        ], 0.4);
+        const node = makeFloorNode({ parentId: 'missing_level' });
+        expect(getFloorPlacedElevation({
+            node,
+            nodes: nodesFor(node),
+            position: [0, 0, 0],
+            rotation: [0, 0, 0],
+            levelId: LEVEL_ID,
+        })).toBe(0);
+    });
+    test('uses the pending rotated footprint', () => {
+        registerNode(makeDefinition('item', {
+            floorPlaced: {
+                footprint: (node) => ({
+                    dimensions: [4, 1, 1],
+                    rotation: node.rotation,
+                }),
+            },
+        }));
+        addSlab([
+            [-0.2, 1.2],
+            [0.2, 1.2],
+            [0.2, 1.8],
+            [-0.2, 1.8],
+        ], 0.45);
+        const level = makeLevel();
+        const node = makeFloorNode();
+        expect(getFloorPlacedElevation({
+            node,
+            nodes: nodesFor(level, node),
+            position: [0, 0, 0],
+            rotation: [0, Math.PI / 2, 0],
+        })).toBeCloseTo(0.45);
+    });
+    test('returns slab overlap elevation and stacks Y onto canonical position', () => {
+        registerNode(makeDefinition('item', {
+            floorPlaced: {
+                footprint: (node) => ({
+                    dimensions: [1, 1, 1],
+                    rotation: node.rotation,
+                }),
+            },
+        }));
+        addSlab([
+            [-1, -1],
+            [1, -1],
+            [1, 1],
+            [-1, 1],
+        ], 0.35);
+        const level = makeLevel();
+        const node = makeFloorNode();
+        expect(getFloorPlacedElevation({
+            node,
+            nodes: nodesFor(level, node),
+            position: [0, 0.1, 0],
+            rotation: [0, 0, 0],
+        })).toBeCloseTo(0.35);
+        const stacked = getFloorStackedPosition({
+            node,
+            nodes: nodesFor(level, node),
+            position: [0, 0.1, 0],
+            rotation: [0, 0, 0],
+        });
+        expect(stacked[0]).toBe(0);
+        expect(stacked[1]).toBeCloseTo(0.45);
+        expect(stacked[2]).toBe(0);
+    });
+    test('takes the max elevation across composite footprints', () => {
+        registerNode(makeDefinition('item', {
+            floorPlaced: {
+                footprints: () => [
+                    { position: [0, 0, 0], dimensions: [1, 1, 1], rotation: [0, 0, 0] },
+                    { position: [3, 0, 0], dimensions: [1, 1, 1], rotation: [0, 0, 0] },
+                ],
+            },
+        }));
+        addSlab([
+            [-1, -1],
+            [1, -1],
+            [1, 1],
+            [-1, 1],
+        ], 0.2, 'slab_low');
+        addSlab([
+            [2.5, -0.5],
+            [3.5, -0.5],
+            [3.5, 0.5],
+            [2.5, 0.5],
+        ], 0.8, 'slab_high');
+        const level = makeLevel();
+        const node = makeFloorNode();
+        expect(getFloorPlacedElevation({
+            node,
+            nodes: nodesFor(level, node),
+            position: [0, 0, 0],
+            rotation: [0, 0, 0],
+        })).toBeCloseTo(0.8);
+    });
+});