@pascal-app/core 1.0.3 → 1.0.5

package/dist/building/__fixtures__/wall-opening-cases.d.ts

@@ -0,0 +1,940 @@
+/**
+ * The edge cases of `add_door` / `add_window`, written before the operation: one table that the
+ * core operation, the MCP tool and the hosted chat's executor all run, so the three layers cannot
+ * disagree. The editor's manual tools are the reference for what is possible: curved walls take
+ * no openings, overlapping placements need a force (Alt in the editor), positions clamp onto the
+ * wall and windows under its ceiling. `wall_too_short` is the one guard the editor lacks.
+ */
+export declare const OPENING_SCENE: {
+    readonly buildingId: 'building_openings';
+    readonly levelId: 'level_openings';
+    /** 4 m straight wall, 2.5 m tall. */
+    readonly main: 'wall_main';
+    /** 0.8 m: shorter than a default door. */
+    readonly short: 'wall_short';
+    /** 0.9 m: exactly a default door. */
+    readonly exact: 'wall_exact';
+    /** 4 m wall with a door centred at 2.0 m (1.55–2.45 m, 0–2.1 m high). */
+    readonly busy: 'wall_busy';
+    readonly existingDoor: 'door_existing';
+    /** 4 m wall bowed 0.5 m. */
+    readonly curved: 'wall_curved';
+    /** 4 m wall with no height of its own: the 2.8 m storey decides. */
+    readonly storey: 'wall_storey';
+    /** 4 m wall carrying a 1.2 m wall-mounted shelf centred at 2.0 m (1.4–2.6 m, 1.0–1.6 m high). */
+    readonly shelved: 'wall_shelved';
+    readonly wallShelf: 'item_wall_shelf';
+    /** 4 m outside wall, its outside at the front (+normal). */
+    readonly outFront: 'wall_out_front';
+    /** 4 m outside wall drawn the other way: its outside at the back, as a garage wall can be. */
+    readonly outBack: 'wall_out_back';
+};
+/** A fresh scene graph for every case: one building, one 2.8 m storey, nine walls. */
+export declare function openingScene(): {
+    nodes: {
+        [k: string]: {
+            object: "node";
+            name?: string | undefined;
+            parentId: string | null;
+            visible: boolean;
+            camera?: {
+                position: [number, number, number];
+                target: [number, number, number];
+                mode: "orthographic" | "perspective";
+                fov?: number | undefined;
+                zoom?: number | undefined;
+            } | undefined;
+            metadata: Record<string, unknown>;
+            provenance?: {
+                refs: {
+                    ns?: string | undefined;
+                    id: string;
+                    role?: "absorbed" | "alias" | "derived" | "piece" | "primary" | undefined;
+                }[];
+                lineage?: {
+                    op: "attach" | "convert" | "duplicate" | "import" | "make-independent" | "merge" | "promote" | "split";
+                    fromIds: string[];
+                } | undefined;
+            } | undefined;
+            id: `wall_${string}`;
+            type: "wall";
+            wallType?: "curtain" | "standard" | undefined;
+            curtainWall?: {
+                construction: "stick" | "unitized";
+                framing: "capped" | "horizontal-caps" | "structural-glazing" | "vertical-caps";
+                columns: {
+                    layout: "count" | "fixed-spacing" | "maximum-spacing";
+                    count: number;
+                    spacing: number;
+                    alignment: "center" | "end" | "start";
+                };
+                rows: {
+                    layout: "count" | "fixed-spacing" | "maximum-spacing";
+                    count: number;
+                    spacing: number;
+                    alignment: "center" | "end" | "start";
+                };
+                mullionWidth: number;
+                transomWidth: number;
+                perimeterWidth: number;
+                jointWidth: number;
+                glassThickness: number;
+                panelType: "empty" | "glass" | "solid";
+                spandrel: "bottom" | "none" | "top";
+                frameColor: string;
+                glassColor: string;
+                solidColor: string;
+                glassOpacity: number;
+                glassRoughness: number;
+                panels: {
+                    column: number;
+                    row: number;
+                    type: "empty" | "glass" | "solid";
+                }[];
+            } | undefined;
+            children: (`door_${string}` | `item_${string}` | `leanto_${string}` | `procedural-item_${string}` | `window_${string}`)[];
+            material?: {
+                id?: string | 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: "back" | "double" | "front";
+                } | undefined;
+                texture?: {
+                    url: string;
+                    repeat?: [number, number] | undefined;
+                    scale?: number | undefined;
+                } | undefined;
+            } | undefined;
+            materialPreset?: string | undefined;
+            interiorMaterial?: {
+                id?: string | 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: "back" | "double" | "front";
+                } | undefined;
+                texture?: {
+                    url: string;
+                    repeat?: [number, number] | undefined;
+                    scale?: number | undefined;
+                } | undefined;
+            } | undefined;
+            interiorMaterialPreset?: string | undefined;
+            exteriorMaterial?: {
+                id?: string | 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: "back" | "double" | "front";
+                } | undefined;
+                texture?: {
+                    url: string;
+                    repeat?: [number, number] | undefined;
+                    scale?: number | undefined;
+                } | undefined;
+            } | undefined;
+            exteriorMaterialPreset?: string | undefined;
+            slots?: Record<string, string> | undefined;
+            legacyFaceMaterials?: {
+                a?: {
+                    material?: {
+                        id?: string | 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: "back" | "double" | "front";
+                        } | undefined;
+                        texture?: {
+                            url: string;
+                            repeat?: [number, number] | undefined;
+                            scale?: number | undefined;
+                        } | undefined;
+                    } | undefined;
+                    materialPreset?: string | undefined;
+                } | undefined;
+                b?: {
+                    material?: {
+                        id?: string | 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: "back" | "double" | "front";
+                        } | undefined;
+                        texture?: {
+                            url: string;
+                            repeat?: [number, number] | undefined;
+                            scale?: number | undefined;
+                        } | undefined;
+                    } | undefined;
+                    materialPreset?: string | undefined;
+                } | undefined;
+            } | undefined;
+            faceRegions?: {
+                id: string;
+                face: "a" | "b";
+                u0?: number | undefined;
+                u1?: number | undefined;
+                v0?: number | undefined;
+                v1?: number | undefined;
+                finish: string;
+            }[] | undefined;
+            thickness?: number | undefined;
+            assembly?: {
+                layers: {
+                    id: string;
+                    role: "air" | "covering" | "deck" | "fill" | "finish" | "furring" | "glazing" | "insulation" | "lining" | "membrane" | "sheathing" | "shell" | "structure" | "substrate" | "underlay";
+                    thickness: number;
+                    core?: true | undefined;
+                    material?: string | undefined;
+                    slot?: string | undefined;
+                    returns?: boolean | undefined;
+                    display?: "construction" | "finished" | undefined;
+                    inset?: number | undefined;
+                    bottom?: number | undefined;
+                    lift?: number | undefined;
+                    src?: string | undefined;
+                }[];
+                backing?: {
+                    id: string;
+                    role: "air" | "covering" | "deck" | "fill" | "finish" | "furring" | "glazing" | "insulation" | "lining" | "membrane" | "sheathing" | "shell" | "structure" | "substrate" | "underlay";
+                    thickness: number;
+                    core?: true | undefined;
+                    material?: string | undefined;
+                    slot?: string | undefined;
+                    returns?: boolean | undefined;
+                    display?: "construction" | "finished" | undefined;
+                    inset?: number | undefined;
+                    bottom?: number | undefined;
+                    lift?: number | undefined;
+                    src?: string | undefined;
+                }[] | undefined;
+                face?: "exterior" | "front" | undefined;
+                presetId?: string | undefined;
+                cavityInsulation?: string | undefined;
+            } | undefined;
+            justification?: "a" | "b" | undefined;
+            height?: number | undefined;
+            curveOffset?: number | undefined;
+            supportSlabId?: string | undefined;
+            supportOffset?: number | undefined;
+            fillToTerrain?: boolean | undefined;
+            cap?: boolean | undefined;
+            underpinning?: {
+                rim: number;
+                stem: number;
+                openings?: {
+                    u: number;
+                    width: number;
+                    top: number;
+                    bottom: number;
+                }[] | undefined;
+            } | undefined;
+            skirting?: {
+                enabled: boolean;
+                sides: "a" | "b" | "both" | "exterior" | "interior";
+                height: number;
+                proud: number;
+                profile: "base-colonial" | "base-modern" | "base-ogee" | "base-shoe" | "bevel" | "bullnose" | "cove" | "crown-cove" | "crown-craftsman" | "crown-layered" | "crown-ogee" | "flat" | "rail-ogee" | "rail-picture" | "rail-rounded" | "rail-stepped" | "triangle";
+                offsetY?: number | undefined;
+            } | undefined;
+            crown?: {
+                enabled: boolean;
+                sides: "a" | "b" | "both" | "exterior" | "interior";
+                height: number;
+                proud: number;
+                profile: "base-colonial" | "base-modern" | "base-ogee" | "base-shoe" | "bevel" | "bullnose" | "cove" | "crown-cove" | "crown-craftsman" | "crown-layered" | "crown-ogee" | "flat" | "rail-ogee" | "rail-picture" | "rail-rounded" | "rail-stepped" | "triangle";
+                offsetY?: number | undefined;
+            } | undefined;
+            chairRail?: {
+                enabled: boolean;
+                sides: "a" | "b" | "both" | "exterior" | "interior";
+                height: number;
+                proud: number;
+                profile: "base-colonial" | "base-modern" | "base-ogee" | "base-shoe" | "bevel" | "bullnose" | "cove" | "crown-cove" | "crown-craftsman" | "crown-layered" | "crown-ogee" | "flat" | "rail-ogee" | "rail-picture" | "rail-rounded" | "rail-stepped" | "triangle";
+                offsetY?: number | undefined;
+            } | undefined;
+            finishScripts?: {
+                a?: {
+                    kind: "script";
+                    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;
+                    manifest: {
+                        bounds: {
+                            min: [number, number, number];
+                            max: [number, number, number];
+                        };
+                        params: {
+                            id: string;
+                            label?: string | undefined;
+                            kind: "boolean" | "number" | "string";
+                            default: string | number | boolean;
+                            min?: number | undefined;
+                            max?: number | undefined;
+                            step?: number | undefined;
+                            unit?: string | undefined;
+                            options?: string[] | undefined;
+                        }[];
+                        parts: {
+                            id: string;
+                            label?: string | undefined;
+                            type?: string | undefined;
+                            bounds?: {
+                                min: [number, number, number];
+                                max: [number, number, number];
+                            } | undefined;
+                        }[];
+                        surfaces: {
+                            part?: string | undefined;
+                            y: number;
+                            polygon: [number, number][];
+                        }[];
+                        slots: {
+                            id: string;
+                            label?: string | undefined;
+                            color?: string | undefined;
+                            roughness?: number | undefined;
+                            metalness?: number | undefined;
+                            transparent?: boolean | undefined;
+                            emissive?: boolean | undefined;
+                        }[];
+                        anchors: {
+                            id: string;
+                            position: [number, number, number];
+                            normal?: [number, number, number] | undefined;
+                        }[];
+                        lights: {
+                            id: string;
+                            position: [number, number, number];
+                            color: string;
+                            intensity: number;
+                            distance?: number | undefined;
+                        }[];
+                        undersides: {
+                            part?: string | undefined;
+                            polygon: [number, number][];
+                            plane: [number, number, number, number];
+                        }[];
+                        animations: {
+                            name: string;
+                            duration: number;
+                        }[];
+                        cutters?: {
+                            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;
+                    };
+                    images?: {
+                        artifact: string;
+                        thumbnail: string;
+                        floorPlan: string;
+                    } | undefined;
+                    inputs: string;
+                    toHeight?: number | undefined;
+                } | undefined;
+                b?: {
+                    kind: "script";
+                    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;
+                    manifest: {
+                        bounds: {
+                            min: [number, number, number];
+                            max: [number, number, number];
+                        };
+                        params: {
+                            id: string;
+                            label?: string | undefined;
+                            kind: "boolean" | "number" | "string";
+                            default: string | number | boolean;
+                            min?: number | undefined;
+                            max?: number | undefined;
+                            step?: number | undefined;
+                            unit?: string | undefined;
+                            options?: string[] | undefined;
+                        }[];
+                        parts: {
+                            id: string;
+                            label?: string | undefined;
+                            type?: string | undefined;
+                            bounds?: {
+                                min: [number, number, number];
+                                max: [number, number, number];
+                            } | undefined;
+                        }[];
+                        surfaces: {
+                            part?: string | undefined;
+                            y: number;
+                            polygon: [number, number][];
+                        }[];
+                        slots: {
+                            id: string;
+                            label?: string | undefined;
+                            color?: string | undefined;
+                            roughness?: number | undefined;
+                            metalness?: number | undefined;
+                            transparent?: boolean | undefined;
+                            emissive?: boolean | undefined;
+                        }[];
+                        anchors: {
+                            id: string;
+                            position: [number, number, number];
+                            normal?: [number, number, number] | undefined;
+                        }[];
+                        lights: {
+                            id: string;
+                            position: [number, number, number];
+                            color: string;
+                            intensity: number;
+                            distance?: number | undefined;
+                        }[];
+                        undersides: {
+                            part?: string | undefined;
+                            polygon: [number, number][];
+                            plane: [number, number, number, number];
+                        }[];
+                        animations: {
+                            name: string;
+                            duration: number;
+                        }[];
+                        cutters?: {
+                            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;
+                    };
+                    images?: {
+                        artifact: string;
+                        thumbnail: string;
+                        floorPlan: string;
+                    } | undefined;
+                    inputs: string;
+                    toHeight?: number | undefined;
+                } | undefined;
+            } | undefined;
+            start: [number, number];
+            end: [number, number];
+            frontSide: "exterior" | "interior" | "unknown";
+            backSide: "exterior" | "interior" | "unknown";
+        } | {
+            object: "node";
+            name?: string | undefined;
+            parentId: string | null;
+            visible: boolean;
+            camera?: {
+                position: [number, number, number];
+                target: [number, number, number];
+                mode: "orthographic" | "perspective";
+                fov?: number | undefined;
+                zoom?: number | undefined;
+            } | undefined;
+            metadata: Record<string, unknown>;
+            provenance?: {
+                refs: {
+                    ns?: string | undefined;
+                    id: string;
+                    role?: "absorbed" | "alias" | "derived" | "piece" | "primary" | undefined;
+                }[];
+                lineage?: {
+                    op: "attach" | "convert" | "duplicate" | "import" | "make-independent" | "merge" | "promote" | "split";
+                    fromIds: string[];
+                } | undefined;
+            } | undefined;
+            id: `item_${string}`;
+            type: "item";
+            position: [number, number, number];
+            rotation: [number, number, number];
+            scale: [number, number, number];
+            side?: "back" | "front" | undefined;
+            children: string[];
+            wallId?: string | undefined;
+            wallT?: number | undefined;
+            roofSegmentId?: string | undefined;
+            roofFace?: "back" | "front" | "left" | "right" | undefined;
+            blockFaceId?: string | undefined;
+            supportSlabId?: string | undefined;
+            collectionIds?: `collection_${string}`[] | undefined;
+            slots?: Record<string, string> | undefined;
+            source?: {
+                kind: "script";
+                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;
+                manifest: {
+                    bounds: {
+                        min: [number, number, number];
+                        max: [number, number, number];
+                    };
+                    params: {
+                        id: string;
+                        label?: string | undefined;
+                        kind: "boolean" | "number" | "string";
+                        default: string | number | boolean;
+                        min?: number | undefined;
+                        max?: number | undefined;
+                        step?: number | undefined;
+                        unit?: string | undefined;
+                        options?: string[] | undefined;
+                    }[];
+                    parts: {
+                        id: string;
+                        label?: string | undefined;
+                        type?: string | undefined;
+                        bounds?: {
+                            min: [number, number, number];
+                            max: [number, number, number];
+                        } | undefined;
+                    }[];
+                    surfaces: {
+                        part?: string | undefined;
+                        y: number;
+                        polygon: [number, number][];
+                    }[];
+                    slots: {
+                        id: string;
+                        label?: string | undefined;
+                        color?: string | undefined;
+                        roughness?: number | undefined;
+                        metalness?: number | undefined;
+                        transparent?: boolean | undefined;
+                        emissive?: boolean | undefined;
+                    }[];
+                    anchors: {
+                        id: string;
+                        position: [number, number, number];
+                        normal?: [number, number, number] | undefined;
+                    }[];
+                    lights: {
+                        id: string;
+                        position: [number, number, number];
+                        color: string;
+                        intensity: number;
+                        distance?: number | undefined;
+                    }[];
+                    undersides: {
+                        part?: string | undefined;
+                        polygon: [number, number][];
+                        plane: [number, number, number, number];
+                    }[];
+                    animations: {
+                        name: string;
+                        duration: number;
+                    }[];
+                    cutters?: {
+                        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;
+                };
+                images?: {
+                    artifact: string;
+                    thumbnail: string;
+                    floorPlan: string;
+                } | undefined;
+            } | undefined;
+            asset: {
+                id: string;
+                category: string;
+                name: string;
+                thumbnail: string;
+                floorPlanUrl?: string | undefined;
+                source: "community" | "library" | "mine";
+                isDraft?: boolean | undefined;
+                src: string;
+                dimensions: [number, number, number];
+                attachTo?: "ceiling" | "wall" | "wall-side" | undefined;
+                recessed?: boolean | undefined;
+                tags?: string[] | undefined;
+                functionTags?: string[] | undefined;
+                offset: [number, number, number];
+                rotation: [number, number, number];
+                scale: [number, number, number];
+                surface?: {
+                    height: number;
+                } | undefined;
+                interactive?: {
+                    controls: ({
+                        kind: "toggle";
+                        label?: string | undefined;
+                        default?: boolean | undefined;
+                    } | {
+                        kind: "slider";
+                        label: string;
+                        min: number;
+                        max: number;
+                        step: number;
+                        unit?: string | undefined;
+                        displayMode: "dial" | "slider" | "stepper";
+                        default?: number | undefined;
+                    } | {
+                        kind: "temperature";
+                        label: string;
+                        min: number;
+                        max: number;
+                        unit: "C" | "F";
+                        default?: number | undefined;
+                    })[];
+                    effects: ({
+                        kind: "animation";
+                        mode?: "ambient" | "open-close" | undefined;
+                        control?: number | undefined;
+                        clips: {
+                            on?: string | undefined;
+                            off?: string | undefined;
+                            loop?: string | undefined;
+                        };
+                    } | {
+                        kind: "light";
+                        color: string;
+                        intensityRange: [number, number];
+                        distance?: number | undefined;
+                        offset: [number, number, number];
+                    })[];
+                } | undefined;
+            };
+        } | {
+            object: "node";
+            name?: string | undefined;
+            parentId: string | null;
+            visible: boolean;
+            camera?: {
+                position: [number, number, number];
+                target: [number, number, number];
+                mode: "orthographic" | "perspective";
+                fov?: number | undefined;
+                zoom?: number | undefined;
+            } | undefined;
+            metadata: Record<string, unknown>;
+            provenance?: {
+                refs: {
+                    ns?: string | undefined;
+                    id: string;
+                    role?: "absorbed" | "alias" | "derived" | "piece" | "primary" | undefined;
+                }[];
+                lineage?: {
+                    op: "attach" | "convert" | "duplicate" | "import" | "make-independent" | "merge" | "promote" | "split";
+                    fromIds: string[];
+                } | undefined;
+            } | undefined;
+            id: `level_${string}`;
+            type: "level";
+            children: (`block_${string}` | `ceiling_${string}` | `column_${string}` | `construction-dimension_${string}` | `duct-fitting_${string}` | `duct-segment_${string}` | `duct-terminal_${string}` | `fence_${string}` | `floor-opening_${string}` | `guide_${string}` | `hvac-equipment_${string}` | `imesh_${string}` | `item_${string}` | `lineset_${string}` | `liquid-line_${string}` | `measurement_${string}` | `pipe-fitting_${string}` | `pipe-segment_${string}` | `pipe-trap_${string}` | `procedural-item_${string}` | `roof_${string}` | `scan_${string}` | `separator_${string}` | `shelf_${string}` | `slab_${string}` | `spawn_${string}` | `stair_${string}` | `structural-grid_${string}` | `wall_${string}` | `zone_${string}`)[];
+            level: number;
+            baseElevation: number;
+            height?: number | undefined;
+        } | {
+            object: "node";
+            name?: string | undefined;
+            parentId: string | null;
+            visible: boolean;
+            camera?: {
+                position: [number, number, number];
+                target: [number, number, number];
+                mode: "orthographic" | "perspective";
+                fov?: number | undefined;
+                zoom?: number | undefined;
+            } | undefined;
+            metadata: Record<string, unknown>;
+            provenance?: {
+                refs: {
+                    ns?: string | undefined;
+                    id: string;
+                    role?: "absorbed" | "alias" | "derived" | "piece" | "primary" | undefined;
+                }[];
+                lineage?: {
+                    op: "attach" | "convert" | "duplicate" | "import" | "make-independent" | "merge" | "promote" | "split";
+                    fromIds: string[];
+                } | undefined;
+            } | undefined;
+            id: `door_${string}`;
+            type: "door";
+            material?: {
+                id?: string | 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: "back" | "double" | "front";
+                } | undefined;
+                texture?: {
+                    url: string;
+                    repeat?: [number, number] | undefined;
+                    scale?: number | undefined;
+                } | undefined;
+            } | undefined;
+            slots?: Record<string, string> | undefined;
+            source?: {
+                kind: "script";
+                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;
+                manifest: {
+                    bounds: {
+                        min: [number, number, number];
+                        max: [number, number, number];
+                    };
+                    params: {
+                        id: string;
+                        label?: string | undefined;
+                        kind: "boolean" | "number" | "string";
+                        default: string | number | boolean;
+                        min?: number | undefined;
+                        max?: number | undefined;
+                        step?: number | undefined;
+                        unit?: string | undefined;
+                        options?: string[] | undefined;
+                    }[];
+                    parts: {
+                        id: string;
+                        label?: string | undefined;
+                        type?: string | undefined;
+                        bounds?: {
+                            min: [number, number, number];
+                            max: [number, number, number];
+                        } | undefined;
+                    }[];
+                    surfaces: {
+                        part?: string | undefined;
+                        y: number;
+                        polygon: [number, number][];
+                    }[];
+                    slots: {
+                        id: string;
+                        label?: string | undefined;
+                        color?: string | undefined;
+                        roughness?: number | undefined;
+                        metalness?: number | undefined;
+                        transparent?: boolean | undefined;
+                        emissive?: boolean | undefined;
+                    }[];
+                    anchors: {
+                        id: string;
+                        position: [number, number, number];
+                        normal?: [number, number, number] | undefined;
+                    }[];
+                    lights: {
+                        id: string;
+                        position: [number, number, number];
+                        color: string;
+                        intensity: number;
+                        distance?: number | undefined;
+                    }[];
+                    undersides: {
+                        part?: string | undefined;
+                        polygon: [number, number][];
+                        plane: [number, number, number, number];
+                    }[];
+                    animations: {
+                        name: string;
+                        duration: number;
+                    }[];
+                    cutters?: {
+                        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;
+                };
+                images?: {
+                    artifact: string;
+                    thumbnail: string;
+                    floorPlan: string;
+                } | undefined;
+            } | undefined;
+            position: [number, number, number];
+            rotation: [number, number, number];
+            side?: "back" | "front" | undefined;
+            verticalAnchor?: "floor" | "wall" | undefined;
+            floorThresholdVersion: 0 | 1;
+            wallId?: string | undefined;
+            roofSegmentId?: string | 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;
+        } | {
+            object: "node";
+            name?: string | undefined;
+            parentId: string | null;
+            visible: boolean;
+            camera?: {
+                position: [number, number, number];
+                target: [number, number, number];
+                mode: "orthographic" | "perspective";
+                fov?: number | undefined;
+                zoom?: number | undefined;
+            } | undefined;
+            metadata: Record<string, unknown>;
+            provenance?: {
+                refs: {
+                    ns?: string | undefined;
+                    id: string;
+                    role?: "absorbed" | "alias" | "derived" | "piece" | "primary" | undefined;
+                }[];
+                lineage?: {
+                    op: "attach" | "convert" | "duplicate" | "import" | "make-independent" | "merge" | "promote" | "split";
+                    fromIds: string[];
+                } | undefined;
+            } | undefined;
+            id: `building_${string}`;
+            type: "building";
+            children: (`elevator_${string}` | `level_${string}` | `unit_${string}`)[];
+            position: [number, number, number];
+            rotation: [number, number, number];
+            groundLevelId?: `level_${string}` | undefined;
+        };
+    };
+    rootNodeIds: `building_${string}`[];
+};
+export declare const WALL_OPENING_REFUSALS: readonly ['wall_not_found', 'not_a_wall', 'curved_wall', 'position_required', 'conflicting_position', 'wall_too_short', 'opening_overlap', 'style_needs_fixed_window'];
+export type WallOpeningRefusal = (typeof WALL_OPENING_REFUSALS)[number];
+export type WallOpeningCase = {
+    name: string;
+    tool: 'add_door' | 'add_window';
+    input: Record<string, unknown>;
+    expect: {
+        refusal: WallOpeningRefusal;
+        mentions?: string[];
+    } | {
+        localX: number;
+        centerY: number;
+        clamped: boolean;
+        glassPanels?: boolean;
+        /** Fields the opening built has. */
+        node?: Record<string, unknown>;
+    };
+};
+export declare const WALL_OPENING_CASES: readonly WallOpeningCase[];
+//# sourceMappingURL=wall-opening-cases.d.ts.map