@pascal-app/core 1.0.1 → 1.0.4

package/dist/services/storey.js

@@ -1,3 +1,6 @@
+import { footprintLift } from '../lib/floor-foundation-datum.js';
+import { levelConstructionDisplacements } from '../lib/floor-foundation-stack.js';
+import { area, intersection } from '../lib/polygon-boolean.js';
 import { pointInPolygon, pointOnPolygonBoundary, wallOverlapsSlabFootprint, } from '../systems/slab/slab-support.js';
 import { DEFAULT_LEVEL_HEIGHT } from './level-height.js';
 /**
@@ -38,8 +41,23 @@ function resolveLevelBuildingId(levelId, parentId, buildings) {
 // frame (WallCutout), which rebuilt an identical Map 1000+ times a frame. Weakly
 // keyed so a closed project's node graph is not pinned by the memo.
 const elevationMemo = new WeakMap();
+const authoredElevationMemo = new WeakMap();
 export function getLevelElevations(nodes) {
-    const memoized = elevationMemo.get(nodes);
+    const hit = elevationMemo.get(nodes);
+    if (hit)
+        return hit;
+    const elevations = new Map(getAuthoredLevelElevations(nodes));
+    if (Object.values(nodes).some((node) => node.type === 'slab' && node.plateRole === 'base'))
+        for (const [id, lift] of levelConstructionDisplacements(nodes)) {
+            const entry = elevations.get(id);
+            if (lift)
+                elevations.set(id, { ...entry, baseY: entry.baseY + lift });
+        }
+    elevationMemo.set(nodes, elevations);
+    return elevations;
+}
+export function getAuthoredLevelElevations(nodes) {
+    const memoized = authoredElevationMemo.get(nodes);
     if (memoized)
         return memoized;
     const buildings = Object.values(nodes).filter((node) => node?.type === 'building');
@@ -69,7 +87,7 @@ export function getLevelElevations(nodes) {
         });
         cumulativeYByBuilding.set(entry.buildingId, baseY + entry.height);
     }
-    elevationMemo.set(nodes, elevations);
+    authoredElevationMemo.set(nodes, elevations);
     return elevations;
 }
 function resolveLevelFloorToFloorHeight(levelId, elevations) {
@@ -154,6 +172,7 @@ export function getLevelBelow(levelId, nodes) {
     const below = nodes[belowId];
     return below?.type === 'level' ? below : null;
 }
+const coveringMemo = new WeakMap();
 /**
  * Storey height of the queried level plus the level-above's covering
  * (non-recessed) slabs. `null` when `levelId` doesn't resolve to a level.
@@ -161,6 +180,18 @@ export function getLevelBelow(levelId, nodes) {
  * storey height is still meaningful for the clamp bound.
  */
 function resolveCoveringSlabContext(levelId, nodes) {
+    const sources = Object.values(nodes);
+    let memo = coveringMemo.get(nodes);
+    if (!memo) {
+        memo = new Map();
+        coveringMemo.set(nodes, memo);
+    }
+    const cached = memo.get(levelId);
+    // Reconciliation replaces entries in its working graph before returning it.
+    if (cached &&
+        sources.length === cached.sources.length &&
+        sources.every((node, i) => node === cached.sources[i]))
+        return cached.context;
     const level = nodes[levelId];
     if (level?.type !== 'level')
         return null;
@@ -181,11 +212,23 @@ function resolveCoveringSlabContext(levelId, nodes) {
             continue;
         slabs.push(slab);
     }
-    return {
-        floorToFloorHeight: resolveLevelFloorToFloorHeight(levelId, elevations) ??
-            getStoredLevelHeight(level),
+    const floorToFloorHeight = resolveLevelFloorToFloorHeight(levelId, elevations) ?? getStoredLevelHeight(level);
+    const footprints = Object.values(nodes).flatMap((slab) => slab.type === 'slab' && slab.parentId === levelId && slab.plateRole === 'base'
+        ? [{ slab, lift: footprintLift(nodes, slab) }]
+        : []);
+    const authoredHeight = resolveLevelFloorToFloorHeight(levelId, getAuthoredLevelElevations(nodes)) ??
+        getStoredLevelHeight(level);
+    const context = {
+        floorToFloorHeight,
+        planeHeight: authoredHeight,
         slabs,
+        footprintPlanes: footprints.map(({ slab, lift }) => ({
+            slab,
+            top: authoredHeight + lift,
+        })),
     };
+    memo.set(levelId, { sources, context });
+    return context;
 }
 /**
  * Underside of `slab`'s solid in the QUERIED level's local Y. The solid
@@ -272,10 +315,28 @@ export function getCoveringSlabUndersideAt(levelId, nodes, x, z) {
  * {@link DEFAULT_LEVEL_HEIGHT} when `levelId` doesn't resolve to a level.
  */
 export function getWallPlaneTop(wall, levelId, nodes) {
+    return wallPlaneTop(wall, resolveCoveringSlabContext(levelId, nodes));
+}
+export function getWallCoveringSlabUnderside(wall, levelId, nodes) {
+    const context = resolveCoveringSlabContext(levelId, nodes);
+    if (!context)
+        return null;
+    const undersides = context.slabs
+        .filter((slab) => wallOverlapsSlabFootprint(wall, slab.polygon, slab.holes))
+        .map((slab) => coveringUndersideY(context.floorToFloorHeight, slab));
+    return undersides.length ? Math.min(...undersides) : null;
+}
+export function getWallPlaneTops(walls, levelId, nodes) {
     const context = resolveCoveringSlabContext(levelId, nodes);
+    return new Map(walls.map((wall) => [wall.id, wallPlaneTop(wall, context)]));
+}
+function wallPlaneTop(wall, context) {
     if (!context)
         return DEFAULT_LEVEL_HEIGHT;
-    let plane = context.floorToFloorHeight;
+    const footprints = context.footprintPlanes.filter(({ slab }) => wallOverlapsSlabFootprint(wall, slab.polygon));
+    let plane = footprints.length
+        ? Math.max(...footprints.map(({ top }) => top))
+        : context.planeHeight;
     for (const slab of context.slabs) {
         const underside = coveringUndersideY(context.floorToFloorHeight, slab);
         if (underside >= plane)
@@ -300,11 +361,16 @@ export function getWallPlaneTop(wall, levelId, nodes) {
  * Returns `Infinity` when `levelId` doesn't resolve, so callers clamp
  * against nothing rather than a garbage plane.
  */
-export function getCeilingClampBound(levelId, nodes, polygon) {
+export function getCeilingClampBound(levelId, nodes, polygon, wallTop) {
     const context = resolveCoveringSlabContext(levelId, nodes);
     if (!context)
         return Number.POSITIVE_INFINITY;
-    let bound = context.floorToFloorHeight;
+    const footprints = context.footprintPlanes.filter(({ slab }) => area(intersection(slab.polygon, [...polygon])) > 1e-6);
+    let bound = footprints.length
+        ? Math.min(...footprints.map(({ top }) => top))
+        : context.planeHeight;
+    if (wallTop !== undefined)
+        bound = Math.max(bound, wallTop);
     if (polygon.length > 0) {
         let cx = 0;
         let cz = 0;
@@ -324,3 +390,23 @@ export function getCeilingClampBound(levelId, nodes, polygon) {
     }
     return bound - CEILING_CLAMP_MARGIN;
 }
+/**
+ * Lowest height a ceiling on `levelId` may be stored at, in level-local Y.
+ *
+ * A ceiling on a level above grade may hang below that level's floor, down
+ * to grade (world Y 0, the building's lowest floor): eave soffits and porch
+ * ceilings that belong to a roof level explode with it, so they live there
+ * with negative heights. The bound is `-baseY + CEILING_DRAW_OFFSET`, so the
+ * drawn surface lands at grade, or `atGrade` when that is lower. On a level at grade, or one that doesn't resolve, the caller's
+ * `atGrade` floor applies unchanged.
+ */
+/**
+ * The ceiling renderers draw the surface this far under the stored height
+ * (so it never z-fights the slab above); height bounds that promise a drawn
+ * position must add it back.
+ */
+export const CEILING_DRAW_OFFSET = 0.01;
+export function getCeilingMinHeight(levelId, nodes, atGrade) {
+    const baseY = getLevelElevations(nodes).get(levelId)?.baseY ?? 0;
+    return baseY > 0 ? Math.min(atGrade, -baseY + CEILING_DRAW_OFFSET) : atGrade;
+}

package/dist/services/surface-hosting.d.ts

@@ -1,4 +1,4 @@
-import type { SceneApi } from '../registry/types.js';
+import type { AnyNodeDefinition, SceneApi } from '../registry/types.js';
 import type { AnyNode } from '../schema/types.js';
 export type SurfaceId = string;
 export interface SurfaceRegion {
@@ -40,7 +40,7 @@ export interface SurfaceProvider {
     resolveHit(host: AnyNode, hit: SurfaceHit, ctx: SurfaceContext): HostSurface | null;
     accepts?(host: AnyNode, childKind: string, surface: HostSurface, ctx: SurfaceContext): boolean;
 }
-export type SurfaceRejectReason = 'host-not-eligible' | 'invalid-hit' | 'no-surface' | 'child-not-accepted' | 'footprint-outside-surface' | 'footprint-exceeds-host' | 'surface-cutout';
+export type SurfaceRejectReason = 'host-not-eligible' | 'invalid-hit' | 'no-surface' | 'child-not-accepted' | 'footprint-outside-surface' | 'footprint-exceeds-host' | 'surface-cutout' | 'surface-occupied';
 export type SurfacePlacement = {
     position: readonly [number, number, number];
     rotationY: number;
@@ -60,10 +60,14 @@ export declare const itemSurfaceProvider: SurfaceProvider;
 export declare const shelfSurfaceProvider: SurfaceProvider;
 export declare const proceduralItemSurfaceProvider: SurfaceProvider;
 export declare function getSurfaceProvider(host: AnyNode): SurfaceProvider;
+export declare function rendersHostedChildren(def: AnyNodeDefinition): boolean;
+export declare function canHostSurfaceChild(host: AnyNode, childKind: string, childId?: string): boolean;
 /** Hit and child rotation are host-local; bounds and dimensions are scaled child-local values. */
 export declare function resolveSurfacePlacement(args: {
     host: AnyNode;
+    surface?: HostSurface;
     childKind: string;
+    childId?: string;
     childFootprint: {
         size: readonly [number, number, number];
         rotationY: number;

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

@@ -1 +1 @@
-{"version":3,"file":"surface-hosting.d.ts","sourceRoot":"","sources":["../../src/services/surface-hosting.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"surface-hosting.d.ts","sourceRoot":"","sources":["../../src/services/surface-hosting.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAEpE,OAAO,KAAK,EAAE,OAAO,EAAa,MAAM,iBAAiB,CAAA;AAKzD,MAAM,MAAM,SAAS,GAAG,MAAM,CAAA;AAE9B,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;IACxB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,MAAM,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,iEAAiE;IACjE,MAAM,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAA;IAC/C,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAA;CAC5D;AAED,UAAU,YAAY;IACpB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAC3C,QAAQ,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5C,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IACzC,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,MAAM,mBAAmB,GAAG,YAAY,GAAG;IAAE,EAAE,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,CAAA;AACzF,MAAM,MAAM,WAAW,GAAG,mBAAmB,GAAG,CAAC,YAAY,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC,CAAA;AAE7F,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IACxC,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,GAAG,OAAO,CAAC,CAAA;CACvC;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,YAAY,GAAG,eAAe,CAAA;IAC1C,QAAQ,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,SAAS,mBAAmB,EAAE,CAAA;IAC7E,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,cAAc,GAAG,WAAW,GAAG,IAAI,CAAA;IACnF,OAAO,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAA;CAC/F;AAED,MAAM,MAAM,mBAAmB,GAC3B,mBAAmB,GACnB,aAAa,GACb,YAAY,GACZ,oBAAoB,GACpB,2BAA2B,GAC3B,wBAAwB,GACxB,gBAAgB,GAChB,kBAAkB,CAAA;AAEtB,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAC3C,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,SAAS,GAAG,IAAI,CAAA;IAC3B,4FAA4F;IAC5F,UAAU,EAAE,eAAe,CAAC,YAAY,CAAC,CAAA;IACzC,6FAA6F;IAC7F,YAAY,EAAE;QACZ,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;QAC3C,SAAS,EAAE,MAAM,CAAA;QACjB,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;KAC5C,GAAG,IAAI,CAAA;CACT,CAAA;AAED,eAAO,MAAM,uBAAuB,EAAE,SAAS,MAAM,EAepD,CAAA;AAID,eAAO,MAAM,yBAAyB,EAAE,eAOvC,CAAA;AAED,eAAO,MAAM,mBAAmB,EAAE,eAgBjC,CAAA;AA0BD,eAAO,MAAM,oBAAoB,EAAE,eAQlC,CAAA;AAiDD,eAAO,MAAM,6BAA6B,EAAE,eAe3C,CAAA;AAQD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,CAGjE;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAIrE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAiB/F;AA0BD,kGAAkG;AAClG,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,IAAI,EAAE,OAAO,CAAA;IACb,OAAO,CAAC,EAAE,WAAW,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,cAAc,EAAE;QACd,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;QACvC,SAAS,EAAE,MAAM,CAAA;QACjB,uFAAuF;QACvF,QAAQ,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;QAC5C,WAAW,CAAC,EAAE;YAAE,GAAG,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;YAAC,GAAG,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;SAAE,CAAA;KACjG,CAAA;IACD,GAAG,EAAE,UAAU,CAAA;IACf,0FAA0F;IAC1F,MAAM,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAC1C,KAAK,EAAE,QAAQ,CAAA;IACf,wEAAwE;IACxE,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,CAAA;IAC5D,qGAAqG;IACrG,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAA;CACjD,GAAG,gBAAgB,GAAG,IAAI,CAuK1B"}

package/dist/services/surface-hosting.js

@@ -1,9 +1,9 @@
-import { isProceduralItem } from '../procedural-items/query.js';
+import { attachmentBounds, attachmentRegionsOverlap, isProceduralItem, } from '../procedural-items/query.js';
 import { evaluateRecipe } from '../procedural-items/recipe.js';
-import { boxCorners, frame, transformPoint } from '../procedural-items/spatial.js';
+import { boundsOf, boxCorners, frame, transformPoint } from '../procedural-items/spatial.js';
 import { nodeRegistry } from '../registry/registry.js';
 import { getScaledDimensions, isLowProfileItemSurface } from '../schema/nodes/item.js';
-import { canHostOnTop } from './hosting.js';
+import { canHostOnTop, wouldCreateHostingCycle } from './hosting.js';
 import { shelfRowBoardDimensions } from './shelf-board.js';
 import { surfaceRegionContainsFootprint, surfaceRegionContainsPoint } from './surface-region.js';
 export const NON_PHYSICAL_HOST_KINDS = [
@@ -13,6 +13,8 @@ export const NON_PHYSICAL_HOST_KINDS = [
     'construction-dimension',
     'lineset',
     'structural-grid',
+    'separator',
+    'floor-opening',
     'spawn',
     'zone',
     'unit',
@@ -36,7 +38,8 @@ export const itemSurfaceProvider = {
             return null;
         if (!(hit.normalWorldY >= UPWARD_SURFACE_NORMAL_MIN_Y) || !hit.point.every(Number.isFinite))
             return null;
-        const height = host.asset.surface ? host.asset.surface.height * host.scale[1] : hit.point[1];
+        // A script's single resting height summarizes its main top, not every shelf in its mesh.
+        const height = !host.source && host.asset.surface ? host.asset.surface.height * host.scale[1] : hit.point[1];
         return {
             id: null,
             position: [hit.point[0], height, hit.point[2]],
@@ -132,7 +135,29 @@ const adapters = new Map([
 ]);
 export function getSurfaceProvider(host) {
     const declaration = nodeRegistry.get(host.type)?.capabilities.surfaces;
-    return declaration?.hosting ?? adapters.get(host.type) ?? hitDerivedSurfaceProvider;
+    return declaration?.hosting || adapters.get(host.type) || hitDerivedSurfaceProvider;
+}
+export function rendersHostedChildren(def) {
+    return def.renderer
+        ? def.renderer.kind === 'parametric' && def.rendersChildren !== false
+        : !!def.geometry;
+}
+export function canHostSurfaceChild(host, childKind, childId) {
+    const def = nodeRegistry.get(host.type);
+    if (!def ||
+        NON_PHYSICAL_HOST_KINDS.includes(host.type) ||
+        def.capabilities.surfaces?.hosting === false ||
+        nodeRegistry.get(childKind)?.capabilities.surfacePlacement === 'floor-only' ||
+        !rendersHostedChildren(def))
+        return false;
+    const generated = childId
+        ? undefined
+        : nodeRegistry.get(childKind)?.schema.shape.id?.safeParse(undefined);
+    const id = childId ?? (generated?.success ? generated.data : undefined);
+    if (typeof id !== 'string')
+        return false;
+    const parsed = def.schema.shape.children?.safeParse([id]);
+    return parsed?.success === true && Array.isArray(parsed.data) && parsed.data.includes(id);
 }
 function hostRegion(host, ctx) {
     const capabilities = nodeRegistry.get(host.type)?.capabilities;
@@ -159,9 +184,10 @@ function hostRegion(host, ctx) {
 /** Hit and child rotation are host-local; bounds and dimensions are scaled child-local values. */
 export function resolveSurfacePlacement(args) {
     const { host, hit, childKind, childFootprint } = args;
-    // Slabs support level children via supportSlabId. Defer to floor placement
-    // without a refusal, which would block the paired grid event's floor drop.
-    if (host.type === 'slab')
+    if (args.childId && wouldCreateHostingCycle(args.childId, host, args.scene))
+        return null;
+    // Defer without a refusal so the paired grid event can place on floor support.
+    if (!canHostOnTop(host) || !canHostSurfaceChild(host, childKind, args.childId))
         return null;
     const reject = (reason) => {
         args.onReject?.(reason);
@@ -169,8 +195,6 @@ export function resolveSurfacePlacement(args) {
     };
     if (!hit.point.every(Number.isFinite))
         return reject('invalid-hit');
-    if (NON_PHYSICAL_HOST_KINDS.includes(host.type) || !canHostOnTop(host))
-        return reject('host-not-eligible');
     const ctx = { scene: args.scene };
     const provider = getSurfaceProvider(host);
     const poseFor = (surface) => {
@@ -219,7 +243,7 @@ export function resolveSurfacePlacement(args) {
             surfaceLocal: surface.id === null ? null : { position: localPosition, rotationY: rotation[1], rotation },
         };
     };
-    let surface = provider.resolveHit(host, hit, ctx);
+    let surface = args.surface ?? provider.resolveHit(host, hit, ctx);
     if (!surface && hit.normalWorldY >= UPWARD_SURFACE_NORMAL_MIN_Y) {
         // Grab offsets and snapping can leave the pointer over a hole while the child's centre is supported.
         surface = nearestSurface((provider.surfaces?.(host, ctx) ?? []).filter((candidate) => {
@@ -264,5 +288,21 @@ export function resolveSurfacePlacement(args) {
         if (!surfaceRegionContainsFootprint(hostRegion(host, ctx), pose.position, childFootprint.size, childFootprint.rotation ?? childFootprint.rotationY, childFootprint.localBounds))
             return reject('footprint-exceeds-host');
     }
+    if (isProceduralItem(host) && pose.surfaceId !== null && pose.surfaceLocal) {
+        const bounds = childFootprint.localBounds ?? {
+            min: [-childFootprint.size[0] / 2, 0, -childFootprint.size[2] / 2],
+            max: [childFootprint.size[0] / 2, childFootprint.size[1], childFootprint.size[2] / 2],
+        };
+        const proposal = boundsOf(boxCorners([...bounds.min], [...bounds.max]).map((point) => transformPoint(frame([...pose.surfaceLocal.position], [...pose.surfaceLocal.rotation]), point)));
+        for (const id of host.children) {
+            if (id === args.childId || host.attachments[id] !== pose.surfaceId)
+                continue;
+            const child = args.scene.get(id);
+            if (child &&
+                (isProceduralItem(child) || child.type === 'item') &&
+                attachmentRegionsOverlap(attachmentBounds(child), proposal))
+                return reject('surface-occupied');
+        }
+    }
     return pose;
 }