@pascal-app/core 1.0.6 → 1.1.0

package/dist/lib/structure-kernel.d.ts

@@ -1,4 +1,4 @@
-import type { AnyNode, AnyNodeId, WallNode } from '../schema/index.js';
+import type { AnyNode, AnyNodeId, SeparatorNode, WallNode } from '../schema/index.js';
 import type { ZoneNode } from '../schema/nodes/zone.js';
 import { type FloorOpeningIndex } from './floor-opening-intent.js';
 import { type Polygon, type Ring } from './polygon-boolean.js';
@@ -33,31 +33,44 @@ export type LevelStructureSnapshot = {
     rooms: StructureRoom[];
 };
 /**
- * The rooms that are outside: without a ceiling, and left without crossing a wall, through a
- * separator no room stands behind or into another such room. A porch made a room for its floor
- * left its wall with no outside: the front door faced the hall. A room that only lost its
- * ceiling is walled in and a kitchen open to a terrace keeps its ceiling, so both stay inside; so
- * does a courtyard walled on every side, a limit of this rule.
+ * The rooms closed off outside the house, and what they are by default: open to the outside across
+ * invisible walls or railings nothing stands behind, along at least as much of their edge as walls
+ * close (a porch on the front, or in a corner of the house). Closed with invisible walls, a porch;
+ * fenced with railings alone, a deck. A room walled on three sides and open on the fourth (a
+ * kitchen open to a terrace, a recessed porch) is not one of them. `lengthOf` is a wall's or a
+ * separator's length; `railingIds` the railing walls.
+ */
+export declare function outsideRoomTypes(rooms: readonly {
+    spans: readonly BoundarySpan[];
+}[], lengthOf: (boundaryId: string) => number, railingIds?: ReadonlySet<string>): Map<string, 'porch' | 'deck'>;
+/**
+ * The rooms that are outside: a porch, deck or patio (`roomType`, outdoors whatever covers it), and
+ * a room without a ceiling left without crossing a wall, through a separator no room stands behind
+ * or into another such room. A porch made a room for its floor left its wall with no outside: the
+ * front door faced the hall. A room that only lost its ceiling is walled in and a kitchen open to a
+ * terrace keeps its ceiling, so both stay inside; so does a courtyard walled on every side, a limit
+ * of this rule.
  */
 export declare function outdoorRoomIds(rooms: readonly {
     spans: readonly BoundarySpan[];
     hasCeiling: boolean;
+    outdoor?: boolean;
 }[]): Set<string>;
 /** A wall face is inside when an indoor room stands on it; an outdoor room's face is outside. */
 export declare function classifyWallSides(wall: WallNode, spans: readonly BoundarySpan[], outdoor?: ReadonlySet<string>): Pick<WallNode, 'frontSide' | 'backSide'>;
 export declare function reconcileLevelStructure(input: Parameters<typeof planLevelStructure>[0]): ReturnType<typeof planLevelStructure>;
-declare function planLevelStructure({ levelId, nodes, mintId, openingIndex, }: {
+declare function planLevelStructure({ levelId, nodes, previousNodes, mintId, openingIndex, }: {
     levelId: string;
     nodes: SceneNodes;
     previousNodes?: SceneNodes;
-    mintId: (kind: 'zone' | 'ceiling' | 'slab' | 'separator') => string;
+    mintId: (kind: 'zone' | 'ceiling' | 'slab' | 'separator' | 'column' | 'beam') => string;
     openingIndex?: FloorOpeningIndex;
 }): {
     patches: NodePatch[];
     snapshot: LevelStructureSnapshot;
     events: StructureEvent[];
 };
-export declare function createLevelStructurePreview(levelId: string, nodes: SceneNodes): (walls: readonly WallNode[]) => {
+export declare function createLevelStructurePreview(levelId: string, nodes: SceneNodes): (walls: readonly WallNode[], separators?: readonly SeparatorNode[]) => {
     op: 'update';
     id: AnyNodeId;
     data: Partial<AnyNode>;

package/dist/lib/structure-kernel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"structure-kernel.d.ts","sourceRoot":"","sources":["../../src/lib/structure-kernel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAiB,QAAQ,EAAE,MAAM,WAAW,CAAA;AAI5E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAWpD,OAAO,EAAE,KAAK,iBAAiB,EAAsB,MAAM,wBAAwB,CAAA;AAOnF,OAAO,EAKL,KAAK,OAAO,EACZ,KAAK,IAAI,EAEV,MAAM,mBAAmB,CAAA;AAI1B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAUzD,eAAO,MAAM,+BAA+B,MAAM,CAAA;AAElD,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AAC1D,MAAM,MAAM,SAAS,GACjB;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC/B;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;CAAE,GACvD;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,SAAS,CAAA;CAAE,CAAA;AACnC,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAA;IAC/D,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AACD,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAA;IACtB,OAAO,EAAE,IAAI,CAAA;IACb,KAAK,EAAE,IAAI,EAAE,CAAA;IACb,KAAK,EAAE,OAAO,CAAA;IACd,KAAK,EAAE,YAAY,EAAE,CAAA;CACtB,CAAA;AACD,MAAM,MAAM,sBAAsB,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,aAAa,EAAE,CAAA;CAAE,CAAA;AAuDhF;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS;IAAE,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,EAAE,GACxE,GAAG,CAAC,MAAM,CAAC,CAuCb;AAED,iGAAiG;AACjG,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,OAAO,GAAE,WAAW,CAAC,MAAM,CAAa,GACvC,IAAI,CAAC,QAAQ,EAAE,WAAW,GAAG,UAAU,CAAC,CAU1C;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAAC,GAC9C,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAiBvC;AAED,iBAAS,kBAAkB,CAAC,EAC1B,OAAO,EACP,KAAK,EACL,MAAM,EACN,YAAY,GACb,EAAE;IACD,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,UAAU,CAAA;IACjB,aAAa,CAAC,EAAE,UAAU,CAAA;IAC1B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,WAAW,KAAK,MAAM,CAAA;IACnE,YAAY,CAAC,EAAE,iBAAiB,CAAA;CACjC,GAAG;IAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IAAC,QAAQ,EAAE,sBAAsB,CAAC;IAAC,MAAM,EAAE,cAAc,EAAE,CAAA;CAAE,CA0nBvF;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,WAuC7D,SAAS,QAAQ,EAAE;QA30B1B,QAAQ;QAAM,SAAS;UAAQ,OAAO,CAAC,OAAO,CAAC;IAq2BxD"}
+{"version":3,"file":"structure-kernel.d.ts","sourceRoot":"","sources":["../../src/lib/structure-kernel.ts"],"names":[],"mappings":"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"}

package/dist/lib/structure-kernel.js

@@ -12,9 +12,12 @@ import { buildFloorPlates, warnPlateFailure } from './floor-plates.js';
 import { floorRoomFaces } from './floor-room-faces.js';
 import { remapFloorStepOverrideKeys } from './floor-step-finish.js';
 import { newZone } from './new-zone.js';
+import { isOutdoorRoom, nextOutdoorRoomName, OUTDOOR_ROOM_DEFAULTS } from './outdoor-room.js';
 import { replacementPlateFor } from './plate-reference.js';
 import { area, containsPoint, difference, intersection, union, } from './polygon-boolean.js';
 import { polygonInteriorPoint } from './polygon-label.js';
+import { reconcilePorchFraming } from './porch-framing-sync.js';
+import { railingFencedRoomIds, railingWallIds } from './railing-rooms.js';
 import { pointFromTuple } from './room-graph.js';
 import { roomNameAllocator } from './room-name.js';
 import { adoptableFace, compareAdoptionFits, compareExistingRooms, existingRoomFace, zoneFaceFits, } from './room-zone-adoption.js';
@@ -61,14 +64,42 @@ function equal(a, b) {
 /** Span overlap below this (a fraction of the boundary) is a shared endpoint, not a shared edge. */
 const SPAN_OVERLAP = 1e-6;
 /**
- * The rooms that are outside: without a ceiling, and left without crossing a wall, through a
- * separator no room stands behind or into another such room. A porch made a room for its floor
- * left its wall with no outside: the front door faced the hall. A room that only lost its
- * ceiling is walled in and a kitchen open to a terrace keeps its ceiling, so both stay inside; so
- * does a courtyard walled on every side, a limit of this rule.
+ * The rooms closed off outside the house, and what they are by default: open to the outside across
+ * invisible walls or railings nothing stands behind, along at least as much of their edge as walls
+ * close (a porch on the front, or in a corner of the house). Closed with invisible walls, a porch;
+ * fenced with railings alone, a deck. A room walled on three sides and open on the fourth (a
+ * kitchen open to a terrace, a recessed porch) is not one of them. `lengthOf` is a wall's or a
+ * separator's length; `railingIds` the railing walls.
  */
-export function outdoorRoomIds(rooms) {
-    const separatorSpans = rooms.flatMap((room) => room.spans.filter((span) => span.kind === 'separator'));
+export function outsideRoomTypes(rooms, lengthOf, railingIds = new Set()) {
+    const railing = (span) => span.kind === 'wall' && railingIds.has(span.boundaryId);
+    const { exposed } = openLineExposure(rooms, (span) => span.kind === 'separator' || railing(span));
+    const spanLength = (span) => (span.t1 - span.t0) * lengthOf(span.boundaryId);
+    const types = new Map();
+    for (const room of rooms) {
+        let open = 0;
+        let walled = 0;
+        let invisible = false;
+        for (const span of room.spans) {
+            if (span.kind === 'wall' && !railing(span))
+                walled += spanLength(span);
+            else if (exposed(span)) {
+                open += spanLength(span);
+                invisible ||= span.kind === 'separator';
+            }
+        }
+        if (room.spans[0] && open > 0 && open >= walled - 1e-6)
+            types.set(room.spans[0].roomId, invisible ? 'porch' : 'deck');
+    }
+    return types;
+}
+/** Each separator span's spans across it, and whether any stretch of it has none. */
+function separatorExposure(rooms) {
+    return openLineExposure(rooms, (span) => span.kind === 'separator');
+}
+/** Each open line's span (`isOpen`): the spans across it, and whether any stretch of it has none. */
+function openLineExposure(rooms, isOpen) {
+    const separatorSpans = rooms.flatMap((room) => room.spans.filter(isOpen));
     const across = (span) => separatorSpans
         .filter((other) => other.boundaryId === span.boundaryId &&
         other.face !== span.face &&
@@ -83,8 +114,25 @@ export function outdoorRoomIds(rooms) {
         }
         return reach < span.t1 - SPAN_OVERLAP;
     };
-    const open = new Map(rooms.flatMap((room) => !room.hasCeiling && room.spans[0] ? [[room.spans[0].roomId, room.spans]] : []));
-    const queue = [...open].flatMap(([id, spans]) => spans.some((span) => span.kind === 'separator' && exposed(span)) ? [id] : []);
+    return { across, exposed };
+}
+/**
+ * The rooms that are outside: a porch, deck or patio (`roomType`, outdoors whatever covers it), and
+ * a room without a ceiling left without crossing a wall, through a separator no room stands behind
+ * or into another such room. A porch made a room for its floor left its wall with no outside: the
+ * front door faced the hall. A room that only lost its ceiling is walled in and a kitchen open to a
+ * terrace keeps its ceiling, so both stay inside; so does a courtyard walled on every side, a limit
+ * of this rule.
+ */
+export function outdoorRoomIds(rooms) {
+    const { across, exposed } = separatorExposure(rooms);
+    const open = new Map(rooms.flatMap((room) => (!room.hasCeiling || room.outdoor) && room.spans[0]
+        ? [[room.spans[0].roomId, room.spans]]
+        : []));
+    const declared = new Set(rooms.flatMap((room) => (room.outdoor && room.spans[0] ? [room.spans[0].roomId] : [])));
+    const queue = [...open].flatMap(([id, spans]) => declared.has(id) || spans.some((span) => span.kind === 'separator' && exposed(span))
+        ? [id]
+        : []);
     const outdoor = new Set(queue);
     for (let id = queue.pop(); id !== undefined; id = queue.pop())
         for (const span of open.get(id))
@@ -122,7 +170,7 @@ export function reconcileLevelStructure(input) {
         return { patches: [], snapshot: { levelId: input.levelId, rooms: [] }, events: [] };
     }
 }
-function planLevelStructure({ levelId, nodes, mintId, openingIndex, }) {
+function planLevelStructure({ levelId, nodes, previousNodes, mintId, openingIndex, }) {
     const snapshot = { levelId, rooms: [] };
     const events = [];
     const level = nodes[levelId];
@@ -200,6 +248,14 @@ function planLevelStructure({ levelId, nodes, mintId, openingIndex, }) {
     const zoneByFace = new Map();
     const retiredTo = new Map();
     const nextRoomName = roomNameAllocator(allZones);
+    // A new room closed off outside the house is a porch, or a deck when railings fence it
+    // (`lib/outdoor-room`).
+    const boundaryLengths = new Map([...walls, ...separators].map((boundary) => [
+        boundary.id,
+        Math.hypot(boundary.end[0] - boundary.start[0], boundary.end[1] - boundary.start[1]),
+    ]));
+    const outsideTypes = outsideRoomTypes(faces, (id) => boundaryLengths.get(id) ?? 0, railingWallIds(walls));
+    const roomNames = allZones.map((zone) => zone.name);
     faces.forEach((face, index) => {
         const rooms = zones
             .filter((zone) => preferred.get(zone.id) === index && !adoptionFits.has(zone.id))
@@ -219,20 +275,37 @@ function planLevelStructure({ levelId, nodes, mintId, openingIndex, }) {
                 .sort((a, b) => scores.get(b.id)[index] - scores.get(a.id)[index] || compareIds(a.id, b.id))[0];
         if (source)
             sourceByFace.set(index, source);
+        const outside = !survivor && !source && face.spans[0] ? outsideTypes.get(face.spans[0].roomId) : undefined;
         const zone = survivor ??
-            newZone({
-                id: mintId('zone'),
-                parentId: levelId,
-                name: nextRoomName(),
-                polygon: face.polygon.outer,
-                floor: source?.floor,
-                wallMaterial: source?.wallMaterial,
-                floorStepFinish: source?.floorStepFinish,
-                floorStepOverrides: source?.floorStepOverrides,
-                floorEdgeFinish: source?.floorEdgeFinish,
-                hasFloor: source?.hasFloor,
-                hasCeiling: source?.hasCeiling,
-            });
+            (outside
+                ? newZone({
+                    id: mintId('zone'),
+                    parentId: levelId,
+                    name: nextOutdoorRoomName(outside, roomNames),
+                    polygon: face.polygon.outer,
+                    roomType: outside,
+                    floor: {
+                        drop: OUTDOOR_ROOM_DEFAULTS[outside].drop,
+                        finish: OUTDOOR_ROOM_DEFAULTS[outside].finish,
+                    },
+                    ...(OUTDOOR_ROOM_DEFAULTS[outside].covered ? {} : { hasCeiling: false }),
+                })
+                : newZone({
+                    id: mintId('zone'),
+                    parentId: levelId,
+                    name: nextRoomName(),
+                    polygon: face.polygon.outer,
+                    floor: source?.floor,
+                    wallMaterial: source?.wallMaterial,
+                    floorStepFinish: source?.floorStepFinish,
+                    floorStepOverrides: source?.floorStepOverrides,
+                    floorEdgeFinish: source?.floorEdgeFinish,
+                    hasFloor: source?.hasFloor,
+                    hasCeiling: source?.hasCeiling,
+                    roomType: source?.roomType,
+                }));
+        if (outside)
+            roomNames.push(zone.name);
         const seed = zone.seed && containsPoint([face.polygon], zone.seed)
             ? zone.seed
             : polygonInteriorPoint({ polygon: face.polygon.outer, holes: face.polygon.holes }, !zone.seed);
@@ -447,6 +520,7 @@ function planLevelStructure({ levelId, nodes, mintId, openingIndex, }) {
                 material: template?.material,
                 materialPreset: template?.materialPreset,
                 slots: template?.slots,
+                buildUp: template?.buildUp,
                 visible: template?.visible,
             });
         const updated = {
@@ -594,11 +668,36 @@ function planLevelStructure({ levelId, nodes, mintId, openingIndex, }) {
     for (const components of ceilingComponentsByFace.values())
         for (const ceiling of components)
             ceiling.children = [...new Set(ceiling.children)].sort();
+    // A covered porch's posts and beam (`lib/porch-framing-sync`).
+    const porchFraming = reconcilePorchFraming({
+        levelId,
+        nodes,
+        previousNodes,
+        zones: [
+            ...new Map([...allZones, ...next.values()].flatMap((zone) => zone.type === 'zone' && !deleted.has(zone.id)
+                ? [[zone.id, (next.get(zone.id) ?? zone)]]
+                : [])).values(),
+        ],
+        plates: floorPlan.plates,
+        current: (id) => next.get(id) ?? nodes[id],
+        mintId,
+    });
+    for (const node of porchFraming.put)
+        put(node);
+    for (const id of porchFraming.delete)
+        deleted.add(id);
     const spans = snapshot.rooms.flatMap((room) => room.spans);
-    const outdoor = outdoorRoomIds([...zoneByFace].map(([index, zone]) => ({
-        spans: faces[index].spans,
-        hasCeiling: (next.get(zone.id) ?? zone).hasCeiling !== false,
-    })));
+    const outdoor = outdoorRoomIds([...zoneByFace].map(([index, zone]) => {
+        const current = (next.get(zone.id) ?? zone);
+        return {
+            spans: faces[index].spans,
+            hasCeiling: current.hasCeiling !== false,
+            outdoor: isOutdoorRoom(current),
+        };
+    }));
+    // A room a railing fences off from the outside (a deck's guard) is outside too.
+    for (const id of railingFencedRoomIds(spans, railingWallIds(walls)))
+        outdoor.add(id);
     for (const wall of walls)
         put({ ...wall, ...next.get(wall.id), ...classifyWallSides(wall, spans, outdoor) });
     for (const ceiling of allCeilings) {
@@ -706,7 +805,12 @@ export function createLevelStructurePreview(levelId, nodes) {
     let wallIds = new Set(Object.values(draft)
         .filter((node) => node.type === 'wall' && node.parentId === levelId)
         .map((node) => node.id));
-    return (walls) => {
+    let separatorIds = new Set(Object.values(draft)
+        .filter((node) => node.type === 'separator' && node.parentId === levelId)
+        .map((node) => node.id));
+    // `separators`, when given, are the level's invisible walls as the gesture
+    // leaves them (an invisible-wall push); left out, the stored ones stand.
+    return (walls, separators) => {
         const currentIds = new Set();
         for (const wall of walls) {
             if (wall.parentId !== levelId)
@@ -720,6 +824,20 @@ export function createLevelStructurePreview(levelId, nodes) {
             if (!currentIds.has(id))
                 delete draft[id];
         wallIds = currentIds;
+        if (separators) {
+            const current = new Set();
+            for (const separator of separators) {
+                if (separator.parentId !== levelId)
+                    continue;
+                current.add(separator.id);
+                if (draft[separator.id] !== separator)
+                    draft[separator.id] = separator;
+            }
+            for (const id of separatorIds)
+                if (!current.has(id))
+                    delete draft[id];
+            separatorIds = current;
+        }
         let id = 0;
         // The stored surfaces are the committed reconciliation; only what the
         // moved walls reshape differs from them.

package/dist/lib/structure-reconcile.d.ts

@@ -1,5 +1,5 @@
 import { type NodePatch, type SceneNodes, type StructureEvent } from './structure-kernel.js';
-export type StructureIdFactory = (kind: 'zone' | 'ceiling' | 'slab' | 'separator') => string;
+export type StructureIdFactory = (kind: 'zone' | 'ceiling' | 'slab' | 'separator' | 'column' | 'beam') => string;
 export type SceneStructureInput = {
     nodes: SceneNodes;
     levelIds?: string[];

package/dist/lib/structure-reconcile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"structure-reconcile.d.ts","sourceRoot":"","sources":["../../src/lib/structure-reconcile.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,KAAK,SAAS,EAEd,KAAK,UAAU,EACf,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAA;AAE3B,MAAM,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,WAAW,KAAK,MAAM,CAAA;AAC5F,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,UAAU,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,MAAM,EAAE,kBAAkB,CAAA;IAC1B,aAAa,CAAC,EAAE,UAAU,CAAA;CAC3B,CAAA;AACD,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,UAAU,CAAA;IACjB,OAAO,EAAE,SAAS,EAAE,CAAA;IACpB,MAAM,EAAE,cAAc,EAAE,CAAA;CACzB,CAAA;AAyED,wBAAgB,uBAAuB,CAAC,EACtC,KAAK,EACL,QAAQ,EACR,MAAM,EACN,aAAa,GACd,EAAE,mBAAmB,GAAG,oBAAoB,CA+K5C"}
+{"version":3,"file":"structure-reconcile.d.ts","sourceRoot":"","sources":["../../src/lib/structure-reconcile.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,KAAK,SAAS,EAEd,KAAK,UAAU,EACf,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAA;AAG3B,MAAM,MAAM,kBAAkB,GAAG,CAC/B,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,KAChE,MAAM,CAAA;AACX,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,UAAU,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,MAAM,EAAE,kBAAkB,CAAA;IAC1B,aAAa,CAAC,EAAE,UAAU,CAAA;CAC3B,CAAA;AACD,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,UAAU,CAAA;IACjB,OAAO,EAAE,SAAS,EAAE,CAAA;IACpB,MAAM,EAAE,cAAc,EAAE,CAAA;CACzB,CAAA;AAyED,wBAAgB,uBAAuB,CAAC,EACtC,KAAK,EACL,QAAQ,EACR,MAAM,EACN,aAAa,GACd,EAAE,mBAAmB,GAAG,oBAAoB,CAiL5C"}

package/dist/lib/structure-reconcile.js

@@ -3,6 +3,7 @@ import { createFloorOpeningIndex } from './floor-opening-intent.js';
 import { extractRooms, pointToTuple, sampleWallPointsForRoomDetection, WALL_JUNCTION_TOLERANCE, } from './room-graph.js';
 import { RoomTopologyIndex } from './room-topology-index.js';
 import { reconcileLevelStructure, } from './structure-kernel.js';
+import { surfaceIntentZoneIds } from './surface-intent.js';
 function levelChildren(nodes, levelId) {
     return Object.values(nodes)
         .filter((node) => node.parentId === levelId)
@@ -79,13 +80,14 @@ export function reconcileSceneStructure({ nodes, levelIds, mintId, previousNodes
             return;
         const children = levelChildren(draft, levelId);
         const previousChildren = previousNodes ? levelChildren(previousNodes, levelId) : [];
+        const plates = children.filter((node) => node.type === 'slab');
         for (const surface of previousChildren) {
             if ((surface.type !== 'ceiling' && surface.type !== 'slab') ||
                 surface.boundary !== 'auto' ||
                 draft[surface.id])
                 continue;
-            const ids = surface.type === 'ceiling' ? [surface.zoneId] : (surface.zoneIds ?? []);
-            for (const id of ids) {
+            // The rooms it was the floor or ceiling of: a porch on a plate of its own keeps its floor.
+            for (const id of surfaceIntentZoneIds(surface, plates)) {
                 const zone = id ? draft[id] : undefined;
                 if (zone?.type === 'zone')
                     draft[zone.id] = {
@@ -169,9 +171,10 @@ export function reconcileSceneStructure({ nodes, levelIds, mintId, previousNodes
             if (metadata?.source !== 'floor-opening')
                 return [{ hole, metadata: metadata ?? { source: 'manual' } }];
             const opening = metadata.openingId ? draft[metadata.openingId] : undefined;
+            // An owner's cut map is complete: a surface it no longer names must heal.
             return opening?.type === 'floor-opening' &&
-                !opening.legacyPlateCuts?.[surface.id] &&
-                !opening.legacyCeilingCuts?.[surface.id]
+                !opening.legacyPlateCuts &&
+                !opening.legacyCeilingCuts
                 ? [{ hole, metadata }]
                 : [];
         });

package/dist/lib/surface-intent.d.ts

@@ -0,0 +1,10 @@
+import type { AnyNode, CeilingNode, SlabNode } from '../schema/index.js';
+/**
+ * The rooms whose construction a derived surface IS, among `plates` (the level's floor plates as
+ * they stand after the edit): a ceiling's room, and the rooms a plate is the floor of. A shared base
+ * plate also lists the rooms that stand on plates of their own (a porch or deck a step down, a raised
+ * platform), but it is not their floor, so losing it leaves theirs. Without this, deleting the house's
+ * plate took every porch and deck floor on the level with it.
+ */
+export declare function surfaceIntentZoneIds(node: SlabNode | CeilingNode, plates: readonly AnyNode[]): string[];
+//# sourceMappingURL=surface-intent.d.ts.map

package/dist/lib/surface-intent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-intent.d.ts","sourceRoot":"","sources":["../../src/lib/surface-intent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAE/D;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,QAAQ,GAAG,WAAW,EAC5B,MAAM,EAAE,SAAS,OAAO,EAAE,GACzB,MAAM,EAAE,CAaV"}

package/dist/lib/surface-intent.js

@@ -0,0 +1,18 @@
+/**
+ * The rooms whose construction a derived surface IS, among `plates` (the level's floor plates as
+ * they stand after the edit): a ceiling's room, and the rooms a plate is the floor of. A shared base
+ * plate also lists the rooms that stand on plates of their own (a porch or deck a step down, a raised
+ * platform), but it is not their floor, so losing it leaves theirs. Without this, deleting the house's
+ * plate took every porch and deck floor on the level with it.
+ */
+export function surfaceIntentZoneIds(node, plates) {
+    const ids = [
+        ...new Set(node.type === 'slab' ? (node.zoneIds ?? []) : node.zoneId ? [node.zoneId] : []),
+    ];
+    if (node.type !== 'slab' || node.plateRole !== 'base')
+        return ids;
+    const own = new Set(plates.flatMap((plate) => plate.type === 'slab' && plate.id !== node.id && plate.plateRole && plate.plateRole !== 'base'
+        ? (plate.zoneIds ?? [])
+        : []));
+    return ids.filter((id) => !own.has(id));
+}

package/dist/lib/terrain-source.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"terrain-source.d.ts","sourceRoot":"","sources":["../../src/lib/terrain-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAEpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAGnD,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,4BAA4B,CAAA;AAEnC;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,IAAI,GAAG,SAAS,GACrE,YAAY,GAAG,IAAI,CAMrB"}
+{"version":3,"file":"terrain-source.d.ts","sourceRoot":"","sources":["../../src/lib/terrain-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAGpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAGnD,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,mBAAmB,GACpB,MAAM,4BAA4B,CAAA;AAEnC;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,IAAI,GAAG,SAAS,GACrE,YAAY,GAAG,IAAI,CAMrB"}

package/dist/lib/terrain-source.js

@@ -1,3 +1,4 @@
+import { livePreviewsVisible } from '../store/live-previews.js';
 import useLiveTerrain from '../store/use-live-terrain.js';
 import { persistedTerrainFieldOf } from './terrain-source-persisted.js';
 export { commitTerrainField, persistedTerrainFieldOf, terrainFieldForEdit, } from './terrain-source-persisted.js';
@@ -18,7 +19,7 @@ export { commitTerrainField, persistedTerrainFieldOf, terrainFieldForEdit, } fro
  * showing a hill the raycast cannot hit.
  */
 export function terrainFieldOf(site) {
-    if (site?.id) {
+    if (site?.id && livePreviewsVisible()) {
         const live = useLiveTerrain.getState().fieldOf(site.id);
         if (live)
             return live;

package/dist/lib/wall-face-script.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wall-face-script.d.ts","sourceRoot":"","sources":["../../src/lib/wall-face-script.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,sBAAsB,EAEtB,cAAc,EAGf,MAAM,WAAW,CAAA;AAClB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAEpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAenE,KAAK,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AAEnD,kEAAkE;AAClE,MAAM,MAAM,YAAY,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAA;AAE7E;;;;;;;GAOG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,YAAY,CAAA;IACrB,KAAK,EAAE,YAAY,EAAE,CAAA;IACrB,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAKD,iGAAiG;AACjG,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,CAOnF;AAgID;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,QAAQ,EACd,QAAQ,CAAC,EAAE,MAAM,GAChB,oBAAoB,GAAG,IAAI,CAgC7B;AAED,0FAA0F;AAC1F,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAI5E;AAED,mGAAmG;AACnG,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,sBAAsB,EAChC,MAAM,EAAE,oBAAoB,EAC5B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,QAAQ,CAAC,EAAE,cAAc,GACxB,cAAc,CAMhB;AAKD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,QAAQ,GACb;IAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,IAAI,CAYhF;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,MAAM,GACd,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAGzB;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,SAAS,CAAA;IACjB,IAAI,EAAE,2BAA2B,CAAA;IACjC,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,OAAO,GAAG,SAAS,EACzB,IAAI,EAAE,MAAM,GACX,oBAAoB,GAAG,SAAS,CAkBlC"}
+{"version":3,"file":"wall-face-script.d.ts","sourceRoot":"","sources":["../../src/lib/wall-face-script.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,sBAAsB,EAEtB,cAAc,EAGf,MAAM,WAAW,CAAA;AAClB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAEpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAenE,KAAK,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AAEnD,kEAAkE;AAClE,MAAM,MAAM,YAAY,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAA;AAE7E;;;;;;;GAOG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,YAAY,CAAA;IACrB,KAAK,EAAE,YAAY,EAAE,CAAA;IACrB,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAA;IACxB,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAKD,iGAAiG;AACjG,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,CAOnF;AA0ID;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,QAAQ,EACd,QAAQ,CAAC,EAAE,MAAM,GAChB,oBAAoB,GAAG,IAAI,CAgC7B;AAED,0FAA0F;AAC1F,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAI5E;AAED,mGAAmG;AACnG,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,sBAAsB,EAChC,MAAM,EAAE,oBAAoB,EAC5B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,QAAQ,CAAC,EAAE,cAAc,GACxB,cAAc,CAMhB;AAKD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,QAAQ,GACb;IAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,IAAI,CAYhF;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,MAAM,GACd,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAGzB;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,SAAS,CAAA;IACjB,IAAI,EAAE,2BAA2B,CAAA;IACjC,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,OAAO,GAAG,SAAS,EACzB,IAAI,EAAE,MAAM,GACX,oBAAoB,GAAG,SAAS,CAkBlC"}

package/dist/lib/wall-face-script.js

@@ -1,5 +1,5 @@
-import { getWallTop } from '../services/storey.js';
-import { isCurvedWall } from '../systems/wall/wall-curve.js';
+import { getWallTopOver } from '../services/storey.js';
+import { getWallCurveLength, isCurvedWall } from '../systems/wall/wall-curve.js';
 import { parseWallPaintRole } from '../systems/wall/wall-finish.js';
 import { getWallThickness } from '../systems/wall/wall-footprint.js';
 import { getWallLocalFaceZ } from '../systems/wall/wall-frame.js';
@@ -35,12 +35,15 @@ function levelMiters(nodes, levelId) {
     }
     return miters;
 }
-/** A wall whose faces a script can build on: straight, not a curtain wall, standing on a level. */
+/**
+ * A wall whose faces a script can build on: straight, not a curtain wall or a railing (neither has
+ * faces), standing on a level.
+ */
 function scriptableWall(nodes, wallId) {
     const wall = nodes[wallId];
     if (wall?.type !== 'wall' || !wall.parentId)
         return null;
-    if (wall.wallType === 'curtain' || isCurvedWall(wall))
+    if (wall.wallType === 'curtain' || wall.wallType === 'railing' || isCurvedWall(wall))
         return null;
     return Math.hypot(wall.end[0] - wall.start[0], wall.end[1] - wall.start[1]) < EPS ? null : wall;
 }
@@ -53,7 +56,7 @@ function faceFrame(nodes, wallId, face) {
     const length = Math.hypot(dx, dz);
     const support = wallSupportForNodes(wall, nodes);
     const offset = wallFaceBaseOffset(support, face);
-    const top = getWallTop(wall, wall.parentId, nodes, support.elevation) -
+    const top = getWallTopOver(wall, wall.parentId, nodes, support.elevation, 0, getWallCurveLength(wall)) -
         support.elevation -
         offset;
     const station = (point) => ((point.x - wall.start[0]) * dx + (point.y - wall.start[1]) * dz) / length;

package/dist/lib/window-interaction.d.ts

@@ -0,0 +1,16 @@
+import type { AnyNodeId } from '../schema/types.js';
+import { type InteractiveState, type WindowInteractiveState } from '../store/use-interactive.js';
+export declare const WINDOW_TOGGLE_ANIMATION_MS = 520;
+export type WindowOpenAnimationOptions = {
+    persist?: boolean;
+};
+export declare function isOperableWindowType(windowType: string | undefined): windowType is "awning" | "casement" | "double-hung" | "hopper" | "louvered" | "single-hung" | "sliding" | "tilt-turn";
+export declare function getDisplayedWindowValue(windowId: AnyNodeId, nodeValue: number | undefined, field?: keyof WindowInteractiveState, interactive?: InteractiveState): number;
+export declare function toggleWindowOpenState(windowId: AnyNodeId, options?: WindowOpenAnimationOptions): void;
+export declare function closeWindowOpenState(windowId: AnyNodeId, options?: WindowOpenAnimationOptions): void;
+export declare function openWindowOpenState(windowId: AnyNodeId, options?: WindowOpenAnimationOptions): void;
+export type WindowShutterField = 'shutterOpen' | 'rollerShutterOpen';
+export declare function getDisplayedWindowShutterValue(windowId: AnyNodeId, field: WindowShutterField, nodeValue: number | undefined, state?: InteractiveState): number;
+/** Preview both shutter styles together, independently of the sash. */
+export declare function setWindowShuttersOpenState(windowId: AnyNodeId, on: boolean, options?: WindowOpenAnimationOptions): void;
+//# sourceMappingURL=window-interaction.d.ts.map

package/dist/lib/window-interaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"window-interaction.d.ts","sourceRoot":"","sources":["../../src/lib/window-interaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,EACL,KAAK,gBAAgB,EAErB,KAAK,sBAAsB,EAC5B,MAAM,0BAA0B,CAAA;AAGjC,eAAO,MAAM,0BAA0B,MAAM,CAAA;AAE7C,MAAM,MAAM,0BAA0B,GAAG;IACvC,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,yHAWlE;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,SAAS,EACnB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,KAAK,GAAE,MAAM,sBAAyC,EACtD,WAAW,GAAE,gBAA4C,UAS1D;AAmBD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,0BAA0B,QAkB9F;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,0BAA0B,QAY7F;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,0BAA0B,QAY5F;AAED,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG,mBAAmB,CAAA;AAEpE,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,SAAS,EACnB,KAAK,EAAE,kBAAkB,EACzB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,KAAK,GAAE,gBAA4C,GAClD,MAAM,CAER;AAED,uEAAuE;AACvE,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,SAAS,EACnB,EAAE,EAAE,OAAO,EACX,OAAO,CAAC,EAAE,0BAA0B,GACnC,IAAI,CAkBN"}

package/dist/lib/window-interaction.js

@@ -0,0 +1,82 @@
+import { useInteractive, } from '../store/use-interactive.js';
+import useScene from '../store/use-scene.js';
+export const WINDOW_TOGGLE_ANIMATION_MS = 520;
+export function isOperableWindowType(windowType) {
+    return (windowType === 'sliding' ||
+        windowType === 'casement' ||
+        windowType === 'awning' ||
+        windowType === 'hopper' ||
+        windowType === 'tilt-turn' ||
+        windowType === 'single-hung' ||
+        windowType === 'double-hung' ||
+        windowType === 'louvered');
+}
+export function getDisplayedWindowValue(windowId, nodeValue, field = 'operationState', interactive = useInteractive.getState()) {
+    const runtimeValue = interactive.windows[windowId]?.[field];
+    if (runtimeValue !== undefined)
+        return runtimeValue;
+    const queuedValue = interactive.windowAnimations[windowId]?.[field]?.from;
+    if (queuedValue !== undefined)
+        return queuedValue;
+    return nodeValue ?? 0;
+}
+function startWindowOpenAnimation(windowId, field, from, to, options) {
+    useInteractive.getState().startWindowAnimation(windowId, {
+        field,
+        from,
+        to,
+        startedAt: null,
+        durationMs: WINDOW_TOGGLE_ANIMATION_MS,
+        persist: options?.persist ?? true,
+    });
+}
+export function toggleWindowOpenState(windowId, options) {
+    const node = useScene.getState().nodes[windowId];
+    if (node?.type !== 'window' ||
+        node.openingKind === 'opening' ||
+        !isOperableWindowType(node.windowType)) {
+        return;
+    }
+    const currentOpenAmount = getDisplayedWindowValue(windowId, node.operationState);
+    startWindowOpenAnimation(windowId, 'operationState', currentOpenAmount, currentOpenAmount >= 0.5 ? 0 : 1, options);
+}
+export function closeWindowOpenState(windowId, options) {
+    const node = useScene.getState().nodes[windowId];
+    if (node?.type !== 'window' ||
+        node.openingKind === 'opening' ||
+        !isOperableWindowType(node.windowType)) {
+        return;
+    }
+    const currentOpenAmount = getDisplayedWindowValue(windowId, node.operationState);
+    startWindowOpenAnimation(windowId, 'operationState', currentOpenAmount, 0, options);
+}
+export function openWindowOpenState(windowId, options) {
+    const node = useScene.getState().nodes[windowId];
+    if (node?.type !== 'window' ||
+        node.openingKind === 'opening' ||
+        !isOperableWindowType(node.windowType)) {
+        return;
+    }
+    const currentOpenAmount = getDisplayedWindowValue(windowId, node.operationState);
+    startWindowOpenAnimation(windowId, 'operationState', currentOpenAmount, 1, options);
+}
+export function getDisplayedWindowShutterValue(windowId, field, nodeValue, state = useInteractive.getState()) {
+    return getDisplayedWindowValue(windowId, nodeValue ?? 1, field, state);
+}
+/** Preview both shutter styles together, independently of the sash. */
+export function setWindowShuttersOpenState(windowId, on, options) {
+    const node = useScene.getState().nodes[windowId];
+    if (node?.type !== 'window' || node.source)
+        return;
+    const fields = [];
+    if (node.shutters && node.shutters !== 'none')
+        fields.push('shutterOpen');
+    if (node.rollerShutter === 'box' || node.rollerShutter === 'concealed')
+        fields.push('rollerShutterOpen');
+    if (!fields.length)
+        return;
+    useInteractive.getState().setMechanismPart(windowId, 'shutters', on);
+    for (const field of fields) {
+        startWindowOpenAnimation(windowId, field, getDisplayedWindowShutterValue(windowId, field, node[field]), on ? 1 : 0, options);
+    }
+}

package/dist/lib/zone-quantities.js

@@ -233,7 +233,7 @@ export function deriveZoneQuantityReport(zone, sceneNodes) {
     const slabs = levelNodes.filter((node) => node.type === 'slab');
     const wallEffectiveHeight = (wall) => {
         const support = computeWallSlabSupport(wall, slabs, walls, wall.supportSlabId, undefined, 0, sceneNodes);
-        return getWallTop(wall, levelId ?? '', sceneNodes, support.elevation) - support.elevation;
+        return getWallTop(wall, levelId ?? '', sceneNodes, support.elevation, 0.5) - support.elevation;
     };
     const edgeLengths = [zone.polygon, ...(zone.holes ?? [])].flatMap((ring) => ring.map((start, index) => {
         const end = ring[(index + 1) % ring.length];

package/dist/material-kinds.d.ts

@@ -2,7 +2,7 @@
  * The material library's kinds and the surfaces its materials suit, apart from the catalog: an
  * agent tool's contract names them without loading the library it searches.
  */
-export declare const MATERIAL_CATEGORIES: readonly ['colors', 'wood', 'stone', 'brick', 'tile', 'wallpaper', 'concrete', 'metal', 'plastic', 'fabric', 'carpet', 'leather', 'roofing', 'ground', 'glass', 'other'];
+export declare const MATERIAL_CATEGORIES: readonly ['colors', 'wood', 'siding', 'stone', 'brick', 'tile', 'wallpaper', 'concrete', 'metal', 'plastic', 'fabric', 'carpet', 'leather', 'roofing', 'ground', 'glass', 'other'];
 export type MaterialCategory = (typeof MATERIAL_CATEGORIES)[number];
 export declare const MATERIAL_SURFACES: readonly ['floor', 'wall', 'ceiling', 'roof', 'furniture', 'outdoor'];
 export type MaterialSurface = (typeof MATERIAL_SURFACES)[number];

package/dist/material-kinds.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"material-kinds.d.ts","sourceRoot":"","sources":["../src/material-kinds.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,mBAAmB,YAC9B,QAAQ,EACR,MAAM,EACN,OAAO,EACP,OAAO,EACP,MAAM,EACN,WAAW,EACX,UAAU,EACV,OAAO,EACP,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,SAAS,EACT,QAAQ,EACR,OAAO,EACP,OAAO,CACC,CAAA;AACV,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEnE,eAAO,MAAM,iBAAiB,YAC5B,OAAO,EACP,MAAM,EACN,SAAS,EACT,MAAM,EACN,WAAW,EACX,SAAS,CACD,CAAA;AACV,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAA"}
+{"version":3,"file":"material-kinds.d.ts","sourceRoot":"","sources":["../src/material-kinds.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,mBAAmB,YAC9B,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,OAAO,EACP,OAAO,EACP,MAAM,EACN,WAAW,EACX,UAAU,EACV,OAAO,EACP,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,SAAS,EACT,QAAQ,EACR,OAAO,EACP,OAAO,CACC,CAAA;AACV,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEnE,eAAO,MAAM,iBAAiB,YAC5B,OAAO,EACP,MAAM,EACN,SAAS,EACT,MAAM,EACN,WAAW,EACX,SAAS,CACD,CAAA;AACV,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAA"}

package/dist/material-kinds.js

@@ -5,6 +5,7 @@
 export const MATERIAL_CATEGORIES = [
     'colors',
     'wood',
+    'siding',
     'stone',
     'brick',
     'tile',