@pascal-app/core 1.0.0 → 1.0.3

package/dist/schema/types.js

@@ -1,51 +1,54 @@
 import z from 'zod';
-import { BlockNode } from './nodes/block';
-import { BoxVentNode } from './nodes/box-vent';
-import { BuildingNode } from './nodes/building';
-import { CabinetModuleNode, CabinetNode } from './nodes/cabinet';
-import { CeilingNode } from './nodes/ceiling';
-import { ChimneyNode } from './nodes/chimney';
-import { ColumnNode } from './nodes/column';
-import { ConstructionDimensionNode } from './nodes/construction-dimension';
-import { CupolaNode } from './nodes/cupola';
-import { DoorNode } from './nodes/door';
-import { DormerNode } from './nodes/dormer';
-import { DownspoutNode } from './nodes/downspout';
-import { DuctFittingNode } from './nodes/duct-fitting';
-import { DuctSegmentNode } from './nodes/duct-segment';
-import { DuctTerminalNode } from './nodes/duct-terminal';
-import { ElevatorNode } from './nodes/elevator';
-import { EyebrowVentNode } from './nodes/eyebrow-vent';
-import { FenceNode } from './nodes/fence';
-import { GuideNode } from './nodes/guide';
-import { GutterNode } from './nodes/gutter';
-import { HvacEquipmentNode } from './nodes/hvac-equipment';
-import { ItemNode } from './nodes/item';
-import { LeanToExtensionNode } from './nodes/lean-to-extension';
-import { LevelNode } from './nodes/level';
-import { LinesetNode } from './nodes/lineset';
-import { LiquidLineNode } from './nodes/liquid-line';
-import { MeasurementNode } from './nodes/measurement';
-import { PipeFittingNode } from './nodes/pipe-fitting';
-import { PipeSegmentNode } from './nodes/pipe-segment';
-import { PipeTrapNode } from './nodes/pipe-trap';
-import { RidgeVentNode } from './nodes/ridge-vent';
-import { RoofNode } from './nodes/roof';
-import { RoofSegmentNode } from './nodes/roof-segment';
-import { ScanNode } from './nodes/scan';
-import { ShelfNode } from './nodes/shelf';
-import { SiteNode } from './nodes/site';
-import { SkylightNode } from './nodes/skylight';
-import { SlabNode } from './nodes/slab';
-import { SolarPanelNode } from './nodes/solar-panel';
-import { SpawnNode } from './nodes/spawn';
-import { StairNode } from './nodes/stair';
-import { StairSegmentNode } from './nodes/stair-segment';
-import { StructuralGridNode } from './nodes/structural-grid';
-import { TurbineVentNode } from './nodes/turbine-vent';
-import { WallNode } from './nodes/wall';
-import { WindowNode } from './nodes/window';
-import { ZoneNode } from './nodes/zone';
+import { ProceduralItemNode } from '../procedural-items/node.js';
+import { BlockNode } from './nodes/block.js';
+import { BoxVentNode } from './nodes/box-vent.js';
+import { BuildingNode } from './nodes/building.js';
+import { CabinetModuleNode, CabinetNode } from './nodes/cabinet.js';
+import { CeilingNode } from './nodes/ceiling.js';
+import { ChimneyNode } from './nodes/chimney.js';
+import { ColumnNode } from './nodes/column.js';
+import { ConstructionDimensionNode } from './nodes/construction-dimension.js';
+import { CupolaNode } from './nodes/cupola.js';
+import { DoorNode } from './nodes/door.js';
+import { DormerNode } from './nodes/dormer.js';
+import { DownspoutNode } from './nodes/downspout.js';
+import { DuctFittingNode } from './nodes/duct-fitting.js';
+import { DuctSegmentNode } from './nodes/duct-segment.js';
+import { DuctTerminalNode } from './nodes/duct-terminal.js';
+import { ElevatorNode } from './nodes/elevator.js';
+import { EyebrowVentNode } from './nodes/eyebrow-vent.js';
+import { FenceNode } from './nodes/fence.js';
+import { GuideNode } from './nodes/guide.js';
+import { GutterNode } from './nodes/gutter.js';
+import { HvacEquipmentNode } from './nodes/hvac-equipment.js';
+import { ImportedMeshNode } from './nodes/imported-mesh.js';
+import { ItemNode } from './nodes/item.js';
+import { LeanToExtensionNode } from './nodes/lean-to-extension.js';
+import { LevelNode } from './nodes/level.js';
+import { LinesetNode } from './nodes/lineset.js';
+import { LiquidLineNode } from './nodes/liquid-line.js';
+import { MeasurementNode } from './nodes/measurement.js';
+import { PipeFittingNode } from './nodes/pipe-fitting.js';
+import { PipeSegmentNode } from './nodes/pipe-segment.js';
+import { PipeTrapNode } from './nodes/pipe-trap.js';
+import { RidgeVentNode } from './nodes/ridge-vent.js';
+import { RoofNode } from './nodes/roof.js';
+import { RoofSegmentNode } from './nodes/roof-segment.js';
+import { ScanNode } from './nodes/scan.js';
+import { ShelfNode } from './nodes/shelf.js';
+import { SiteNode } from './nodes/site.js';
+import { SkylightNode } from './nodes/skylight.js';
+import { SlabNode } from './nodes/slab.js';
+import { SolarPanelNode } from './nodes/solar-panel.js';
+import { SpawnNode } from './nodes/spawn.js';
+import { StairNode } from './nodes/stair.js';
+import { StairSegmentNode } from './nodes/stair-segment.js';
+import { StructuralGridNode } from './nodes/structural-grid.js';
+import { TurbineVentNode } from './nodes/turbine-vent.js';
+import { UnitNode } from './nodes/unit.js';
+import { WallNode } from './nodes/wall.js';
+import { WindowNode } from './nodes/window.js';
+import { ZoneNode } from './nodes/zone.js';
 /**
  * Assembles the node union on discriminators that claim exactly one value.
  *
@@ -58,11 +61,12 @@ import { ZoneNode } from './nodes/zone';
  *
  * Each member is therefore projected to a clone whose `type` is the bare
  * literal. Per-kind schemas keep their default; only the union's view of the
- * discriminator narrows. Metadata lives in zod's global registry keyed by
+ * discriminator narrows. `safeExtend` retains member refinements, including
+ * procedural recipe/parameter validation. Metadata lives in zod's global registry keyed by
  * instance, so `.describe()` text has to be carried over to the clone by hand.
  */
 export const nodeUnion = (members) => z.discriminatedUnion('type', members.map((member) => {
-    const projected = member.extend({ type: member.shape.type.unwrap() });
+    const projected = member.safeExtend({ type: member.shape.type.unwrap() });
     const meta = z.globalRegistry.get(member);
     return meta ? projected.meta(meta) : projected;
 }));
@@ -70,6 +74,7 @@ export const AnyNode = nodeUnion([
     SiteNode,
     BuildingNode,
     ElevatorNode,
+    UnitNode,
     LevelNode,
     LeanToExtensionNode,
     ColumnNode,
@@ -81,6 +86,8 @@ export const AnyNode = nodeUnion([
     CabinetNode,
     CabinetModuleNode,
     ItemNode,
+    ProceduralItemNode,
+    ImportedMeshNode,
     ZoneNode,
     SlabNode,
     CeilingNode,

package/dist/services/__fixtures__/hosting.d.ts

@@ -0,0 +1,3 @@
+import type { AnyNodeDefinition } from '../../registry/types.js';
+export declare function registerHostingTestNode(definition: AnyNodeDefinition): void;
+//# sourceMappingURL=hosting.d.ts.map

package/dist/services/__fixtures__/hosting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosting.d.ts","sourceRoot":"","sources":["../../../src/services/__fixtures__/hosting.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAE7D,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,iBAAiB,QAOpE"}

package/dist/services/__fixtures__/hosting.js

@@ -0,0 +1,9 @@
+import { registerNode } from '../../registry/registry.js';
+export function registerHostingTestNode(definition) {
+    registerNode({
+        ...definition,
+        geometry: () => {
+            throw new Error('Unit-test host geometry must not be rendered');
+        },
+    });
+}

package/dist/services/__fixtures__/shelf-surface-rows.d.ts

@@ -0,0 +1,4 @@
+import type { ShelfNode } from '../../schema/nodes/shelf.js';
+export declare const shelfSurfaceRows: Record<string, number[]>;
+export declare function shelfRowSurfaceYs(node: ShelfNode): number[];
+//# sourceMappingURL=shelf-surface-rows.d.ts.map

package/dist/services/__fixtures__/shelf-surface-rows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shelf-surface-rows.d.ts","sourceRoot":"","sources":["../../../src/services/__fixtures__/shelf-surface-rows.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAGzD,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CASrD,CAAA;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,EAAE,CAK3D"}

package/dist/services/__fixtures__/shelf-surface-rows.js

@@ -0,0 +1,18 @@
+// Captured from production shelf geometry; checked against it in the nodes suite.
+export const shelfSurfaceRows = {
+    'wall-shelf,false,1.8,3,0.04': [0.64, 1.24, 1.8399999999999999],
+    'wall-shelf,true,1.8,3,0.04': [0.64, 1.24, 1.8399999999999999],
+    'bookshelf,false,1.8,3,0.04': [0.64, 1.24, 1.8399999999999999],
+    'bookshelf,true,1.8,3,0.04': [0.04, 0.64, 1.24, 1.8399999999999999],
+    'open-rack,false,1.8,3,0.04': [0.64, 1.24, 1.8399999999999999],
+    'open-rack,true,1.8,3,0.04': [0.64, 1.24, 1.8399999999999999],
+    'cubby,false,1.8,3,0.04': [0.64, 1.24, 1.8399999999999999],
+    'cubby,true,1.8,3,0.04': [0.04, 0.64, 1.24, 1.8399999999999999],
+};
+export function shelfRowSurfaceYs(node) {
+    const key = [node.style, node.withBottom, node.height, node.rows, node.thickness].join(',');
+    const rows = shelfSurfaceRows[key];
+    if (!rows)
+        throw new Error(`Missing shelf row fixture: ${key}`);
+    return rows;
+}

package/dist/services/alignment-anchors.d.ts

@@ -11,19 +11,14 @@
  * (building-local for nodes inside a building). The 3D move producer works
  * entirely in that frame, so the resulting guides line up with the cursor.
  */
-import type { AnyNode } from '../schema/types';
-import { type AlignmentAnchor } from './alignment';
-export type FootprintAABB = {
-    minX: number;
-    minZ: number;
-    maxX: number;
-    maxZ: number;
-};
+import { type PlanAabb } from '../lib/plan-footprint.js';
+import type { AnyNode } from '../schema/types.js';
+import { type AlignmentAnchor } from './alignment.js';
+export type FootprintAABB = PlanAabb;
 /**
  * Axis-aligned XZ bounding box of a rotated rectangle centred at
- * `position`. Mirrors the rotated-corner math the spatial-grid manager
- * uses (`getItemFootprint`) so alignment anchors coincide with the
- * footprint used for collision / slab elevation.
+ * `position`. Delegates to pure `planFootprintAABB` (same math as
+ * spatial-grid / MCP layout clearance).
  */
 export declare function footprintAABBFrom(position: readonly [number, number, number], dimensions: readonly [number, number, number], rotationY: number): FootprintAABB;
 /** XZ footprint AABB of a floor-placed node at its current position, or

package/dist/services/alignment-anchors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"alignment-anchors.d.ts","sourceRoot":"","sources":["../../src/services/alignment-anchors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAE9C,OAAO,EAAE,KAAK,eAAe,EAAqB,MAAM,aAAa,CAAA;AAErE,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEtF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAC3C,UAAU,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAC7C,SAAS,EAAE,MAAM,GAChB,aAAa,CA4Bf;AAwDD;iDACiD;AACjD,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,CAKjE;AAED;;4EAE4E;AAC5E,wBAAgB,eAAe,CAC7B,IAAI,EAAE,OAAO,EACb,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,SAAS,CAAC,EAAE,MAAM,GACjB,aAAa,GAAG,IAAI,CAItB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,OAAO,EACb,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,SAAS,CAAC,EAAE,MAAM,GACjB,eAAe,EAAE,CAInB;AAoBD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,EACpD,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,SAAS,CAAC,EAAE,MAAM,GACjB,eAAe,EAAE,CAuBnB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,GAAG,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,SAAS,CAAC,EAAE,MAAM,GACjB,eAAe,EAAE,CAwBnB;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAC5B,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,GAC7C,eAAe,EAAE,CAEnB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,OAAO,EACb,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACxC,eAAe,EAAE,CAqDnB;AAoBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACxC,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GACtB,eAAe,EAAE,CAWnB"}
+{"version":3,"file":"alignment-anchors.d.ts","sourceRoot":"","sources":["../../src/services/alignment-anchors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,KAAK,QAAQ,EAAqB,MAAM,uBAAuB,CAAA;AAExE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAE9C,OAAO,EAAE,KAAK,eAAe,EAAqB,MAAM,aAAa,CAAA;AAErE,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAA;AAEpC;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAC3C,UAAU,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAC7C,SAAS,EAAE,MAAM,GAChB,aAAa,CAEf;AAwDD;iDACiD;AACjD,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,CAKjE;AAED;;4EAE4E;AAC5E,wBAAgB,eAAe,CAC7B,IAAI,EAAE,OAAO,EACb,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,SAAS,CAAC,EAAE,MAAM,GACjB,aAAa,GAAG,IAAI,CAItB;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,OAAO,EACb,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,SAAS,CAAC,EAAE,MAAM,GACjB,eAAe,EAAE,CAInB;AAoBD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,EACpD,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,SAAS,CAAC,EAAE,MAAM,GACjB,eAAe,EAAE,CAuBnB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,GAAG,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,SAAS,CAAC,EAAE,MAAM,GACjB,eAAe,EAAE,CAwBnB;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAC5B,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,GAC7C,eAAe,EAAE,CAEnB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,OAAO,EACb,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACxC,eAAe,EAAE,CAqDnB;AAoBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACxC,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GACtB,eAAe,EAAE,CAWnB"}

package/dist/services/alignment-anchors.js

@@ -11,44 +11,17 @@
  * (building-local for nodes inside a building). The 3D move producer works
  * entirely in that frame, so the resulting guides line up with the cursor.
  */
-import { nodeRegistry } from '../registry';
-import { DEFAULT_WALL_THICKNESS } from '../systems/wall/wall-footprint';
-import { bboxCornerAnchors } from './alignment';
+import { planFootprintAABB } from '../lib/plan-footprint.js';
+import { nodeRegistry } from '../registry/index.js';
+import { DEFAULT_WALL_THICKNESS } from '../systems/wall/wall-footprint.js';
+import { bboxCornerAnchors } from './alignment.js';
 /**
  * Axis-aligned XZ bounding box of a rotated rectangle centred at
- * `position`. Mirrors the rotated-corner math the spatial-grid manager
- * uses (`getItemFootprint`) so alignment anchors coincide with the
- * footprint used for collision / slab elevation.
+ * `position`. Delegates to pure `planFootprintAABB` (same math as
+ * spatial-grid / MCP layout clearance).
  */
 export function footprintAABBFrom(position, dimensions, rotationY) {
-    const [x, , z] = position;
-    const [w, , d] = dimensions;
-    const halfW = w / 2;
-    const halfD = d / 2;
-    const cos = Math.cos(rotationY);
-    const sin = Math.sin(rotationY);
-    let minX = Number.POSITIVE_INFINITY;
-    let minZ = Number.POSITIVE_INFINITY;
-    let maxX = Number.NEGATIVE_INFINITY;
-    let maxZ = Number.NEGATIVE_INFINITY;
-    for (const [lx, lz] of [
-        [-halfW, -halfD],
-        [halfW, -halfD],
-        [halfW, halfD],
-        [-halfW, halfD],
-    ]) {
-        const wx = x + (lx * cos - lz * sin);
-        const wz = z + (lx * sin + lz * cos);
-        if (wx < minX)
-            minX = wx;
-        if (wx > maxX)
-            maxX = wx;
-        if (wz < minZ)
-            minZ = wz;
-        if (wz > maxZ)
-            maxZ = wz;
-    }
-    return { minX, minZ, maxX, maxZ };
+    return planFootprintAABB(position, dimensions, rotationY);
 }
 /** The relocatable box footprint for a node, or null when it has none
  *  (walls / slabs / polygon kinds) or the kind's predicate excludes it

package/dist/services/drag-session.d.ts

@@ -1,7 +1,7 @@
-import { type ChildQuery, type SpatialQuery } from '../registry/relations-resolver';
-import type { DragAction, Modifiers, SceneApi } from '../registry/types';
-import type { AnyNode } from '../schema/types';
-import type { Vec2 } from './snap';
+import { type ChildQuery, type SpatialQuery } from '../registry/relations-resolver.js';
+import type { DragAction, Modifiers, SceneApi } from '../registry/types.js';
+import type { AnyNode } from '../schema/types.js';
+import type { Vec2 } from './snap.js';
 /**
  * Pure orchestrator for a single `DragAction` lifecycle:
  *   begin → (preview → snap? → apply → cascade dirty)* → commit | cancel

package/dist/services/drag-session.js

@@ -1,4 +1,4 @@
-import { cascadeDirty } from '../registry/relations-resolver';
+import { cascadeDirty } from '../registry/relations-resolver.js';
 const EMPTY_MODIFIERS = { shift: false, alt: false, ctrl: false, meta: false };
 export function createDragSession(action, scene, options = {}) {
     let active = false;

package/dist/services/hosting.d.ts

@@ -1,5 +1,6 @@
-import type { SceneApi, SurfacesConfig } from '../registry/types';
-import type { AnyNode, AnyNodeId } from '../schema/types';
+import type { SceneApi, SurfacesConfig } from '../registry/types.js';
+import type { ItemNode } from '../schema/nodes/item.js';
+import type { AnyNode, AnyNodeId } from '../schema/types.js';
 /**
  * Maximum depth a node tree can host. Guards items-on-items-on-items chains
  * from growing pathological — pre-Phase-1 the editor had no cap. Set high
@@ -22,10 +23,6 @@ export type AttachError = {
 } | {
     kind: 'host-missing';
     hostId: AnyNodeId;
-} | {
-    kind: 'kind-not-allowed';
-    hostKind: string;
-    allowed: readonly string[];
 };
 export type AttachResult = {
     ok: true;
@@ -43,10 +40,9 @@ export type AttachResult = {
  * - The hosting chain (child → host → host.parent → ...) must not contain
  *   `child` (cycle prevention).
  * - The resulting chain must not exceed {@link MAX_HOST_DEPTH}.
- * - If the child's NodeDefinition declares `capabilities.hostable.parents`,
- *   `host.type` must appear in that list.
  */
 export declare function canAttach(childId: AnyNodeId, hostId: AnyNodeId, scene: SceneApi): AttachResult;
+export declare function wouldCreateHostingCycle(childId: string, host: Pick<AnyNode, 'id' | 'parentId'>, scene: Pick<SceneApi, 'get'>): boolean;
 /**
  * Returns the surfaces declared by a host's NodeDefinition. Surfaces describe
  * where other nodes can stack/mount — the `top` of a slab, the `sides` of a
@@ -85,4 +81,5 @@ export declare function pickHost(args: {
  * is declared. Returns the original Y if the host has no top surface.
  */
 export declare function clampYToHostTop(host: AnyNode, originalY: number, nodes?: Record<string, AnyNode>): number;
+export declare function clearFaceHostItemFields(host: AnyNode | undefined): Partial<ItemNode>;
 //# sourceMappingURL=hosting.d.ts.map

package/dist/services/hosting.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hosting.d.ts","sourceRoot":"","sources":["../../src/services/hosting.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACjE,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEzD;;;;;GAKG;AACH,eAAO,MAAM,cAAc,IAAI,CAAA;AAE/B,MAAM,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AAEpD,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAA;AAE9E,MAAM,MAAM,YAAY,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,CAAA;AAE3E;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,GAAG,YAAY,CAoC9F;AAoBD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAG/D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,OAAO,EACb,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAuB,GACnD,MAAM,GAAG,IAAI,CAKf;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAGnD;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE;IAC7B,KAAK,EAAE,IAAI,CAAA;IACX,UAAU,EAAE,SAAS,OAAO,EAAE,CAAA;IAC9B,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,KAAK,OAAO,CAAA;CAClD,GAAG,OAAO,GAAG,IAAI,CAUjB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,OAAO,EACb,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAGR"}
+{"version":3,"file":"hosting.d.ts","sourceRoot":"","sources":["../../src/services/hosting.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEzD;;;;;GAKG;AACH,eAAO,MAAM,cAAc,IAAI,CAAA;AAE/B,MAAM,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AAEpD,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE,CAAA;AAE/C,MAAM,MAAM,YAAY,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,WAAW,CAAA;CAAE,CAAA;AAE3E;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,GAAG,YAAY,CAsB9F;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,UAAU,CAAC,EACtC,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,GAC3B,OAAO,CAUT;AAoBD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAG/D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,OAAO,EACb,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAuB,GACnD,MAAM,GAAG,IAAI,CAKf;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAGnD;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE;IAC7B,KAAK,EAAE,IAAI,CAAA;IACX,UAAU,EAAE,SAAS,OAAO,EAAE,CAAA;IAC9B,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,KAAK,OAAO,CAAA;CAClD,GAAG,OAAO,GAAG,IAAI,CAUjB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,OAAO,EACb,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAGR;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,CAQpF"}

package/dist/services/hosting.js

@@ -1,4 +1,4 @@
-import { nodeRegistry } from '../registry/registry';
+import { nodeRegistry } from '../registry/registry.js';
 /**
  * Maximum depth a node tree can host. Guards items-on-items-on-items chains
  * from growing pathological — pre-Phase-1 the editor had no cap. Set high
@@ -16,8 +16,6 @@ export const MAX_HOST_DEPTH = 6;
  * - The hosting chain (child → host → host.parent → ...) must not contain
  *   `child` (cycle prevention).
  * - The resulting chain must not exceed {@link MAX_HOST_DEPTH}.
- * - If the child's NodeDefinition declares `capabilities.hostable.parents`,
- *   `host.type` must appear in that list.
  */
 export function canAttach(childId, hostId, scene) {
     if (childId === hostId) {
@@ -33,23 +31,22 @@ export function canAttach(childId, hostId, scene) {
         // the caller is responsible for ensuring child exists before commit.
         return checkDepth(hostId, scene);
     }
-    const childDef = nodeRegistry.get(child.type);
-    const allowed = childDef?.capabilities.hostable?.parents;
-    if (allowed && allowed.length > 0 && !allowed.includes(host.type)) {
-        return {
-            ok: false,
-            error: { kind: 'kind-not-allowed', hostKind: host.type, allowed },
-        };
+    if (wouldCreateHostingCycle(childId, host, scene)) {
+        return { ok: false, error: { kind: 'cycle', nodeId: childId, hostId } };
     }
-    // Cycle: walk host's ancestors and reject if we hit the child.
-    let cursor = host;
+    return checkDepth(hostId, scene);
+}
+export function wouldCreateHostingCycle(childId, host, scene) {
+    const visited = new Set();
+    let cursor = host.id;
     while (cursor) {
-        if (cursor.id === childId) {
-            return { ok: false, error: { kind: 'cycle', nodeId: childId, hostId } };
-        }
-        cursor = cursor.parentId ? scene.get(cursor.parentId) : undefined;
+        if (cursor === childId || visited.has(cursor))
+            return true;
+        visited.add(cursor);
+        cursor =
+            (scene.get(cursor) ?? (cursor === host.id ? host : undefined))?.parentId ?? null;
     }
-    return checkDepth(hostId, scene);
+    return false;
 }
 function checkDepth(hostId, scene) {
     // Count host's own depth (root = 0); attaching adds 1 to the child's depth.
@@ -98,7 +95,7 @@ export function getTopSurfaceHeight(host, nodes = { [host.id]: host }) {
  */
 export function canHostOnTop(host) {
     const attachTo = host.asset?.attachTo;
-    return attachTo !== 'ceiling';
+    return attachTo !== 'ceiling' && !host.recipe?.mounting;
 }
 /**
  * Pure host-discovery helper. Given a list of candidate hosts (already
@@ -129,3 +126,13 @@ export function clampYToHostTop(host, originalY, nodes) {
     const top = getTopSurfaceHeight(host, nodes);
     return top == null ? originalY : top;
 }
+export function clearFaceHostItemFields(host) {
+    const patch = {};
+    for (const field of (host &&
+        nodeRegistry.get(host.type)?.capabilities.faceHost?.clearItemFields) ??
+        []) {
+        ;
+        patch[field] = undefined;
+    }
+    return patch;
+}

package/dist/services/index.d.ts

@@ -1,14 +1,17 @@
-export { type AlignmentAnchor, type AlignmentGuide, type AlignmentGuideAxis, type AnchorKind, type BuildingPose, bboxAnchors, bboxCornerAnchors, type ResolveAlignmentInBuildingResult, type ResolveAlignmentInput, type ResolveAlignmentResult, resolveAlignment, resolveAlignmentInBuildingWorld, } from './alignment';
-export { collectAlignmentAnchors, type FootprintAABB, footprintAABB, footprintAABBAt, footprintAABBFrom, movingAlignmentAnchors, movingFootprintAnchors, nodeAlignmentAnchors, polygonAnchors, wallSegmentAnchors, } from './alignment-anchors';
-export { createDragSession, type DragSession, type DragSessionInput, type DragSessionOptions, } from './drag-session';
-export { type AttachError, type AttachResult, canAttach, canHostOnTop, clampYToHostTop, getSurface, getTopSurfaceHeight, MAX_HOST_DEPTH, pickHost, type Vec3, } from './hosting';
-export { DEFAULT_LEVEL_HEIGHT, getCeilingAt, getCeilingHeightAt, resolveCeilingHeight, } from './level-height';
-export { type AxisLock, applyAxisLock, isMovable, movePlanToward, moveToward, resolveMovable, } from './movement';
-export { type AlongWallAlignment, type AlongWallFeature, computeEdgeGaps, computeOpeningGuides, DEFAULT_OPENING_GUIDE_TOLERANCES, detectAlongWallAlignment, detectEqualSpacing, detectVerticalAlignment, type EdgeGap, type EqualSpacingRun, type OpeningGuideInput, type OpeningGuides, type OpeningGuideTolerances, type OpeningSpan, type SillHeadGuide, type VerticalAlignment, type VerticalFeature, type WallExtent, } from './opening-guides';
-export { analyzePortConnectivity, type PortConnection, type PortConnectivity, resolveConnectivityUpdates, } from './port-connectivity';
-export { buildRiserDiagram, projectIso, type RiserDiagram, type RiserLine, type RiserMarker, } from './riser-diagram';
-export { DEFAULT_ANGLE_STEP, DEFAULT_GRID_STEP, type SnapServices, snapAngleToList, snapPointAlongAngleRay, snapPointToAngle, snapPointToGrid, snapScalar, snapServices, snapVec3ToGrid, snapWorldXZToBuildingLocal, } from './snap';
-export { CEILING_CLAMP_MARGIN, findLevelAboveId, findLevelBelowId, getCeilingClampBound, getCoveringSlabUndersideAt, getLevelAbove, getLevelBelow, getLevelElevations, getLevelFloorToFloorHeight, getStoredLevelHeight, getWallPlaneTop, type LevelElevation, } from './storey';
-export { buildPortComponents, collectSystemPorts, distributionPointToWorld, type SystemSummary, summarizeSystemFor, } from './system-graph';
-export { type DwvFinding, type DwvSeverity, validateDwv, } from './validate-dwv';
+export { type AlignmentAnchor, type AlignmentGuide, type AlignmentGuideAxis, type AnchorKind, type BuildingPose, bboxAnchors, bboxCornerAnchors, type ResolveAlignmentInBuildingResult, type ResolveAlignmentInput, type ResolveAlignmentResult, resolveAlignment, resolveAlignmentInBuildingWorld, } from './alignment.js';
+export { collectAlignmentAnchors, type FootprintAABB, footprintAABB, footprintAABBAt, footprintAABBFrom, movingAlignmentAnchors, movingFootprintAnchors, nodeAlignmentAnchors, polygonAnchors, wallSegmentAnchors, } from './alignment-anchors.js';
+export { createDragSession, type DragSession, type DragSessionInput, type DragSessionOptions, } from './drag-session.js';
+export { type AttachError, type AttachResult, canAttach, canHostOnTop, clampYToHostTop, clearFaceHostItemFields, getSurface, getTopSurfaceHeight, MAX_HOST_DEPTH, pickHost, type Vec3, wouldCreateHostingCycle, } from './hosting.js';
+export { DEFAULT_LEVEL_HEIGHT, getCeilingAt, getCeilingHeightAt, resolveCeilingHeight, } from './level-height.js';
+export { type AxisLock, applyAxisLock, isMovable, movePlanToward, moveToward, resolveMovable, } from './movement.js';
+export { type AlongWallAlignment, type AlongWallFeature, computeEdgeGaps, computeOpeningGuides, DEFAULT_OPENING_GUIDE_TOLERANCES, detectAlongWallAlignment, detectEqualSpacing, detectVerticalAlignment, type EdgeGap, type EqualSpacingRun, type OpeningGuideInput, type OpeningGuides, type OpeningGuideTolerances, type OpeningSpan, type SillHeadGuide, type VerticalAlignment, type VerticalFeature, type WallExtent, } from './opening-guides.js';
+export { analyzePortConnectivity, type PortConnection, type PortConnectivity, resolveConnectivityUpdates, } from './port-connectivity.js';
+export { buildRiserDiagram, projectIso, type RiserDiagram, type RiserLine, type RiserMarker, } from './riser-diagram.js';
+export { SHELF_BOARD_INSET, shelfBoardDimensions, shelfRowBoardDimensions } from './shelf-board.js';
+export { DEFAULT_ANGLE_STEP, DEFAULT_GRID_STEP, type SnapServices, snapAngleToList, snapLocalXZInWorld, snapPointAlongAngleRay, snapPointToAngle, snapPointToGrid, snapScalar, snapServices, snapVec3ToGrid, snapWorldXZToBuildingLocal, } from './snap.js';
+export { CEILING_CLAMP_MARGIN, findLevelAboveId, findLevelBelowId, getCeilingClampBound, getCoveringSlabUndersideAt, getLevelAbove, getLevelBelow, getLevelElevations, getLevelFloorToFloorHeight, getStoredLevelHeight, getWallPlaneTop, type LevelElevation, } from './storey.js';
+export { canHostSurfaceChild, type DeclaredHostSurface, getSurfaceProvider, type HostSurface, hitDerivedSurfaceProvider, itemSurfaceProvider, NON_PHYSICAL_HOST_KINDS, proceduralItemSurfaceProvider, rendersHostedChildren, resolveSurfacePlacement, type SurfaceContext, type SurfaceHit, type SurfaceId, type SurfacePlacement, type SurfaceProvider, type SurfaceRegion, type SurfaceRejectReason, shelfSurfaceProvider, } from './surface-hosting.js';
+export { surfaceRegionContainsFootprint, surfaceRegionContainsPoint } from './surface-region.js';
+export { buildPortComponents, collectSystemPorts, distributionPointToWorld, type SystemSummary, summarizeSystemFor, } from './system-graph.js';
+export { type DwvFinding, type DwvSeverity, validateDwv, } from './validate-dwv.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/services/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,WAAW,EACX,iBAAiB,EACjB,KAAK,gCAAgC,EACrC,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,gBAAgB,EAChB,+BAA+B,GAChC,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,uBAAuB,EACvB,KAAK,aAAa,EAClB,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,cAAc,EACd,kBAAkB,GACnB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACL,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,GACxB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,SAAS,EACT,YAAY,EACZ,eAAe,EACf,UAAU,EACV,mBAAmB,EACnB,cAAc,EACd,QAAQ,EACR,KAAK,IAAI,GACV,MAAM,WAAW,CAAA;AAClB,OAAO,EACL,oBAAoB,EACpB,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,KAAK,QAAQ,EACb,aAAa,EACb,SAAS,EACT,cAAc,EACd,UAAU,EACV,cAAc,GACf,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,eAAe,EACf,oBAAoB,EACpB,gCAAgC,EAChC,wBAAwB,EACxB,kBAAkB,EAClB,uBAAuB,EACvB,KAAK,OAAO,EACZ,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC3B,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,UAAU,GAChB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,uBAAuB,EACvB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,WAAW,GACjB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,KAAK,YAAY,EACjB,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,YAAY,EACZ,cAAc,EACd,0BAA0B,GAC3B,MAAM,QAAQ,CAAA;AACf,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,0BAA0B,EAC1B,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,0BAA0B,EAC1B,oBAAoB,EACpB,eAAe,EACf,KAAK,cAAc,GACpB,MAAM,UAAU,CAAA;AACjB,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,wBAAwB,EACxB,KAAK,aAAa,EAClB,kBAAkB,GACnB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EACL,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,WAAW,GACZ,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"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"}

package/dist/services/index.js

@@ -1,13 +1,16 @@
-export { bboxAnchors, bboxCornerAnchors, resolveAlignment, resolveAlignmentInBuildingWorld, } from './alignment';
-export { collectAlignmentAnchors, footprintAABB, footprintAABBAt, footprintAABBFrom, movingAlignmentAnchors, movingFootprintAnchors, nodeAlignmentAnchors, polygonAnchors, wallSegmentAnchors, } from './alignment-anchors';
-export { createDragSession, } from './drag-session';
-export { canAttach, canHostOnTop, clampYToHostTop, getSurface, getTopSurfaceHeight, MAX_HOST_DEPTH, pickHost, } from './hosting';
-export { DEFAULT_LEVEL_HEIGHT, getCeilingAt, getCeilingHeightAt, resolveCeilingHeight, } from './level-height';
-export { applyAxisLock, isMovable, movePlanToward, moveToward, resolveMovable, } from './movement';
-export { computeEdgeGaps, computeOpeningGuides, DEFAULT_OPENING_GUIDE_TOLERANCES, detectAlongWallAlignment, detectEqualSpacing, detectVerticalAlignment, } from './opening-guides';
-export { analyzePortConnectivity, resolveConnectivityUpdates, } from './port-connectivity';
-export { buildRiserDiagram, projectIso, } from './riser-diagram';
-export { DEFAULT_ANGLE_STEP, DEFAULT_GRID_STEP, snapAngleToList, snapPointAlongAngleRay, snapPointToAngle, snapPointToGrid, snapScalar, snapServices, snapVec3ToGrid, snapWorldXZToBuildingLocal, } from './snap';
-export { CEILING_CLAMP_MARGIN, findLevelAboveId, findLevelBelowId, getCeilingClampBound, getCoveringSlabUndersideAt, getLevelAbove, getLevelBelow, getLevelElevations, getLevelFloorToFloorHeight, getStoredLevelHeight, getWallPlaneTop, } from './storey';
-export { buildPortComponents, collectSystemPorts, distributionPointToWorld, summarizeSystemFor, } from './system-graph';
-export { validateDwv, } from './validate-dwv';
+export { bboxAnchors, bboxCornerAnchors, resolveAlignment, resolveAlignmentInBuildingWorld, } from './alignment.js';
+export { collectAlignmentAnchors, footprintAABB, footprintAABBAt, footprintAABBFrom, movingAlignmentAnchors, movingFootprintAnchors, nodeAlignmentAnchors, polygonAnchors, wallSegmentAnchors, } from './alignment-anchors.js';
+export { createDragSession, } from './drag-session.js';
+export { canAttach, canHostOnTop, clampYToHostTop, clearFaceHostItemFields, getSurface, getTopSurfaceHeight, MAX_HOST_DEPTH, pickHost, wouldCreateHostingCycle, } from './hosting.js';
+export { DEFAULT_LEVEL_HEIGHT, getCeilingAt, getCeilingHeightAt, resolveCeilingHeight, } from './level-height.js';
+export { applyAxisLock, isMovable, movePlanToward, moveToward, resolveMovable, } from './movement.js';
+export { computeEdgeGaps, computeOpeningGuides, DEFAULT_OPENING_GUIDE_TOLERANCES, detectAlongWallAlignment, detectEqualSpacing, detectVerticalAlignment, } from './opening-guides.js';
+export { analyzePortConnectivity, resolveConnectivityUpdates, } from './port-connectivity.js';
+export { buildRiserDiagram, projectIso, } from './riser-diagram.js';
+export { SHELF_BOARD_INSET, shelfBoardDimensions, shelfRowBoardDimensions } from './shelf-board.js';
+export { DEFAULT_ANGLE_STEP, DEFAULT_GRID_STEP, snapAngleToList, snapLocalXZInWorld, snapPointAlongAngleRay, snapPointToAngle, snapPointToGrid, snapScalar, snapServices, snapVec3ToGrid, snapWorldXZToBuildingLocal, } from './snap.js';
+export { CEILING_CLAMP_MARGIN, findLevelAboveId, findLevelBelowId, getCeilingClampBound, getCoveringSlabUndersideAt, getLevelAbove, getLevelBelow, getLevelElevations, getLevelFloorToFloorHeight, getStoredLevelHeight, getWallPlaneTop, } from './storey.js';
+export { canHostSurfaceChild, getSurfaceProvider, hitDerivedSurfaceProvider, itemSurfaceProvider, NON_PHYSICAL_HOST_KINDS, proceduralItemSurfaceProvider, rendersHostedChildren, resolveSurfacePlacement, shelfSurfaceProvider, } from './surface-hosting.js';
+export { surfaceRegionContainsFootprint, surfaceRegionContainsPoint } from './surface-region.js';
+export { buildPortComponents, collectSystemPorts, distributionPointToWorld, summarizeSystemFor, } from './system-graph.js';
+export { validateDwv, } from './validate-dwv.js';

package/dist/services/level-height.d.ts

@@ -1,5 +1,5 @@
-import type { CeilingNode } from '../schema';
-import type { AnyNode, AnyNodeId } from '../schema/types';
+import type { CeilingNode } from '../schema/index.js';
+import type { AnyNode, AnyNodeId } from '../schema/types.js';
 export declare const DEFAULT_LEVEL_HEIGHT = 2.5;
 /**
  * Effective ceiling height in level-local meters. An explicit stored

package/dist/services/level-height.js

@@ -1,8 +1,8 @@
-import { computeWallSlabSupport, pointInPolygon } from '../systems/slab/slab-support';
-import { resolveWallTop } from '../systems/wall/wall-top';
+import { computeWallSlabSupport, pointInPolygon } from '../systems/slab/slab-support.js';
+import { resolveWallTop } from '../systems/wall/wall-top.js';
 // Cycle with ./storey (it imports DEFAULT_LEVEL_HEIGHT from here) is safe:
 // both sides only reference the other inside function bodies.
-import { CEILING_CLAMP_MARGIN, getCeilingClampBound } from './storey';
+import { CEILING_CLAMP_MARGIN, getCeilingClampBound } from './storey.js';
 export const DEFAULT_LEVEL_HEIGHT = 2.5;
 /**
  * Effective ceiling height in level-local meters. An explicit stored

package/dist/services/movement.d.ts

@@ -1,6 +1,6 @@
-import type { MovableConfig } from '../registry/types';
-import type { AnyNode } from '../schema/types';
-import { type Vec3 } from './snap';
+import type { MovableConfig } from '../registry/types.js';
+import type { AnyNode } from '../schema/types.js';
+import { type Vec3 } from './snap.js';
 /**
  * Pure movement constraint helpers. Given a node and a target position, apply
  * the constraints declared in `def.capabilities.movable` (axis lock, grid

package/dist/services/movement.js

@@ -1,5 +1,5 @@
-import { nodeRegistry } from '../registry/registry';
-import { snapVec3ToGrid } from './snap';
+import { nodeRegistry } from '../registry/registry.js';
+import { snapVec3ToGrid } from './snap.js';
 /**
  * Returns the MovableConfig effective for `node` after running its `override`
  * callback if declared. Returns `null` if the node's def doesn't declare

package/dist/services/port-connectivity.d.ts

@@ -1,4 +1,4 @@
-import type { AnyNode, AnyNodeId } from '../schema';
+import type { AnyNode, AnyNodeId } from '../schema/index.js';
 /**
  * Connectivity-aware editing for port-bearing distribution kinds
  * (HVAC ductwork AND DWV plumbing).

package/dist/services/port-connectivity.js

@@ -1,4 +1,4 @@
-import { nodeRegistry } from '../registry';
+import { nodeRegistry } from '../registry/index.js';
 /** Distance (meters) under which two ports count as the same joint. Joints
  *  formed by placement snapping coincide to sub-millimeter; 5 cm leaves
  *  generous slack for grid-snapped hand placement without false matches. */

package/dist/services/riser-diagram.d.ts

@@ -1,4 +1,4 @@
-import type { AnyNode, AnyNodeId } from '../schema';
+import type { AnyNode, AnyNodeId } from '../schema/index.js';
 /** A 3D level-local point (meters) projected to 2D iso screen space.
  *  Screen Y grows DOWNWARD (SVG convention), so higher elevation → lower
  *  screen Y. */

package/dist/services/shelf-board.d.ts

@@ -0,0 +1,5 @@
+import type { ShelfNode } from '../schema/nodes/shelf.js';
+export declare const SHELF_BOARD_INSET = 0.001;
+export declare function shelfBoardDimensions(width: number, thickness: number, depth: number, insetWidth?: boolean): [number, number, number];
+export declare function shelfRowBoardDimensions(host: ShelfNode, rowY: number): [number, number, number];
+//# sourceMappingURL=shelf-board.d.ts.map

package/dist/services/shelf-board.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shelf-board.d.ts","sourceRoot":"","sources":["../../src/services/shelf-board.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAGtD,eAAO,MAAM,iBAAiB,QAAQ,CAAA;AAEtC,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,UAAU,UAAQ,GACjB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAM1B;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,4BAUpE"}

package/dist/services/shelf-board.js

@@ -0,0 +1,15 @@
+// Recess coplanar board/frame faces by 1 mm to avoid z-fighting.
+export const SHELF_BOARD_INSET = 0.001;
+export function shelfBoardDimensions(width, thickness, depth, insetWidth = false) {
+    return [
+        insetWidth ? Math.max(width - 2 * SHELF_BOARD_INSET, 0.001) : width,
+        thickness,
+        Math.max(depth - 2 * SHELF_BOARD_INSET, 0.001),
+    ];
+}
+export function shelfRowBoardDimensions(host, rowY) {
+    const sides = host.style === 'cubby' || (host.style === 'bookshelf' && host.withSides);
+    const bottom = host.withBottom && host.style === 'bookshelf' && rowY === host.thickness;
+    const insetWidth = host.style === 'open-rack' || (host.style === 'bookshelf' && !sides && !bottom);
+    return shelfBoardDimensions(host.width - (sides ? 2 * host.thickness : 0), host.thickness, host.depth, insetWidth);
+}