@pascal-app/core 1.0.3 → 1.0.5

package/dist/services/storey.d.ts

@@ -1,4 +1,4 @@
-import type { LevelNode, WallNode } from '../schema/index.js';
+import type { LevelNode, SlabNode, WallNode } from '../schema/index.js';
 import type { AnyNode, AnyNodeId } from '../schema/types.js';
 /**
  * Gap kept between a ceiling's stored height and its clamp bound (storey
@@ -6,6 +6,8 @@ import type { AnyNode, AnyNodeId } from '../schema/types.js';
  * coincides with the solid above it.
  */
 export declare const CEILING_CLAMP_MARGIN = 0.01;
+/** Metres added per level ordinal in Exploded view, also used to frame agent captures. */
+export declare const EXPLODED_GAP = 5;
 /**
  * Stored storey height in meters (floor-to-floor). Falls back to
  * {@link DEFAULT_LEVEL_HEIGHT} for unmigrated legacy levels whose `height`
@@ -21,6 +23,47 @@ export type LevelElevation = {
     ordinal: number;
 };
 export declare function getLevelElevations(nodes: Record<AnyNodeId, AnyNode>): Map<string, LevelElevation>;
+export declare function getAuthoredLevelElevations(nodes: Readonly<Record<string, AnyNode>>): Map<string, LevelElevation>;
+/**
+ * How far under the ground a floor has to sit to be below grade. A ground floor a few centimetres
+ * under the lawn (a basement deeper than it is tall pushes the stack down) stays a ground floor.
+ */
+export declare const BELOW_GRADE_TOLERANCE = 0.3;
+/**
+ * The world Y of `levelId`'s own plane, the one its slabs' `elevation`s are measured from: the
+ * stacked base and the building's height on the site. A floor slab's top is this plus its
+ * elevation. `null` for an id that is no level.
+ */
+export declare function levelPlaneWorldY(nodes: Record<AnyNodeId, AnyNode>, levelId: string): number | null;
+/**
+ * `levelId`'s world floor: the stacked base, the building's height on the site and the top of
+ * the highest slab it stands on. `null` for an id that is no level. A level with floors at
+ * several heights (a split level) has no single floor: this is the highest, and what asks where
+ * the ground stands over a floor asks per slab ({@link levelPlaneWorldY} plus the slab's
+ * elevation).
+ */
+export declare function levelFloorWorldY(nodes: Record<AnyNodeId, AnyNode>, levelId: string): number | null;
+/**
+ * The world Y of the top of the lowest floor slab `levelId` stands on: the floor a pit under the
+ * level has to go down to, the sunken room of a split level included ({@link levelFloorWorldY} is
+ * the highest). The same as `levelFloorWorldY` for a level with one floor, or none. `null` for an
+ * id that is no level.
+ */
+export declare function levelLowestFloorWorldY(nodes: Record<AnyNodeId, AnyNode>, levelId: string): number | null;
+/**
+ * The world Y of the underside of `levelId`'s lowest floor plate, never above the walls' base: the
+ * plane the foundation under the level tops out at, and the one the pit under the hole keeps its
+ * own floor clear of. `null` for an id that is no level.
+ */
+export declare function levelPlateUndersideWorldY(nodes: Record<AnyNodeId, AnyNode>, levelId: string): number | null;
+/**
+ * Whether `levelId` lies wholly below the flat site's grade (Y 0): its standing floor, the highest
+ * of its floor slabs, is under it by more than {@link BELOW_GRADE_TOLERANCE}. The level as a
+ * whole, which is what deriving a building's ground level asks. Sculpted terrain is not consulted,
+ * and neither is a lower floor of a split level: ask `levelGradeStanding`, which judges each floor
+ * against the datum or the terrain. `false` for an id that is no level.
+ */
+export declare function isLevelBelowGrade(nodes: Record<AnyNodeId, AnyNode>, levelId: string): boolean;
 export declare function getLevelFloorToFloorHeight(levelId: string, nodes: Record<AnyNodeId, AnyNode>): number;
 /**
  * The id of the level directly above `levelId` in its own stack (same
@@ -71,13 +114,19 @@ export declare function getCoveringSlabUndersideAt(levelId: string, nodes: Recor
  * edge's orientation (one wall clamped, its neighbor didn't). Boundary
  * contact counts as covered on every side of the slab.
  *
- * This is THE plane for a plane-bound wall (`height` absent). Explicit-height
- * walls ignore the value (`resolveWallTop` returns their stored height), so
- * passing it wherever a raw storey height feeds `resolveWallTop` /
- * `resolveWallEffectiveHeight` is always safe. Falls back to
+ * Use {@link getWallTop} to resolve a wall's top with its elected base and
+ * raw authored storey height, independently of this plane. Falls back to
  * {@link DEFAULT_LEVEL_HEIGHT} when `levelId` doesn't resolve to a level.
  */
 export declare function getWallPlaneTop(wall: Pick<WallNode, 'start' | 'end'> & Partial<Pick<WallNode, 'thickness' | 'curveOffset'>>, levelId: string, nodes: Record<AnyNodeId, AnyNode>): number;
+export declare function getWallTop(wall: WallNode, levelId: string, nodes: Record<AnyNodeId, AnyNode>, electedBase: number): number;
+export declare function getWallCoveringSlabUnderside(wall: Pick<WallNode, 'start' | 'end'> & Partial<Pick<WallNode, 'thickness' | 'curveOffset'>>, levelId: string, nodes: Record<AnyNodeId, AnyNode>): number | null;
+export declare function getWallCoveringSlabs(wall: Pick<WallNode, 'start' | 'end'> & Partial<Pick<WallNode, 'thickness' | 'curveOffset'>>, levelId: string, nodes: Record<AnyNodeId, AnyNode>): Array<{
+    slab: SlabNode;
+    underside: number;
+    top: number;
+}>;
+export declare function getWallPlaneTops(walls: readonly WallNode[], levelId: string, nodes: Record<AnyNodeId, AnyNode>): Map<string, number>;
 /**
  * Upper bound for a ceiling's stored height over `polygon` on `levelId`:
  * `min(storey plane, lowest covering-slab underside) - CEILING_CLAMP_MARGIN`.
@@ -92,5 +141,22 @@ export declare function getWallPlaneTop(wall: Pick<WallNode, 'start' | 'end'> &
  * Returns `Infinity` when `levelId` doesn't resolve, so callers clamp
  * against nothing rather than a garbage plane.
  */
-export declare function getCeilingClampBound(levelId: string, nodes: Record<AnyNodeId, AnyNode>, polygon: ReadonlyArray<[number, number]>): number;
+export declare function getCeilingClampBound(levelId: string, nodes: Record<AnyNodeId, AnyNode>, polygon: ReadonlyArray<[number, number]>, wallTop?: number): number;
+/**
+ * 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 declare const CEILING_DRAW_OFFSET = 0.01;
+export declare function getCeilingMinHeight(levelId: string, nodes: Record<AnyNodeId, AnyNode>, atGrade: number): number;
 //# sourceMappingURL=storey.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"storey.d.ts","sourceRoot":"","sources":["../../src/services/storey.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,SAAS,EAAY,QAAQ,EAAE,MAAM,WAAW,CAAA;AAC5E,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAQzD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,OAAO,CAAA;AAExC;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,GAAG,MAAM,CAE7E;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,6FAA6F;IAC7F,KAAK,EAAE,MAAM,CAAA;IACb,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAgCD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAqCjG;AAeD,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,GAChC,MAAM,CAER;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,GACtC,MAAM,GAAG,IAAI,CAef;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,GAChC,SAAS,GAAG,IAAI,CAKlB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,GACtC,MAAM,GAAG,IAAI,CAef;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,GAChC,SAAS,GAAG,IAAI,CAKlB;AA+FD;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,EACjC,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR,MAAM,GAAG,IAAI,CAIf;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,GAAG,aAAa,CAAC,CAAC,EAC5F,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,GAChC,MAAM,CAYR;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,EACjC,OAAO,EAAE,aAAa,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACvC,MAAM,CAuBR"}
+{"version":3,"file":"storey.d.ts","sourceRoot":"","sources":["../../src/services/storey.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAgB,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAC5E,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AASzD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,OAAO,CAAA;AAExC,0FAA0F;AAC1F,eAAO,MAAM,YAAY,IAAI,CAAA;AAE7B;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,GAAG,MAAM,CAE7E;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,6FAA6F;IAC7F,KAAK,EAAE,MAAM,CAAA;IACb,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAiCD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAWjG;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACvC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAqC7B;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,MAAM,CAAA;AAExC;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,EACjC,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,IAAI,CAOf;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,EACjC,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,IAAI,CAKf;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,EACjC,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,IAAI,CAWf;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,EACjC,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,IAAI,CAWf;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAG7F;AAoCD,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,GAChC,MAAM,CAER;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,GACtC,MAAM,GAAG,IAAI,CAef;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,GAChC,SAAS,GAAG,IAAI,CAKlB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,GACtC,MAAM,GAAG,IAAI,CAef;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,GAChC,SAAS,GAAG,IAAI,CAKlB;AAoID;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,EACjC,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR,MAAM,GAAG,IAAI,CAIf;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,GAAG,aAAa,CAAC,CAAC,EAC5F,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,GAChC,MAAM,CAER;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,EACjC,WAAW,EAAE,MAAM,GAClB,MAAM,CASR;AAED,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,GAAG,aAAa,CAAC,CAAC,EAC5F,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,GAChC,MAAM,GAAG,IAAI,CAGf;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,WAAW,GAAG,aAAa,CAAC,CAAC,EAC5F,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,GAChC,KAAK,CAAC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAU3D;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,GAChC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAGrB;AAuBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,EACjC,OAAO,EAAE,aAAa,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EACxC,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CA6BR;AAED;;;;;;;;;GASG;AACH;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,OAAO,CAAA;AAEvC,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,EACjC,OAAO,EAAE,MAAM,GACd,MAAM,CAGR"}

package/dist/services/storey.js

@@ -1,4 +1,9 @@
+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 { isSiteFlatwork } from '../lib/site-flatwork.js';
 import { pointInPolygon, pointOnPolygonBoundary, wallOverlapsSlabFootprint, } from '../systems/slab/slab-support.js';
+import { resolveWallTop } from '../systems/wall/wall-top.js';
 import { DEFAULT_LEVEL_HEIGHT } from './level-height.js';
 /**
  * Gap kept between a ceiling's stored height and its clamp bound (storey
@@ -6,6 +11,8 @@ import { DEFAULT_LEVEL_HEIGHT } from './level-height.js';
  * coincides with the solid above it.
  */
 export const CEILING_CLAMP_MARGIN = 0.01;
+/** Metres added per level ordinal in Exploded view, also used to frame agent captures. */
+export const EXPLODED_GAP = 5;
 /**
  * Stored storey height in meters (floor-to-floor). Falls back to
  * {@link DEFAULT_LEVEL_HEIGHT} for unmigrated legacy levels whose `height`
@@ -38,8 +45,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,9 +91,112 @@ export function getLevelElevations(nodes) {
         });
         cumulativeYByBuilding.set(entry.buildingId, baseY + entry.height);
     }
-    elevationMemo.set(nodes, elevations);
+    authoredElevationMemo.set(nodes, elevations);
     return elevations;
 }
+/**
+ * How far under the ground a floor has to sit to be below grade. A ground floor a few centimetres
+ * under the lawn (a basement deeper than it is tall pushes the stack down) stays a ground floor.
+ */
+export const BELOW_GRADE_TOLERANCE = 0.3;
+/**
+ * The world Y of `levelId`'s own plane, the one its slabs' `elevation`s are measured from: the
+ * stacked base and the building's height on the site. A floor slab's top is this plus its
+ * elevation. `null` for an id that is no level.
+ */
+export function levelPlaneWorldY(nodes, levelId) {
+    const elevation = getLevelElevations(nodes).get(levelId);
+    const level = nodes[levelId];
+    if (!elevation || level?.type !== 'level')
+        return null;
+    const building = elevation.buildingId ? nodes[elevation.buildingId] : undefined;
+    const siteY = building?.type === 'building' ? building.position[1] : 0;
+    return siteY + elevation.baseY;
+}
+/**
+ * `levelId`'s world floor: the stacked base, the building's height on the site and the top of
+ * the highest slab it stands on. `null` for an id that is no level. A level with floors at
+ * several heights (a split level) has no single floor: this is the highest, and what asks where
+ * the ground stands over a floor asks per slab ({@link levelPlaneWorldY} plus the slab's
+ * elevation).
+ */
+export function levelFloorWorldY(nodes, levelId) {
+    const plane = levelPlaneWorldY(nodes, levelId);
+    const level = nodes[levelId];
+    if (plane === null || level?.type !== 'level')
+        return null;
+    return plane + standingSlabTop(nodes, level);
+}
+/**
+ * The world Y of the top of the lowest floor slab `levelId` stands on: the floor a pit under the
+ * level has to go down to, the sunken room of a split level included ({@link levelFloorWorldY} is
+ * the highest). The same as `levelFloorWorldY` for a level with one floor, or none. `null` for an
+ * id that is no level.
+ */
+export function levelLowestFloorWorldY(nodes, levelId) {
+    const plane = levelPlaneWorldY(nodes, levelId);
+    const level = nodes[levelId];
+    if (plane === null || level?.type !== 'level')
+        return null;
+    let lowest = null;
+    for (const childId of level.children) {
+        const child = nodes[childId];
+        if (!isFloorSlab(child))
+            continue;
+        lowest = Math.min(lowest ?? child.elevation, child.elevation);
+    }
+    return plane + (lowest ?? 0);
+}
+/**
+ * The world Y of the underside of `levelId`'s lowest floor plate, never above the walls' base: the
+ * plane the foundation under the level tops out at, and the one the pit under the hole keeps its
+ * own floor clear of. `null` for an id that is no level.
+ */
+export function levelPlateUndersideWorldY(nodes, levelId) {
+    const baseY = levelPlaneWorldY(nodes, levelId);
+    const level = nodes[levelId];
+    if (baseY === null || level?.type !== 'level')
+        return null;
+    let underside = baseY;
+    for (const childId of level.children) {
+        const child = nodes[childId];
+        if (!isFloorSlab(child))
+            continue;
+        underside = Math.min(underside, baseY + child.elevation - child.thickness);
+    }
+    return underside;
+}
+/**
+ * Whether `levelId` lies wholly below the flat site's grade (Y 0): its standing floor, the highest
+ * of its floor slabs, is under it by more than {@link BELOW_GRADE_TOLERANCE}. The level as a
+ * whole, which is what deriving a building's ground level asks. Sculpted terrain is not consulted,
+ * and neither is a lower floor of a split level: ask `levelGradeStanding`, which judges each floor
+ * against the datum or the terrain. `false` for an id that is no level.
+ */
+export function isLevelBelowGrade(nodes, levelId) {
+    const floorY = levelFloorWorldY(nodes, levelId);
+    return floorY !== null && floorY < -BELOW_GRADE_TOLERANCE;
+}
+/**
+ * Whether a node is a floor slab of the house a level stands on: not a recessed one (a pit or a
+ * basin, drawn down into the floor) and not site flatwork (a lawn, a driveway: outdoors, laid on the
+ * level for its elevation only). Where a level's floors are, how high and how deep, is read off
+ * these alone.
+ */
+function isFloorSlab(node) {
+    return node?.type === 'slab' && node.recessed !== true && !isSiteFlatwork(node);
+}
+/** The top of the highest floor slab a level stands on, in its own Y; 0 for a level with none. */
+function standingSlabTop(nodes, level) {
+    let top = null;
+    for (const childId of level.children) {
+        const child = nodes[childId];
+        if (!isFloorSlab(child))
+            continue;
+        top = Math.max(top ?? child.elevation, child.elevation);
+    }
+    return top ?? 0;
+}
 function resolveLevelFloorToFloorHeight(levelId, elevations) {
     const current = elevations.get(levelId);
     if (!current)
@@ -154,6 +279,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 +287,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 +319,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
@@ -265,17 +415,45 @@ export function getCoveringSlabUndersideAt(levelId, nodes, x, z) {
  * edge's orientation (one wall clamped, its neighbor didn't). Boundary
  * contact counts as covered on every side of the slab.
  *
- * This is THE plane for a plane-bound wall (`height` absent). Explicit-height
- * walls ignore the value (`resolveWallTop` returns their stored height), so
- * passing it wherever a raw storey height feeds `resolveWallTop` /
- * `resolveWallEffectiveHeight` is always safe. Falls back to
+ * Use {@link getWallTop} to resolve a wall's top with its elected base and
+ * raw authored storey height, independently of this plane. Falls back to
  * {@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 getWallTop(wall, levelId, nodes, electedBase) {
+    const level = nodes[levelId];
+    const authoredStoreyHeight = level?.type === 'level' ? (level.height ?? null) : null;
+    return resolveWallTop(wall, getWallPlaneTop(wall, levelId, nodes), electedBase, authoredStoreyHeight);
+}
+export function getWallCoveringSlabUnderside(wall, levelId, nodes) {
+    const undersides = getWallCoveringSlabs(wall, levelId, nodes).map(({ underside }) => underside);
+    return undersides.length ? Math.min(...undersides) : null;
+}
+export function getWallCoveringSlabs(wall, levelId, nodes) {
+    const context = resolveCoveringSlabContext(levelId, nodes);
+    if (!context)
+        return [];
+    return context.slabs
+        .filter((slab) => wallOverlapsSlabFootprint(wall, slab.polygon, slab.holes))
+        .map((slab) => ({
+        slab,
+        underside: coveringUndersideY(context.floorToFloorHeight, slab),
+        top: context.floorToFloorHeight + slab.elevation,
+    }));
+}
+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 +478,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 +507,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.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

@@ -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]],

package/dist/solar-panel-presets.d.ts

@@ -1,9 +1,9 @@
 import { z } from 'zod';
 export declare const SolarPanelPresetKey: z.ZodEnum<{
-    residential: "residential";
-    "residential-large": "residential-large";
     compact: "compact";
     frameless: "frameless";
+    residential: "residential";
+    "residential-large": "residential-large";
 }>;
 export type SolarPanelPresetKey = z.infer<typeof SolarPanelPresetKey>;
 export type SolarPanelPresetDims = {