@pascal-app/core 1.0.4 → 1.0.5

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

@@ -6,86 +6,81 @@
  * 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";
+    readonly buildingId: 'building_openings';
+    readonly levelId: 'level_openings';
     /** 4 m straight wall, 2.5 m tall. */
-    readonly main: "wall_main";
+    readonly main: 'wall_main';
     /** 0.8 m: shorter than a default door. */
-    readonly short: "wall_short";
+    readonly short: 'wall_short';
     /** 0.9 m: exactly a default door. */
-    readonly exact: "wall_exact";
+    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";
+    readonly busy: 'wall_busy';
+    readonly existingDoor: 'door_existing';
     /** 4 m wall bowed 0.5 m. */
-    readonly curved: "wall_curved";
+    readonly curved: 'wall_curved';
     /** 4 m wall with no height of its own: the 2.8 m storey decides. */
-    readonly storey: "wall_storey";
+    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";
+    readonly shelved: 'wall_shelved';
+    readonly wallShelf: 'item_wall_shelf';
     /** 4 m outside wall, its outside at the front (+normal). */
-    readonly outFront: "wall_out_front";
+    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";
+    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;
-            metadata: Record<string, unknown>;
-            id: `wall_${string}`;
-            type: "wall";
-            children: (`item_${string}` | `procedural-item_${string}` | `door_${string}` | `window_${string}` | `leanto_${string}`)[];
-            start: [number, number];
-            end: [number, number];
-            frontSide: "unknown" | "interior" | "exterior";
-            backSide: "unknown" | "interior" | "exterior";
-            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;
-            wallType?: "standard" | "curtain" | undefined;
+            id: `wall_${string}`;
+            type: "wall";
+            wallType?: "curtain" | "standard" | undefined;
             curtainWall?: {
                 construction: "stick" | "unitized";
-                framing: "capped" | "vertical-caps" | "horizontal-caps" | "structural-glazing";
+                framing: "capped" | "horizontal-caps" | "structural-glazing" | "vertical-caps";
                 columns: {
-                    layout: "count" | "maximum-spacing" | "fixed-spacing";
+                    layout: "count" | "fixed-spacing" | "maximum-spacing";
                     count: number;
                     spacing: number;
-                    alignment: "center" | "start" | "end";
+                    alignment: "center" | "end" | "start";
                 };
                 rows: {
-                    layout: "count" | "maximum-spacing" | "fixed-spacing";
+                    layout: "count" | "fixed-spacing" | "maximum-spacing";
                     count: number;
                     spacing: number;
-                    alignment: "center" | "start" | "end";
+                    alignment: "center" | "end" | "start";
                 };
                 mullionWidth: number;
                 transomWidth: number;
                 perimeterWidth: number;
                 jointWidth: number;
                 glassThickness: number;
-                panelType: "glass" | "solid" | "empty";
-                spandrel: "top" | "none" | "bottom";
+                panelType: "empty" | "glass" | "solid";
+                spandrel: "bottom" | "none" | "top";
                 frameColor: string;
                 glassColor: string;
                 solidColor: string;
@@ -94,19 +89,20 @@ export declare function openingScene(): {
                 panels: {
                     column: number;
                     row: number;
-                    type: "glass" | "solid" | "empty";
+                    type: "empty" | "glass" | "solid";
                 }[];
             } | undefined;
+            children: (`door_${string}` | `item_${string}` | `leanto_${string}` | `procedural-item_${string}` | `window_${string}`)[];
             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;
@@ -117,14 +113,14 @@ export declare function openingScene(): {
             materialPreset?: string | undefined;
             interiorMaterial?: {
                 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;
@@ -135,14 +131,14 @@ export declare function openingScene(): {
             interiorMaterialPreset?: string | undefined;
             exteriorMaterial?: {
                 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;
@@ -156,14 +152,14 @@ export declare function openingScene(): {
                 a?: {
                     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;
@@ -176,14 +172,14 @@ export declare function openingScene(): {
                 b?: {
                     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;
@@ -197,17 +193,17 @@ export declare function openingScene(): {
             faceRegions?: {
                 id: string;
                 face: "a" | "b";
-                finish: string;
                 u0?: number | undefined;
                 u1?: number | undefined;
                 v0?: number | undefined;
                 v1?: number | undefined;
+                finish: string;
             }[] | undefined;
             thickness?: number | undefined;
             assembly?: {
                 layers: {
                     id: string;
-                    role: "fill" | "shell" | "finish" | "lining" | "substrate" | "sheathing" | "membrane" | "underlay" | "insulation" | "air" | "furring" | "structure" | "deck" | "covering" | "glazing";
+                    role: "air" | "covering" | "deck" | "fill" | "finish" | "furring" | "glazing" | "insulation" | "lining" | "membrane" | "sheathing" | "shell" | "structure" | "substrate" | "underlay";
                     thickness: number;
                     core?: true | undefined;
                     material?: string | undefined;
@@ -221,7 +217,7 @@ export declare function openingScene(): {
                 }[];
                 backing?: {
                     id: string;
-                    role: "fill" | "shell" | "finish" | "lining" | "substrate" | "sheathing" | "membrane" | "underlay" | "insulation" | "air" | "furring" | "structure" | "deck" | "covering" | "glazing";
+                    role: "air" | "covering" | "deck" | "fill" | "finish" | "furring" | "glazing" | "insulation" | "lining" | "membrane" | "sheathing" | "shell" | "structure" | "substrate" | "underlay";
                     thickness: number;
                     core?: true | undefined;
                     material?: string | undefined;
@@ -233,7 +229,7 @@ export declare function openingScene(): {
                     lift?: number | undefined;
                     src?: string | undefined;
                 }[] | undefined;
-                face?: "front" | "exterior" | undefined;
+                face?: "exterior" | "front" | undefined;
                 presetId?: string | undefined;
                 cavityInsulation?: string | undefined;
             } | undefined;
@@ -243,6 +239,7 @@ export declare function openingScene(): {
             supportSlabId?: string | undefined;
             supportOffset?: number | undefined;
             fillToTerrain?: boolean | undefined;
+            cap?: boolean | undefined;
             underpinning?: {
                 rim: number;
                 stem: number;
@@ -255,130 +252,272 @@ export declare function openingScene(): {
             } | undefined;
             skirting?: {
                 enabled: boolean;
-                sides: "a" | "b" | "interior" | "exterior" | "both";
+                sides: "a" | "b" | "both" | "exterior" | "interior";
                 height: number;
                 proud: number;
-                profile: "flat" | "bevel" | "triangle" | "cove" | "bullnose" | "base-modern" | "base-colonial" | "base-shoe" | "base-ogee" | "crown-cove" | "crown-ogee" | "crown-craftsman" | "crown-layered" | "rail-rounded" | "rail-ogee" | "rail-picture" | "rail-stepped";
+                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" | "interior" | "exterior" | "both";
+                sides: "a" | "b" | "both" | "exterior" | "interior";
                 height: number;
                 proud: number;
-                profile: "flat" | "bevel" | "triangle" | "cove" | "bullnose" | "base-modern" | "base-colonial" | "base-shoe" | "base-ogee" | "crown-cove" | "crown-ogee" | "crown-craftsman" | "crown-layered" | "rail-rounded" | "rail-ogee" | "rail-picture" | "rail-stepped";
+                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" | "interior" | "exterior" | "both";
+                sides: "a" | "b" | "both" | "exterior" | "interior";
                 height: number;
                 proud: number;
-                profile: "flat" | "bevel" | "triangle" | "cove" | "bullnose" | "base-modern" | "base-colonial" | "base-shoe" | "base-ogee" | "crown-cove" | "crown-ogee" | "crown-craftsman" | "crown-layered" | "rail-rounded" | "rail-ogee" | "rail-picture" | "rail-stepped";
+                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;
-        } | {
-            object: "node";
-            parentId: string | null;
-            visible: boolean;
-            metadata: Record<string, unknown>;
-            id: `item_${string}`;
-            type: "item";
-            position: [number, number, number];
-            rotation: [number, number, number];
-            scale: [number, number, number];
-            children: string[];
-            asset: {
-                id: string;
-                category: string;
-                name: string;
-                thumbnail: string;
-                source: "library" | "community" | "mine";
-                src: string;
-                dimensions: [number, number, number];
-                offset: [number, number, number];
-                rotation: [number, number, number];
-                scale: [number, number, number];
-                floorPlanUrl?: string | undefined;
-                isDraft?: boolean | undefined;
-                attachTo?: "wall" | "ceiling" | "wall-side" | undefined;
-                recessed?: boolean | undefined;
-                tags?: string[] | undefined;
-                functionTags?: string[] | undefined;
-                surface?: {
-                    height: number;
+            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;
-                interactive?: {
-                    controls: ({
-                        kind: "toggle";
-                        label?: string | undefined;
-                        default?: boolean | undefined;
-                    } | {
-                        kind: "slider";
-                        label: string;
-                        min: number;
-                        max: number;
-                        step: number;
-                        displayMode: "slider" | "stepper" | "dial";
-                        unit?: string | undefined;
-                        default?: number | undefined;
-                    } | {
-                        kind: "temperature";
-                        label: string;
-                        min: number;
-                        max: number;
-                        unit: "C" | "F";
-                        default?: number | undefined;
-                    })[];
-                    effects: ({
-                        kind: "animation";
-                        clips: {
-                            on?: string | undefined;
-                            off?: string | undefined;
-                            loop?: string | 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];
                         };
-                        mode?: "ambient" | "open-close" | undefined;
-                        control?: number | undefined;
-                    } | {
-                        kind: "light";
-                        color: string;
-                        intensityRange: [number, number];
-                        offset: [number, number, number];
-                        distance?: number | undefined;
-                    })[];
+                        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: "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;
-            side?: "front" | "back" | 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?: "left" | "right" | "front" | "back" | 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";
-                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;
@@ -389,9 +528,9 @@ export declare function openingScene(): {
                     };
                     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;
@@ -408,9 +547,9 @@ export declare function openingScene(): {
                         } | undefined;
                     }[];
                     surfaces: {
+                        part?: string | undefined;
                         y: number;
                         polygon: [number, number][];
-                        part?: string | undefined;
                     }[];
                     slots: {
                         id: string;
@@ -434,115 +573,161 @@ export declare function openingScene(): {
                         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;
+            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>;
-            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;
+            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: "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;
@@ -553,7 +738,13 @@ export declare function openingScene(): {
             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;
@@ -564,9 +755,9 @@ export declare function openingScene(): {
                     };
                     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;
@@ -583,9 +774,9 @@ export declare function openingScene(): {
                         } | undefined;
                     }[];
                     surfaces: {
+                        part?: string | undefined;
                         y: number;
                         polygon: [number, number][];
-                        part?: string | undefined;
                     }[];
                     slots: {
                         id: string;
@@ -609,112 +800,125 @@ export declare function openingScene(): {
                         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;
             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;
         } | {
             object: "node";
+            name?: string | undefined;
             parentId: string | null;
             visible: boolean;
-            metadata: Record<string, unknown>;
-            id: `level_${string}`;
-            type: "level";
-            children: (`block_${string}` | `ceiling_${string}` | `item_${string}` | `procedural-item_${string}` | `column_${string}` | `construction-dimension_${string}` | `wall_${string}` | `roof_${string}` | `slab_${string}` | `separator_${string}` | `floor-opening_${string}` | `fence_${string}` | `structural-grid_${string}` | `imesh_${string}` | `zone_${string}` | `stair_${string}` | `scan_${string}` | `guide_${string}` | `measurement_${string}` | `spawn_${string}` | `shelf_${string}` | `duct-segment_${string}` | `duct-fitting_${string}` | `duct-terminal_${string}` | `hvac-equipment_${string}` | `lineset_${string}` | `liquid-line_${string}` | `pipe-segment_${string}` | `pipe-fitting_${string}` | `pipe-trap_${string}`)[];
-            level: number;
-            baseElevation: 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;
-            height?: number | undefined;
-        } | {
-            object: "node";
-            parentId: string | null;
-            visible: boolean;
-            metadata: Record<string, unknown>;
             id: `building_${string}`;
             type: "building";
             children: (`elevator_${string}` | `level_${string}` | `unit_${string}`)[];
             position: [number, number, number];
             rotation: [number, number, number];
-            name?: string | undefined;
-            camera?: {
-                position: [number, number, number];
-                target: [number, number, number];
-                mode: "perspective" | "orthographic";
-                fov?: number | undefined;
-                zoom?: number | undefined;
-            } | undefined;
-            provenance?: {
-                refs: {
-                    id: string;
-                    ns?: string | undefined;
-                    role?: "primary" | "piece" | "absorbed" | "alias" | "derived" | undefined;
-                }[];
-                lineage?: {
-                    op: "import" | "split" | "merge" | "duplicate" | "convert" | "promote" | "make-independent" | "attach";
-                    fromIds: string[];
-                } | undefined;
-            } | undefined;
+            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 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;