@pascal-app/core 1.0.4 → 1.0.5

package/dist/building/wall-openings.d.ts

@@ -22,9 +22,9 @@ export declare function clampWindowToWall(wall: WallNode, localX: number, localY
  * (`clampedX`, `clampedY`) would overlap. Items store their bottom Y; doors and windows their
  * centre Y.
  */
-export declare function findWallChildOverlap(wallId: string, nodes: Nodes, clampedX: number, clampedY: number, width: number, height: number, ignoreId?: string): AnyNode | null;
+export declare function findWallChildOverlap(wallId: string, nodes: Nodes, clampedX: number, clampedY: number, width: number, height: number, ignoreId?: string | readonly string[]): AnyNode | null;
 /** Whether a placement collides; a missing wall counts as blocked, as in the editor's tools. */
-export declare function hasWallChildOverlap(wallId: string, nodes: Nodes, clampedX: number, clampedY: number, width: number, height: number, ignoreId?: string): boolean;
+export declare function hasWallChildOverlap(wallId: string, nodes: Nodes, clampedX: number, clampedY: number, width: number, height: number, ignoreId?: string | readonly string[]): boolean;
 export type WallOpeningInput = {
     name?: string;
     description?: string;
@@ -38,6 +38,8 @@ export type WallOpeningInput = {
     height?: number;
     sillHeight?: number;
     hingesSide?: 'left' | 'right';
+    /** Defaults to the side opposite the hinges. */
+    handleSide?: 'left' | 'right';
     swingDirection?: 'inward' | 'outward';
     /** A door, or a passage with no leaf (a cased opening, an arch), as the editor's door panel. */
     openingKind?: 'door' | 'opening';
@@ -55,6 +57,16 @@ export type WallOpeningInput = {
     code?: string;
     params?: Record<string, GeometryScriptParamValue>;
 };
+/** A window's size when none is given. Its sill is not a number: see `centredWindowSill`. */
+export declare const DEFAULT_WINDOW: {
+    readonly width: 1.5;
+    readonly height: 1.5;
+};
+/**
+ * The sill that centres a window of `height` vertically on the lowest of `walls`, or 0 when it is
+ * taller than they are. What a window with no sill given takes, on every agent surface.
+ */
+export declare function centredWindowSill(walls: readonly WallNode[], height: number, nodes: Readonly<Record<AnyNodeId, AnyNode>>): number;
 /**
  * Plan a door or window on a wall with the editor's rules, or refuse with a code: the one
  * operation behind `add_door` / `add_window` on every agent surface. The caller creates
@@ -70,88 +82,52 @@ export declare function doorFacing(wall: Pick<WallNode, 'frontSide' | 'backSide'
     rotation: [number, number, number];
 };
 /** The face a door placed by hand takes: out on an outside wall, else the face hovered. */
-export declare const placedDoorFace: (wall: Pick<WallNode, "frontSide" | "backSide">, hovered: "front" | "back") => "front" | "back";
+/**
+ * Hinges and handle are both measured from the door's own left, so a handle
+ * left where it is would hang on the hinge edge of a right-hinged door.
+ */
+export declare function doorHardwareSides(input: Pick<WallOpeningInput, 'hingesSide' | 'handleSide'>): {
+    readonly hingesSide: "left" | "right";
+    readonly handleSide: "left" | "right";
+};
+export declare const placedDoorFace: (wall: Pick<WallNode, 'frontSide' | 'backSide'>, hovered: 'front' | 'back') => 'front' | 'back';
 export declare function planWallOpening(nodes: Nodes, input: WallOpeningInput): {
-    sillHeight?: number | undefined;
     node: {
         object: "node";
+        name?: string | undefined;
         parentId: string | null;
         visible: boolean;
-        metadata: Record<string, unknown>;
-        id: `door_${string}`;
-        type: "door";
-        position: [number, number, number];
-        rotation: [number, number, number];
-        floorThresholdVersion: 0 | 1;
-        width: number;
-        height: number;
-        constructionType: "masonry" | "framed";
-        dimensionReference: "nominal" | "rough-opening" | "masonry-opening" | "finish-opening";
-        doorCategory: "interior" | "garage";
-        doorType: "double" | "hinged" | "french" | "folding" | "pocket" | "barn" | "sliding" | "garage-sectional" | "garage-rollup" | "garage-tiltup";
-        leafCount: 2 | 1 | 3 | 4;
-        operationState: number;
-        slideDirection: "left" | "right";
-        trackStyle: "visible" | "none" | "pocket" | "overhead";
-        garagePanelCount: number;
-        openingKind: "door" | "opening";
-        openingShape: "rectangle" | "rounded" | "arch";
-        openingRadiusMode: "all" | "individual";
-        openingTopRadii: [number, number];
-        cornerRadius: number;
-        archHeight: number;
-        openingRevealRadius: number;
-        frameThickness: number;
-        frameDepth: number;
-        threshold: boolean;
-        thresholdHeight: number;
-        hingesSide: "left" | "right";
-        swingDirection: "inward" | "outward";
-        swingAngle: number;
-        segments: {
-            type: "glass" | "empty" | "panel";
-            heightRatio: number;
-            columnRatios: number[];
-            dividerThickness: number;
-            panelDepth: number;
-            panelInset: number;
-        }[];
-        handle: boolean;
-        handleHeight: number;
-        handleSide: "left" | "right";
-        contentPadding: [number, number];
-        doorCloser: boolean;
-        panicBar: boolean;
-        panicBarHeight: number;
-        name?: string | undefined;
         camera?: {
             position: [number, number, number];
             target: [number, number, number];
-            mode: "perspective" | "orthographic";
+            mode: "orthographic" | "perspective";
             fov?: number | undefined;
             zoom?: number | undefined;
         } | undefined;
+        metadata: Record<string, unknown>;
         provenance?: {
             refs: {
-                id: string;
                 ns?: string | undefined;
-                role?: "primary" | "piece" | "absorbed" | "alias" | "derived" | undefined;
+                id: string;
+                role?: "absorbed" | "alias" | "derived" | "piece" | "primary" | undefined;
             }[];
             lineage?: {
-                op: "import" | "split" | "merge" | "duplicate" | "convert" | "promote" | "make-independent" | "attach";
+                op: "attach" | "convert" | "duplicate" | "import" | "make-independent" | "merge" | "promote" | "split";
                 fromIds: string[];
             } | undefined;
         } | undefined;
+        id: `window_${string}`;
+        type: "window";
         material?: {
             id?: string | undefined;
-            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            preset?: "brick" | "concrete" | "custom" | "glass" | "marble" | "metal" | "plaster" | "tile" | "white" | "wood" | undefined;
             properties?: {
                 color: string;
                 roughness: number;
                 metalness: number;
                 opacity: number;
                 transparent: boolean;
-                side: "front" | "back" | "double";
+                side: "back" | "double" | "front";
             } | undefined;
             texture?: {
                 url: string;
@@ -162,7 +138,13 @@ export declare function planWallOpening(nodes: Nodes, input: WallOpeningInput):
         slots?: Record<string, string> | undefined;
         source?: {
             kind: "script";
-            language: "three" | "bpy";
+            meta?: {
+                description?: string | undefined;
+                category?: string | undefined;
+                tags?: string[] | undefined;
+                parent?: string | undefined;
+            } | undefined;
+            language: "bpy" | "three";
             script: string;
             params: Record<string, string | number | boolean>;
             artifact: string;
@@ -173,9 +155,9 @@ export declare function planWallOpening(nodes: Nodes, input: WallOpeningInput):
                 };
                 params: {
                     id: string;
-                    kind: "string" | "number" | "boolean";
-                    default: string | number | boolean;
                     label?: string | undefined;
+                    kind: "boolean" | "number" | "string";
+                    default: string | number | boolean;
                     min?: number | undefined;
                     max?: number | undefined;
                     step?: number | undefined;
@@ -192,9 +174,9 @@ export declare function planWallOpening(nodes: Nodes, input: WallOpeningInput):
                     } | undefined;
                 }[];
                 surfaces: {
+                    part?: string | undefined;
                     y: number;
                     polygon: [number, number][];
-                    part?: string | undefined;
                 }[];
                 slots: {
                     id: string;
@@ -218,69 +200,63 @@ export declare function planWallOpening(nodes: Nodes, input: WallOpeningInput):
                     distance?: number | undefined;
                 }[];
                 undersides: {
+                    part?: string | undefined;
                     polygon: [number, number][];
                     plane: [number, number, number, number];
-                    part?: string | undefined;
                 }[];
                 animations: {
                     name: string;
                     duration: number;
                 }[];
-                cutout: boolean;
-                collider: boolean;
-                triangles: number;
                 cutters?: {
-                    host: "wall" | "slab" | "ceiling" | "mounted";
+                    host: "ceiling" | "mounted" | "slab" | "wall";
                     polygon: number[][];
                     minY: number;
                     maxY: number;
                 }[] | undefined;
+                cutout: boolean;
+                collider: boolean;
+                triangles: number;
+                coverage?: number | undefined;
+                uncovered?: {
+                    min: [number, number];
+                    max: [number, number];
+                }[] | undefined;
             };
-            meta?: {
-                description?: string | undefined;
-                category?: string | undefined;
-                tags?: string[] | undefined;
-                parent?: string | undefined;
-            } | undefined;
             images?: {
                 artifact: string;
                 thumbnail: string;
                 floorPlan: string;
             } | undefined;
         } | undefined;
-        side?: "front" | "back" | undefined;
-        verticalAnchor?: "wall" | "floor" | undefined;
+        position: [number, number, number];
+        rotation: [number, number, number];
+        side?: "back" | "front" | undefined;
+        verticalAnchor?: "floor" | "wall" | undefined;
+        floorThresholdVersion: 0 | 1;
         wallId?: string | undefined;
+        dormerId?: string | undefined;
+        dormerFace?: "back" | "front" | "left" | "right" | undefined;
         roofSegmentId?: string | undefined;
-        roofFace?: "left" | "right" | "front" | "back" | undefined;
+        roofFace?: "back" | "front" | "left" | "right" | undefined;
+        width: number;
+        height: number;
         mark?: string | undefined;
+        constructionType: "framed" | "masonry";
+        dimensionReference: "finish-opening" | "masonry-opening" | "nominal" | "rough-opening";
         roughOpeningWidth?: number | undefined;
         roughOpeningHeight?: number | undefined;
         masonryOpeningWidth?: number | undefined;
         masonryOpeningHeight?: number | undefined;
         finishOpeningWidth?: number | undefined;
         finishOpeningHeight?: number | undefined;
-    } | {
-        object: "node";
-        parentId: string | null;
-        visible: boolean;
-        metadata: Record<string, unknown>;
-        id: `window_${string}`;
-        type: "window";
-        position: [number, number, number];
-        rotation: [number, number, number];
-        floorThresholdVersion: 0 | 1;
-        width: number;
-        height: number;
-        constructionType: "masonry" | "framed";
-        dimensionReference: "nominal" | "rough-opening" | "masonry-opening" | "finish-opening";
-        openingKind: "window" | "opening";
-        windowType: "fixed" | "sliding" | "casement" | "awning" | "hopper" | "single-hung" | "double-hung" | "bay" | "bow" | "louvered";
+        openingKind: "opening" | "window";
+        windowType: "awning" | "bay" | "bow" | "casement" | "double-hung" | "fixed" | "hopper" | "louvered" | "single-hung" | "sliding";
         operationState: number;
-        awningDirection: "up" | "down";
+        awningDirection: "down" | "up";
         casementStyle: "french" | "single";
         hingesSide: "left" | "right";
-        openingShape: "rectangle" | "rounded" | "arch";
+        openingShape: "arch" | "rectangle" | "rounded";
         openingRadiusMode: "all" | "individual";
         openingCornerRadii: [number, number, number, number];
         cornerRadius: number;
@@ -292,38 +268,50 @@ export declare function planWallOpening(nodes: Nodes, input: WallOpeningInput):
         rowRatios: number[];
         columnDividerThickness: number;
         rowDividerThickness: number;
+        corner?: {
+            end: "end" | "start";
+            partnerId: string;
+            post: "none" | "post";
+        } | undefined;
         sill: boolean;
         sillDepth: number;
         sillThickness: number;
+    } | {
+        object: "node";
         name?: string | undefined;
+        parentId: string | null;
+        visible: boolean;
         camera?: {
             position: [number, number, number];
             target: [number, number, number];
-            mode: "perspective" | "orthographic";
+            mode: "orthographic" | "perspective";
             fov?: number | undefined;
             zoom?: number | undefined;
         } | undefined;
+        metadata: Record<string, unknown>;
         provenance?: {
             refs: {
-                id: string;
                 ns?: string | undefined;
-                role?: "primary" | "piece" | "absorbed" | "alias" | "derived" | undefined;
+                id: string;
+                role?: "absorbed" | "alias" | "derived" | "piece" | "primary" | undefined;
             }[];
             lineage?: {
-                op: "import" | "split" | "merge" | "duplicate" | "convert" | "promote" | "make-independent" | "attach";
+                op: "attach" | "convert" | "duplicate" | "import" | "make-independent" | "merge" | "promote" | "split";
                 fromIds: string[];
             } | undefined;
         } | undefined;
+        id: `door_${string}`;
+        type: "door";
         material?: {
             id?: string | undefined;
-            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            preset?: "brick" | "concrete" | "custom" | "glass" | "marble" | "metal" | "plaster" | "tile" | "white" | "wood" | undefined;
             properties?: {
                 color: string;
                 roughness: number;
                 metalness: number;
                 opacity: number;
                 transparent: boolean;
-                side: "front" | "back" | "double";
+                side: "back" | "double" | "front";
             } | undefined;
             texture?: {
                 url: string;
@@ -334,7 +322,13 @@ export declare function planWallOpening(nodes: Nodes, input: WallOpeningInput):
         slots?: Record<string, string> | undefined;
         source?: {
             kind: "script";
-            language: "three" | "bpy";
+            meta?: {
+                description?: string | undefined;
+                category?: string | undefined;
+                tags?: string[] | undefined;
+                parent?: string | undefined;
+            } | undefined;
+            language: "bpy" | "three";
             script: string;
             params: Record<string, string | number | boolean>;
             artifact: string;
@@ -345,9 +339,9 @@ export declare function planWallOpening(nodes: Nodes, input: WallOpeningInput):
                 };
                 params: {
                     id: string;
-                    kind: "string" | "number" | "boolean";
-                    default: string | number | boolean;
                     label?: string | undefined;
+                    kind: "boolean" | "number" | "string";
+                    default: string | number | boolean;
                     min?: number | undefined;
                     max?: number | undefined;
                     step?: number | undefined;
@@ -364,9 +358,9 @@ export declare function planWallOpening(nodes: Nodes, input: WallOpeningInput):
                     } | undefined;
                 }[];
                 surfaces: {
+                    part?: string | undefined;
                     y: number;
                     polygon: [number, number][];
-                    part?: string | undefined;
                 }[];
                 slots: {
                     id: string;
@@ -390,56 +384,97 @@ export declare function planWallOpening(nodes: Nodes, input: WallOpeningInput):
                     distance?: number | undefined;
                 }[];
                 undersides: {
+                    part?: string | undefined;
                     polygon: [number, number][];
                     plane: [number, number, number, number];
-                    part?: string | undefined;
                 }[];
                 animations: {
                     name: string;
                     duration: number;
                 }[];
-                cutout: boolean;
-                collider: boolean;
-                triangles: number;
                 cutters?: {
-                    host: "wall" | "slab" | "ceiling" | "mounted";
+                    host: "ceiling" | "mounted" | "slab" | "wall";
                     polygon: number[][];
                     minY: number;
                     maxY: number;
                 }[] | undefined;
+                cutout: boolean;
+                collider: boolean;
+                triangles: number;
+                coverage?: number | undefined;
+                uncovered?: {
+                    min: [number, number];
+                    max: [number, number];
+                }[] | undefined;
             };
-            meta?: {
-                description?: string | undefined;
-                category?: string | undefined;
-                tags?: string[] | undefined;
-                parent?: string | undefined;
-            } | undefined;
             images?: {
                 artifact: string;
                 thumbnail: string;
                 floorPlan: string;
             } | undefined;
         } | undefined;
-        side?: "front" | "back" | undefined;
-        verticalAnchor?: "wall" | "floor" | undefined;
+        position: [number, number, number];
+        rotation: [number, number, number];
+        side?: "back" | "front" | undefined;
+        verticalAnchor?: "floor" | "wall" | undefined;
+        floorThresholdVersion: 0 | 1;
         wallId?: string | undefined;
-        dormerId?: string | undefined;
-        dormerFace?: "left" | "right" | "front" | "back" | undefined;
         roofSegmentId?: string | undefined;
-        roofFace?: "left" | "right" | "front" | "back" | undefined;
+        roofFace?: "back" | "front" | "left" | "right" | undefined;
+        width: number;
+        height: number;
         mark?: string | undefined;
+        constructionType: "framed" | "masonry";
+        dimensionReference: "finish-opening" | "masonry-opening" | "nominal" | "rough-opening";
         roughOpeningWidth?: number | undefined;
         roughOpeningHeight?: number | undefined;
         masonryOpeningWidth?: number | undefined;
         masonryOpeningHeight?: number | undefined;
         finishOpeningWidth?: number | undefined;
         finishOpeningHeight?: number | undefined;
+        doorCategory: "garage" | "interior";
+        doorType: "barn" | "double" | "folding" | "french" | "garage-rollup" | "garage-sectional" | "garage-tiltup" | "hinged" | "pocket" | "sliding";
+        leafCount: 1 | 2 | 3 | 4;
+        operationState: number;
+        slideDirection: "left" | "right";
+        trackStyle: "none" | "overhead" | "pocket" | "visible";
+        garagePanelCount: number;
+        openingKind: "door" | "opening";
+        openingShape: "arch" | "rectangle" | "rounded";
+        openingRadiusMode: "all" | "individual";
+        openingTopRadii: [number, number];
+        cornerRadius: number;
+        archHeight: number;
+        openingRevealRadius: number;
+        frameThickness: number;
+        frameDepth: number;
+        threshold: boolean;
+        thresholdHeight: number;
+        hingesSide: "left" | "right";
+        swingDirection: "inward" | "outward";
+        swingAngle: number;
+        segments: {
+            type: "empty" | "glass" | "panel";
+            heightRatio: number;
+            columnRatios: number[];
+            dividerThickness: number;
+            panelDepth: number;
+            panelInset: number;
+        }[];
+        handle: boolean;
+        handleHeight: number;
+        handleSide: "left" | "right";
+        contentPadding: [number, number];
+        doorCloser: boolean;
+        panicBar: boolean;
+        panicBarHeight: number;
     };
     wallId: string;
     localX: number;
     t: number;
     wallLength: number;
     clamped: boolean;
+    sillHeight?: number | undefined;
 };
 export {};
 //# sourceMappingURL=wall-openings.d.ts.map

package/dist/building/wall-openings.d.ts.map

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

package/dist/building/wall-openings.js

@@ -1,13 +1,12 @@
 import { refuseParamsWithoutScript } from '../agent-operations/add-object.js';
 import { refuse } from '../agent-tools/refusal.js';
-import { matchScriptSlotsToLibrary, scriptedSize, scriptSource } from '../lib/geometry-script-node.js';
+import { matchScriptSlotsToLibrary, requireMeasured, scriptedSize, scriptSource, } from '../lib/geometry-script-node.js';
 import { wallSupportForNodes } from '../lib/opening-floor-datum.js';
 import { DoorNode, getScaledDimensions, WindowNode, } from '../schema/index.js';
 import { getCurtainWallConfig } from '../schema/nodes/curtain-wall.js';
-import { getWallPlaneTop } from '../services/storey.js';
+import { getWallTop } from '../services/storey.js';
 import { resolveWallExteriorSide } from '../systems/wall/wall-assembly.js';
 import { getWallCurveLength, isCurvedWall } from '../systems/wall/wall-curve.js';
-import { resolveWallTop } from '../systems/wall/wall-top.js';
 import { doorStyleLook, getWindowStyleOverrides, } from './opening-style-presets.js';
 import { windowTakesStyle } from './window-types.js';
 /** 1 µm: below any buildable difference, above floating-point noise. */
@@ -20,7 +19,8 @@ const lengthOf = (wall) => Math.hypot(wall.end[0] - wall.start[0], wall.end[1] -
  */
 export function resolveWallOpeningCeiling(wall, nodes) {
     const support = wallSupportForNodes(wall, nodes);
-    return (resolveWallTop(wall, getWallPlaneTop(wall, wall.parentId ?? '', nodes), support.elevation) - support.elevation);
+    return (getWallTop(wall, wall.parentId ?? '', nodes, support.elevation) -
+        support.elevation);
 }
 /** A curtain wall keeps its perimeter frame clear of openings. */
 const openingMargin = (wall) => wall.wallType === 'curtain' ? getCurtainWallConfig(wall).perimeterWidth : 0;
@@ -54,7 +54,7 @@ export function findWallChildOverlap(wallId, nodes, clampedX, clampedY, width, h
     const newLeft = clampedX - width / 2;
     const newRight = clampedX + width / 2;
     for (const childId of Array.isArray(wallNode.children) ? wallNode.children : []) {
-        if (childId === ignoreId)
+        if (typeof ignoreId === 'string' ? childId === ignoreId : ignoreId?.includes(childId))
             continue;
         const child = nodes[childId];
         if (!child || child.metadata.isTransient)
@@ -99,11 +99,21 @@ export function hasWallChildOverlap(wallId, nodes, clampedX, clampedY, width, he
     return findWallChildOverlap(wallId, nodes, clampedX, clampedY, width, height, ignoreId) !== null;
 }
 const equalRatios = (count) => Array.from({ length: count }, () => 1 / count);
+/** A window's size when none is given. Its sill is not a number: see `centredWindowSill`. */
+export const DEFAULT_WINDOW = { width: 1.5, height: 1.5 };
 const DEFAULTS = {
     door: { width: 0.9, height: 2.1 },
-    window: { width: 1.5, height: 1.5, sillHeight: 0.9 },
+    window: DEFAULT_WINDOW,
 };
 const metres = (value) => `${value.toFixed(2)} m`;
+/**
+ * The sill that centres a window of `height` vertically on the lowest of `walls`, or 0 when it is
+ * taller than they are. What a window with no sill given takes, on every agent surface.
+ */
+export function centredWindowSill(walls, height, nodes) {
+    const ceiling = Math.min(...walls.map((wall) => resolveWallOpeningCeiling(wall, nodes)));
+    return Math.max(0, (ceiling - height) / 2);
+}
 /**
  * Plan a door or window on a wall with the editor's rules, or refuse with a code: the one
  * operation behind `add_door` / `add_window` on every agent surface. The caller creates
@@ -123,6 +133,17 @@ export function doorFacing(wall) {
     return { rotation: [0, 0, 0] };
 }
 /** The face a door placed by hand takes: out on an outside wall, else the face hovered. */
+/**
+ * Hinges and handle are both measured from the door's own left, so a handle
+ * left where it is would hang on the hinge edge of a right-hinged door.
+ */
+export function doorHardwareSides(input) {
+    const hingesSide = input.hingesSide ?? 'left';
+    return {
+        hingesSide,
+        handleSide: input.handleSide ?? (hingesSide === 'right' ? 'left' : 'right'),
+    };
+}
 export const placedDoorFace = (wall, hovered) => doorFacing(wall).side ?? hovered;
 export function planWallOpening(nodes, input) {
     refuseParamsWithoutScript(nodes, input);
@@ -154,6 +175,8 @@ export function planWallOpening(nodes, input) {
     const { compiled } = input;
     if (compiled && compiled.mount !== 'wall')
         refuse('wrong_mount', `A ${kind}'s script uses mount 'wall'.`, { mount: compiled.mount });
+    if (compiled)
+        requireMeasured(compiled, { label: `A ${kind}`, tool: `add_${kind}` });
     const [scriptedWidth, scriptedHeight] = compiled ? scriptedSize(compiled.manifest) : [];
     const width = scriptedWidth ?? input.width ?? DEFAULTS[kind].width;
     const height = scriptedHeight ?? input.height ?? DEFAULTS[kind].height;
@@ -161,8 +184,13 @@ export function planWallOpening(nodes, input) {
     if (wallLength < width)
         refuse('wall_too_short', `Wall ${wallId} is ${metres(wallLength)} long, too short for a ${metres(width)} ${kind}.`, { wallId, wallLength, width });
     const rawX = along * wallLength;
-    const sillHeight = input.sillHeight ?? DEFAULTS.window.sillHeight;
-    const rawY = kind === 'door' ? height / 2 : sillHeight + height / 2;
+    // A window with no sill given is centred on its wall, taller than the wall or not: the clamp
+    // below stands one that is too tall on the floor and reports it clamped.
+    const rawY = kind === 'door'
+        ? height / 2
+        : input.sillHeight === undefined
+            ? resolveWallOpeningCeiling(wall, nodes) / 2
+            : input.sillHeight + height / 2;
     const { clampedX, clampedY } = kind === 'door'
         ? clampDoorToWall(wall, rawX, width, height)
         : clampWindowToWall(wall, rawX, rawY, width, height, nodes);
@@ -206,7 +234,7 @@ export function planWallOpening(nodes, input) {
         ? DoorNode.parse({
             ...base,
             ...doorFacing(wall),
-            hingesSide: input.hingesSide ?? 'left',
+            ...doorHardwareSides(input),
             swingDirection: input.swingDirection ?? 'inward',
             ...(input.style ? doorStyleLook(input.style) : {}),
             ...(input.doorType ? { doorType: input.doorType } : {}),