@pascal-app/core 1.0.1 → 1.0.4

package/dist/store/actions/node-actions.d.ts

@@ -1,8 +1,13 @@
+import type { StructurePlan } from '../../commands/structure/shared.js';
 import { type AnyNode, type AnyNodeId } from '../../schema/index.js';
+import type { Collection, CollectionId } from '../../schema/collections.js';
+import { type DerivedWriteOptions } from '../derived-node-guard.js';
 import type { SceneState } from '../use-scene.js';
 type NodeCreateOp = {
     node: AnyNode;
     parentId?: AnyNodeId;
+    /** Collections the node joins, for any kind; an item's own `collectionIds` otherwise. */
+    collectionIds?: CollectionId[];
 };
 type NodeUpdateOp = {
     id: AnyNodeId;
@@ -16,20 +21,4570 @@ type NumericSanitizeIssue = {
     action: 'clamped' | 'dropped' | 'rounded';
 };
 export declare function numericSanitizeIssuesToMessage(issues: NumericSanitizeIssue[] | null | undefined): string;
-declare const createNodesActionImpl: (set: (fn: (state: SceneState) => Partial<SceneState>) => void, get: () => SceneState, ops: NodeCreateOp[]) => void;
+declare const createNodesActionImpl: (set: (fn: (state: SceneState) => Partial<SceneState>) => void, get: () => SceneState, ops: NodeCreateOp[], options?: DerivedWriteOptions) => void;
+/**
+ * A created node joins the collections it is given, or an item those its mirror
+ * names, so a duplicate or a same-project paste stays a member; ids of
+ * collections this scene lacks (a paste from another project) are dropped.
+ * Writes the joined collections into `collections` and returns the node, an
+ * item with its mirror set to what it joined.
+ */
+export declare function joinCollections(collections: Record<CollectionId, Collection>, node: AnyNode, requested?: `collection_${string}`[] | undefined): AnyNode;
+/** The collections `id` belongs to: membership lives on the collection for every kind. */
+export declare function collectionIdsOf(collections: Readonly<Record<CollectionId, Collection>>, id: AnyNodeId): CollectionId[];
 declare const applyNodeChangesActionImpl: (set: (fn: (state: SceneState) => Partial<SceneState>) => void, get: () => SceneState, changes: {
     create?: NodeCreateOp[];
     update?: NodeUpdateOp[];
     delete?: NodeDeleteOp[];
-}) => void;
+}, options?: DerivedWriteOptions) => void;
 declare const updateNodesActionImpl: (set: (fn: (state: SceneState) => Partial<SceneState>) => void, get: () => SceneState, updates: {
     id: AnyNodeId;
     data: Partial<AnyNode>;
-}[]) => void;
-declare const deleteNodesActionImpl: (set: (fn: (state: SceneState) => Partial<SceneState>) => void, get: () => SceneState, ids: AnyNodeId[]) => void;
-export declare const createNodesAction: (set: Parameters<typeof createNodesActionImpl>[0], get: Parameters<typeof createNodesActionImpl>[1], ops: NodeCreateOp[]) => void;
-export declare const applyNodeChangesAction: (set: Parameters<typeof applyNodeChangesActionImpl>[0], get: Parameters<typeof applyNodeChangesActionImpl>[1], changes: Parameters<typeof applyNodeChangesActionImpl>[2]) => void;
-export declare const updateNodesAction: (set: Parameters<typeof updateNodesActionImpl>[0], get: Parameters<typeof updateNodesActionImpl>[1], updates: Parameters<typeof updateNodesActionImpl>[2]) => void;
-export declare const deleteNodesAction: (set: Parameters<typeof deleteNodesActionImpl>[0], get: Parameters<typeof deleteNodesActionImpl>[1], ids: AnyNodeId[]) => void;
+}[], options?: DerivedWriteOptions, deferDirty?: boolean) => void;
+/** The scene record a node deletion reads and rewrites. */
+export type NodeDeletionScene = Pick<SceneState, 'nodes' | 'rootNodeIds' | 'collections'>;
+/** What deleting `ids` does to a scene, before anything is committed. */
+export type NodeDeletionPlan = NodeDeletionScene & {
+    /** Every removed id: the requested ids, their subtrees, kind cascades, merged-away walls. */
+    deletedIds: Set<AnyNodeId>;
+    parentsToMarkDirty: Set<AnyNodeId>;
+    nodesToMarkDirty: Set<AnyNodeId>;
+    /** Preview only: existing default gutters and downspouts the refresh may keep or replace. */
+    unsettledIds: Set<AnyNodeId>;
+    /** Preview only: roof segments whose `children` the refresh rewrites. */
+    regeneratedHostIds: Set<AnyNodeId>;
+};
+/**
+ * The delete store action's planner, without committing: the requested ids,
+ * their `children` subtrees and kind `onDeleteCascade` companions, collinear
+ * walls merged across a deleted junction, the separators that keep two rooms
+ * apart when the wall between them goes, derived-construction deletion intent,
+ * neighbour patches, support and unit cleanup, and the default gutter and
+ * downspout refresh.
+ *
+ * The refresh mints gutters, downspouts and outlets with random ids, and which
+ * existing defaults it keeps can depend on them. With `mintDefaults: false`
+ * (a preview, such as the MCP patch dry run) the refresh does not run: the
+ * existing defaults it would touch are listed in `unsettledIds`, and the plan
+ * is deterministic and equals the commit for every other existing id. The
+ * delete action mints.
+ */
+export declare function planNodeDeletion(scene: NodeDeletionScene, ids: AnyNodeId[], { mintDefaults, options, wallDeletionPlan, }?: {
+    mintDefaults?: boolean;
+    options?: DerivedWriteOptions;
+    /** A caller-owned room-preserving plan; otherwise planned here unless detection is paused. */
+    wallDeletionPlan?: StructurePlan;
+}): NodeDeletionPlan;
+declare const deleteNodesActionImpl: (set: (fn: (state: SceneState) => Partial<SceneState>) => void, get: () => SceneState, ids: AnyNodeId[], options?: DerivedWriteOptions, wallDeletionPlan?: StructurePlan) => void;
+/** Runs the same deletion hooks and update constraints for headless scene owners. */
+export declare function planSceneNodeChanges(snapshot: Pick<SceneState, 'nodes' | 'rootNodeIds' | 'collections'>, changes: {
+    update?: NodeUpdateOp[];
+    delete?: AnyNodeId[];
+    wallDeletionPlan?: StructurePlan;
+}): {
+    nodes: Record<`block_${string}` | `bvent_${string}` | `elevator_${string}` | `ceiling_${string}` | `item_${string}` | `procedural-item_${string}` | `column_${string}` | `construction-dimension_${string}` | `site_${string}` | `building_${string}` | `level_${string}` | `wall_${string}` | `door_${string}` | `window_${string}` | `leanto_${string}` | `roof_${string}` | `rseg_${string}` | `slab_${string}` | `separator_${string}` | `floor-opening_${string}` | `fence_${string}` | `structural-grid_${string}` | `imesh_${string}` | `zone_${string}` | `stair_${string}` | `sseg_${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}` | `unit_${string}` | `fence-gate_${string}` | `fence-opening_${string}` | `cabinet_${string}` | `cabinet-module_${string}` | `rvent_${string}` | `tvent_${string}` | `cupola_${string}` | `eyebrow-vent_${string}` | `gutter_${string}` | `chimney_${string}` | `solarpanel_${string}` | `skylight_${string}` | `dormer_${string}` | `downspout_${string}`, {
+        object: "node";
+        id: `site_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        polygon: {
+            type: "polygon";
+            points: [number, number][];
+        };
+        children: string[];
+        type: "site";
+        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;
+        terrain?: {
+            type: "heightfield";
+            origin: [number, number];
+            spacing: number;
+            cols: number;
+            rows: number;
+            step: number;
+            heights: string;
+        } | undefined;
+        address?: {
+            street?: string | undefined;
+            city?: string | undefined;
+            state?: string | undefined;
+            zip?: string | undefined;
+        } | undefined;
+        parcel?: {
+            apn?: string | undefined;
+            source?: string | undefined;
+            county?: string | undefined;
+            state?: string | undefined;
+            lotAreaSqFt?: number | undefined;
+            originLngLat?: [number, number] | undefined;
+            resolvedAt?: string | undefined;
+            layer?: string | undefined;
+            notes?: string[] | undefined;
+        } | undefined;
+        setbacks?: {
+            front: number;
+            side: number;
+            rear: number;
+            left?: number | undefined;
+            right?: number | undefined;
+            streetSide?: number | undefined;
+        } | undefined;
+        setbacksSource?: string | undefined;
+        zone?: string | undefined;
+        frontEdge?: number | undefined;
+        streetEdges?: number[] | undefined;
+        sightTriangleFt?: number | undefined;
+        northRotation?: number | undefined;
+        dossier?: {
+            [x: string]: unknown;
+            provider: string;
+            asOf: string;
+            sections: Record<string, {
+                [x: string]: unknown;
+                status: string;
+                summary?: string | undefined;
+                reason?: string | undefined;
+                source?: {
+                    name?: string | undefined;
+                    kind?: string | undefined;
+                    vintage?: string | undefined;
+                    attribution?: string | undefined;
+                } | undefined;
+            }>;
+            point?: {
+                lat?: number | undefined;
+                lng?: number | undefined;
+                source?: string | undefined;
+            } | undefined;
+            address?: {
+                formatted?: string | undefined;
+                precision?: string | undefined;
+            } | undefined;
+            parcel?: Record<string, unknown> | undefined;
+            flood?: Record<string, unknown> | undefined;
+            codeBasis?: Record<string, unknown> | undefined;
+            zoning?: Record<string, unknown> | undefined;
+            utilities?: Record<string, unknown> | undefined;
+            soils?: Record<string, unknown> | undefined;
+            wetlands?: Record<string, unknown> | undefined;
+            structures?: Record<string, unknown> | undefined;
+            elevation?: Record<string, unknown> | undefined;
+            boundaries?: Record<string, unknown> | undefined;
+        } | undefined;
+        contourIntervalIn?: number | undefined;
+        contours3d?: boolean | undefined;
+        terrainContours?: {
+            datum: string;
+            intervalFt: number;
+            lines: {
+                elevationFt: number;
+                points: [number, number][];
+            }[];
+            source?: string | undefined;
+        } | undefined;
+    } | {
+        object: "node";
+        position: [number, number, number];
+        id: `building_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        rotation: [number, number, number];
+        children: (`elevator_${string}` | `level_${string}` | `unit_${string}`)[];
+        type: "building";
+        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;
+    } | {
+        object: "node";
+        position: [number, number, number];
+        id: `elevator_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        depth: number;
+        rotation: number;
+        width: number;
+        shaftWallThickness: number;
+        shaftStyle: "glass" | "solid";
+        cabHeight: number;
+        doorWidth: number;
+        doorHeight: number;
+        doorStyle: "center-opening" | "single-left" | "single-right";
+        doorPanelStyle: "glass-frame" | "solid-panel" | "segmented-panel";
+        fromLevelId: string | null;
+        toLevelId: string | null;
+        disabledLevelIds: string[];
+        serviceOnlyLevelIds: string[];
+        defaultLevelId: string | null;
+        speed: number;
+        doorDurationMs: number;
+        dwellMs: number;
+        type: "elevator";
+        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;
+        slots?: Record<string, string> | undefined;
+        material?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        materialPreset?: string | undefined;
+        shaftWidth?: number | undefined;
+        shaftDepth?: number | undefined;
+        servedLevelIds?: string[] | undefined;
+    } | {
+        object: "node";
+        id: `unit_${string}`;
+        name: string;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        kind: "apartment" | "hotel-room" | "commercial" | "common";
+        color: string;
+        members: `zone_${string}`[];
+        type: "unit";
+        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;
+    } | {
+        object: "node";
+        id: `level_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        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;
+        type: "level";
+        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;
+        height?: number | undefined;
+    } | {
+        object: "node";
+        position: [number, number, number];
+        id: `leanto_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        rotation: [number, number, number];
+        children: (`column_${string}` | `roof_${string}`)[];
+        pitch: number;
+        shingleThickness: number;
+        canopyForm: "gable" | "mono" | "butterfly";
+        hostKind: "wall" | "slab-edge" | "freestanding" | "conical-roof";
+        hostHeightOffset: number;
+        span: number;
+        autoSpan: boolean;
+        projection: number;
+        highEdgeHeight: number;
+        lowEdgeHeight: number;
+        resizeLock: "preserve-high-edge" | "preserve-low-edge" | "preserve-pitch";
+        leftEndCondition: "open" | "wall-abutment" | "joined";
+        rightEndCondition: "open" | "wall-abutment" | "joined";
+        autoMiterCorners: boolean;
+        sideFlashing: boolean;
+        flashingProjection: number;
+        flashingHeight: number;
+        highSideMode: "wall-ledger" | "independent-high-beam";
+        ledgerVerticalOffset: number;
+        lowBeamInset: number;
+        gutterEnabled: boolean;
+        gutterProfile: "box" | "k-style" | "half-round";
+        gutterSize: number;
+        downspoutEnabled: boolean;
+        downspoutPosition: number;
+        connectionMode: "manual" | "auto";
+        connectionOffset: number;
+        connectionInset: number;
+        matchHostRoofMaterial: boolean;
+        matchHostRoofStructure: boolean;
+        roofThickness: number;
+        highOverhang: number;
+        lowOverhang: number;
+        leftOverhang: number;
+        rightOverhang: number;
+        coveringType: "generic" | "shingle" | "metal-panel";
+        beamWidth: number;
+        beamHeight: number;
+        ledgerDepth: number;
+        ledgerHeight: number;
+        rafterWidth: number;
+        rafterHeight: number;
+        rafterSpacing: number;
+        rafterEndInset: number;
+        framingStrategy: "hidden" | "rafters" | "purlins" | "covering-specific";
+        purlinWidth: number;
+        purlinHeight: number;
+        purlinSpacing: number;
+        postWidth: number;
+        postDepth: number;
+        postCount: number;
+        postLayoutMode: "count" | "target-spacing";
+        postSpacing: number;
+        postInset: number;
+        omittedPostSlots: {
+            side: "low" | "high";
+            index: number;
+            layoutCount: number;
+        }[];
+        postBracing: "none" | "knee";
+        footingStyle: "none" | "base-plate" | "concrete-pad";
+        type: "lean-to-extension";
+        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;
+        slots?: Record<string, string> | undefined;
+        hostSlabId?: `slab_${string}` | undefined;
+        hostSlabEdgeIndex?: number | undefined;
+        hostSlabEdgeT?: number | undefined;
+        spanArcCenterZ?: number | undefined;
+        spanArcRadius?: number | undefined;
+        hostRoofId?: `roof_${string}` | undefined;
+        hostRoofSegmentId?: string | undefined;
+        hostRoofEdge?: "+X" | "-X" | "+Z" | "-Z" | undefined;
+        hostRoofEdgeRange?: [number, number] | undefined;
+    } | {
+        object: "node";
+        position: [number, number, number];
+        id: `column_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        radius: number;
+        depth: number;
+        rotation: number;
+        children: string[];
+        width: number;
+        height: number;
+        baseHeight: number;
+        style: "plain" | "faceted" | "fluted" | "lathe-turned" | "dravidian-carved" | "cluster";
+        crossSection: "round" | "square" | "rectangular" | "octagonal" | "sixteen-sided";
+        edgeSoftness: number;
+        capitalHeight: number;
+        shaftProfile: "straight" | "tapered" | "bulged" | "baluster" | "hourglass";
+        shaftTaper: number;
+        shaftBulge: number;
+        shaftStartScale: number;
+        shaftEndScale: number;
+        shaftSegmentCount: number;
+        shaftTwistStep: number;
+        shaftCornerRadius: number;
+        shaftDetail: "fluted" | "lathe-turned" | "none" | "spiral" | "panelled";
+        baseStyle: "none" | "simple-square" | "round-rings" | "square-plinth" | "stepped-square" | "lotus" | "ribbed-lotus" | "panelled-pedestal";
+        baseWidthScale: number;
+        baseDepthScale: number;
+        baseTierCount: number;
+        baseStepSpread: number;
+        basePlinthHeightRatio: number;
+        baseRoundBandScale: number;
+        baseNeckScale: number;
+        baseRoundBandCount: number;
+        baseRibCount: number;
+        baseCarvingLevel: number;
+        basePanelInset: number;
+        capitalStyle: "none" | "simple" | "simple-slab" | "rounded" | "stepped" | "doric" | "volute" | "ionic-volute" | "leaf-carved" | "corinthian-leaf" | "south-indian-bracket" | "wood-bracket";
+        capitalWidthScale: number;
+        capitalDepthScale: number;
+        capitalTierCount: number;
+        capitalStepSpread: number;
+        capitalBandCount: number;
+        voluteSize: number;
+        voluteCount: number;
+        leafCount: number;
+        leafRows: number;
+        bracketDepth: number;
+        bracketTierCount: number;
+        pendantCount: number;
+        capitalCarvingLevel: number;
+        ringCount: number;
+        ringPlacement: "top" | "ends" | "even" | "bottom";
+        ringThickness: number;
+        ringSpread: number;
+        fluteCount: number;
+        fluteDepth: number;
+        fluteWidth: number;
+        spiralTwist: number;
+        spiralRibCount: number;
+        panelCount: number;
+        panelInsetDepth: number;
+        panelShape: "rectangle" | "arched" | "diamond";
+        latheRingCount: number;
+        latheRingSpacing: "top" | "ends" | "even" | "bottom";
+        carvingLevel: number;
+        carvingPlacement: "base" | "shaft" | "capital" | "all";
+        lowerBandEnabled: boolean;
+        lowerBandHeight: number;
+        lowerBandCarvingLevel: number;
+        dentilCount: number;
+        beadCount: number;
+        supportStyle: "vertical" | "a-frame" | "y-frame" | "v-frame" | "x-brace" | "k-brace" | "single-strut" | "tripod" | "trestle" | "portal-frame" | "box-frame";
+        braceWidth: number;
+        braceDepth: number;
+        braceBottomSpread: number;
+        braceTopSpread: number;
+        bracePlateEnabled: boolean;
+        type: "column";
+        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;
+        supportSlabId?: string | undefined;
+        slots?: Record<string, string> | undefined;
+        material?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        materialPreset?: string | undefined;
+        source?: {
+            kind: "script";
+            language: "three" | "bpy";
+            script: string;
+            params: Record<string, string | number | boolean>;
+            artifact: string;
+            manifest: {
+                bounds: {
+                    min: [number, number, number];
+                    max: [number, number, number];
+                };
+                params: {
+                    id: string;
+                    kind: "string" | "number" | "boolean";
+                    default: string | number | boolean;
+                    label?: string | undefined;
+                    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: {
+                    y: number;
+                    polygon: [number, number][];
+                    part?: string | undefined;
+                }[];
+                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: {
+                    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";
+                    polygon: number[][];
+                    minY: number;
+                    maxY: 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;
+    } | {
+        object: "node";
+        mode: "radius" | "linear" | "diameter" | "center-mark" | "chord" | "arc-length" | "angular" | "coordinate";
+        id: `construction-dimension_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        anchors: ([number, number, number] | {
+            kind: "feature";
+            reference: {
+                nodeId: string;
+                featureId: string;
+                parameters?: Record<string, string | number | boolean> | undefined;
+            };
+            fallback: [number, number, number];
+        })[];
+        baseline: {
+            origin: [number, number];
+            direction: [number, number];
+        };
+        chainMode: "point-to-point" | "continuous";
+        featureCount: number;
+        showCenterMark: boolean;
+        prefix: string;
+        suffix: string;
+        textOverride: string | null;
+        datumPolicy: "centerline" | "wall-face" | "structural-face" | "finish-face";
+        terminator: "architectural-tick" | "filled-arrow" | "open-arrow" | "dot";
+        textPosition: "above" | "centered";
+        imperialPrecision: "1" | "1/2" | "1/4" | "1/8" | "1/16";
+        metricNotation: "meters" | "millimeters";
+        extensionStartGap: number;
+        extensionOvershoot: number;
+        drawingType: "floor-plan" | "foundation-plan" | "reflected-ceiling-plan" | "roof-plan" | "site-plan";
+        drawingOverrides: {
+            drawingType: "floor-plan" | "foundation-plan" | "reflected-ceiling-plan" | "roof-plan" | "site-plan";
+            presentation: "shown" | "omit" | "controlled";
+            suppressedSegmentIndexes: number[];
+        }[];
+        controllingDimensionId: `construction-dimension_${string}` | null;
+        type: "construction-dimension";
+        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;
+    } | {
+        object: "node";
+        position: [number, number, number];
+        id: `block_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        rotation: number;
+        children: string[];
+        topology: {
+            vertices: {
+                id: string;
+                position: [number, number, number];
+            }[];
+            edges: {
+                id: string;
+                vertexIds: [string, string];
+            }[];
+            faces: {
+                id: string;
+                vertexIds: string[];
+                materialSlot: string;
+            }[];
+        };
+        slots: Record<string, string>;
+        slotNames: Record<string, string>;
+        type: "block";
+        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;
+        supportSlabId?: string | undefined;
+    } | {
+        object: "node";
+        id: `structural-grid_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        label: string;
+        start: [number, number];
+        end: [number, number];
+        showStartBubble: boolean;
+        showEndBubble: boolean;
+        type: "structural-grid";
+        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;
+    } | {
+        object: "node";
+        id: `wall_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        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";
+        type: "wall";
+        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;
+        supportSlabId?: string | undefined;
+        slots?: Record<string, string> | undefined;
+        material?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        materialPreset?: string | undefined;
+        height?: number | undefined;
+        wallType?: "standard" | "curtain" | undefined;
+        curtainWall?: {
+            construction: "stick" | "unitized";
+            framing: "capped" | "vertical-caps" | "horizontal-caps" | "structural-glazing";
+            columns: {
+                layout: "count" | "maximum-spacing" | "fixed-spacing";
+                count: number;
+                spacing: number;
+                alignment: "center" | "start" | "end";
+            };
+            rows: {
+                layout: "count" | "maximum-spacing" | "fixed-spacing";
+                count: number;
+                spacing: number;
+                alignment: "center" | "start" | "end";
+            };
+            mullionWidth: number;
+            transomWidth: number;
+            perimeterWidth: number;
+            jointWidth: number;
+            glassThickness: number;
+            panelType: "glass" | "solid" | "empty";
+            spandrel: "top" | "none" | "bottom";
+            frameColor: string;
+            glassColor: string;
+            solidColor: string;
+            glassOpacity: number;
+            glassRoughness: number;
+            panels: {
+                column: number;
+                row: number;
+                type: "glass" | "solid" | "empty";
+            }[];
+        } | undefined;
+        thickness?: number | undefined;
+        assembly?: {
+            layers: {
+                id: string;
+                role: "fill" | "shell" | "finish" | "lining" | "substrate" | "sheathing" | "membrane" | "underlay" | "insulation" | "air" | "furring" | "structure" | "deck" | "covering" | "glazing";
+                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: "fill" | "shell" | "finish" | "lining" | "substrate" | "sheathing" | "membrane" | "underlay" | "insulation" | "air" | "furring" | "structure" | "deck" | "covering" | "glazing";
+                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?: "front" | "exterior" | undefined;
+            presetId?: string | undefined;
+            cavityInsulation?: string | undefined;
+        } | undefined;
+        fillToTerrain?: boolean | undefined;
+        interiorMaterial?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        interiorMaterialPreset?: string | undefined;
+        exteriorMaterial?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        exteriorMaterialPreset?: string | undefined;
+        legacyFaceMaterials?: {
+            a?: {
+                material?: {
+                    id?: string | undefined;
+                    preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+                    properties?: {
+                        color: string;
+                        roughness: number;
+                        metalness: number;
+                        opacity: number;
+                        transparent: boolean;
+                        side: "front" | "back" | "double";
+                    } | undefined;
+                    texture?: {
+                        url: string;
+                        repeat?: [number, number] | undefined;
+                        scale?: number | undefined;
+                    } | undefined;
+                } | undefined;
+                materialPreset?: string | undefined;
+            } | undefined;
+            b?: {
+                material?: {
+                    id?: string | undefined;
+                    preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+                    properties?: {
+                        color: string;
+                        roughness: number;
+                        metalness: number;
+                        opacity: number;
+                        transparent: boolean;
+                        side: "front" | "back" | "double";
+                    } | undefined;
+                    texture?: {
+                        url: string;
+                        repeat?: [number, number] | undefined;
+                        scale?: number | undefined;
+                    } | undefined;
+                } | undefined;
+                materialPreset?: string | undefined;
+            } | undefined;
+        } | undefined;
+        faceRegions?: {
+            id: string;
+            face: "a" | "b";
+            finish: string;
+            u0?: number | undefined;
+            u1?: number | undefined;
+            v0?: number | undefined;
+            v1?: number | undefined;
+        }[] | undefined;
+        justification?: "a" | "b" | undefined;
+        curveOffset?: number | undefined;
+        supportOffset?: number | undefined;
+        underpinning?: {
+            rim: number;
+            stem: number;
+            openings?: {
+                u: number;
+                width: number;
+                top: number;
+                bottom: number;
+            }[] | undefined;
+        } | undefined;
+        skirting?: {
+            enabled: boolean;
+            sides: "a" | "b" | "interior" | "exterior" | "both";
+            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";
+            offsetY?: number | undefined;
+        } | undefined;
+        crown?: {
+            enabled: boolean;
+            sides: "a" | "b" | "interior" | "exterior" | "both";
+            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";
+            offsetY?: number | undefined;
+        } | undefined;
+        chairRail?: {
+            enabled: boolean;
+            sides: "a" | "b" | "interior" | "exterior" | "both";
+            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";
+            offsetY?: number | undefined;
+        } | undefined;
+    } | {
+        object: "node";
+        id: `separator_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        start: [number, number];
+        end: [number, number];
+        type: "separator";
+        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;
+    } | {
+        object: "node";
+        id: `floor-opening_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        polygon: [number, number][];
+        source: string;
+        drawnOn: "ceiling" | "floor";
+        cutsPrimary: boolean;
+        cutsAdjacent: boolean;
+        type: "floor-opening";
+        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;
+        surfaceId?: string | undefined;
+        hostZoneId?: string | undefined;
+        legacyPlateCuts?: Record<string, [number, number][][]> | undefined;
+        legacyCeilingCuts?: Record<string, [number, number][][]> | undefined;
+        ownerId?: string | undefined;
+    } | {
+        object: "node";
+        id: `fence_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        color: string;
+        children: string[];
+        height: number;
+        baseHeight: number;
+        style: "slat" | "rail" | "privacy" | "horizontal" | "guard" | "picket";
+        baseStyle: "floating" | "grounded" | "raised";
+        start: [number, number];
+        end: [number, number];
+        thickness: number;
+        postSpacing: number;
+        surfaceMode: "auto" | "level" | "selected";
+        transitionMode: "step" | "slope" | "break";
+        transitionWidth: number;
+        picketSpacing: number;
+        patternDistribution: "maximum-spacing" | "fixed-spacing" | "automatic" | "fixed-count" | "equal-fit";
+        patternAlignment: "center" | "start" | "end";
+        patternCount: number;
+        patternRemainder: "leave" | "spread";
+        picketWidth: number;
+        picketTop: "flat" | "rounded" | "pointed" | "dog-ear";
+        picketProfile: "arched" | "level" | "scalloped" | "alternating";
+        picketTopClearance: number;
+        picketVariation: number;
+        picketRailProjection: number;
+        picketRailCount: number;
+        postSize: number;
+        topRailHeight: number;
+        groundClearance: number;
+        edgeInset: number;
+        slatGap: number;
+        postCap: "flat" | "none" | "pyramid";
+        showInfill: boolean;
+        infillPlacement: "center" | "front" | "back";
+        type: "fence";
+        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;
+        path?: [number, number][] | undefined;
+        supportSlabId?: string | undefined;
+        slots?: Record<string, string> | undefined;
+        material?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        materialPreset?: string | undefined;
+        curveOffset?: number | undefined;
+        supportOffset?: number | undefined;
+        spanModes?: ("straight" | "curve")[] | undefined;
+        tangents?: ([number, number] | null)[] | undefined;
+        supportSurfaceNodeId?: string | undefined;
+        guardInfill?: "balusters" | "cable" | "boards" | undefined;
+        startPost?: boolean | undefined;
+        endPost?: boolean | undefined;
+        postThrough?: boolean | undefined;
+    } | {
+        object: "node";
+        id: `fence-gate_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        center: number;
+        width: number;
+        type: "fence-gate";
+        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;
+        height?: number | undefined;
+        style?: "match" | "slat" | "rail" | "privacy" | "horizontal" | "guard" | "picket" | undefined;
+        spacing?: number | undefined;
+        thickness?: number | undefined;
+        hinge?: "left" | "right" | undefined;
+        matchFenceStyle?: boolean | undefined;
+        matchFenceHeight?: boolean | undefined;
+        leafType?: "double" | "single" | undefined;
+        clearance?: number | undefined;
+        frameWidth?: number | undefined;
+        boardWidth?: number | undefined;
+        swing?: "inward" | "outward" | undefined;
+        openAngle?: number | undefined;
+        leafSplit?: number | undefined;
+        brace?: "none" | "cross" | "diagonal" | undefined;
+        showHardware?: boolean | undefined;
+        showPosts?: boolean | undefined;
+    } | {
+        object: "node";
+        id: `fence-opening_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        center: number;
+        width: number;
+        showPosts: boolean;
+        type: "fence-opening";
+        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;
+        height?: number | undefined;
+        matchFenceStyle?: boolean | undefined;
+        matchFenceHeight?: boolean | undefined;
+    } | {
+        object: "node";
+        position: [number, number, number];
+        id: `cabinet_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        depth: number;
+        rotation: number;
+        children: string[];
+        width: number;
+        operationState: number;
+        runTier: "wall" | "base" | "tall";
+        withWaterfall: boolean;
+        withFinishedEnds: boolean;
+        carcassHeight: number;
+        plinthHeight: number;
+        toeKickDepth: number;
+        boardThickness: number;
+        countertopThickness: number;
+        countertopOverhang: number;
+        countertopBackOverhang: number;
+        withFinishedBack: boolean;
+        frontThickness: number;
+        frontGap: number;
+        frontStyle: "slab" | "shaker" | "raised-arch";
+        panelReady: boolean;
+        handleStyle: "cutout" | "none" | "bar" | "hole" | "knob";
+        handlePosition: "center" | "top" | "auto";
+        frontOverlay: "inset" | "full";
+        withBottomPanel: boolean;
+        showPlinth: boolean;
+        withCountertop: boolean;
+        type: "cabinet";
+        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;
+        supportSlabId?: string | undefined;
+        slots?: Record<string, string> | undefined;
+        material?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        materialPreset?: string | undefined;
+        barLedge?: {
+            edge: "left" | "right" | "back";
+            height: number;
+            depth: number;
+        } | undefined;
+        stack?: ({
+            type: "shelf";
+            id: string;
+            shelfCount?: number | undefined;
+            height?: number | undefined;
+        } | {
+            type: "drawer";
+            id: string;
+            drawerCount?: number | undefined;
+            height?: number | undefined;
+        } | {
+            type: "door";
+            id: string;
+            doorType?: "glass" | "double" | "single-left" | "single-right" | undefined;
+            shelfCount?: number | undefined;
+            height?: number | undefined;
+        } | {
+            type: "sink";
+            id: string;
+            sinkLayout?: "double" | "single" | "double-offset" | undefined;
+            height?: number | undefined;
+        } | {
+            type: "oven";
+            id: string;
+            height?: number | undefined;
+        } | {
+            type: "microwave";
+            id: string;
+            height?: number | undefined;
+        } | {
+            type: "dishwasher";
+            id: string;
+            height?: number | undefined;
+        } | {
+            type: "cooktop-gas";
+            id: string;
+            cooktopLayout?: "gas-2burner" | "gas-4burner" | "gas-5burner-wok" | "gas-6burner" | undefined;
+            cooktopBurnersOn?: boolean | undefined;
+            cooktopActiveBurners?: number[] | undefined;
+            cooktopKnobProgress?: number[] | undefined;
+            cooktopShowGrate?: boolean | undefined;
+            height?: number | undefined;
+        } | {
+            type: "cooktop-induction";
+            id: string;
+            cooktopLayout?: "induction-2zone" | "induction-4zone" | undefined;
+            cooktopBurnersOn?: boolean | undefined;
+            cooktopActiveBurners?: number[] | undefined;
+            cooktopKnobProgress?: number[] | undefined;
+            cooktopShowGrate?: boolean | undefined;
+            height?: number | undefined;
+        } | {
+            type: "pull-out-pantry";
+            id: string;
+            shelfCount?: number | undefined;
+            pantryRackStyle?: "glass" | "wire" | "tray" | undefined;
+            height?: number | undefined;
+        } | {
+            type: "fridge-single";
+            id: string;
+            height?: number | undefined;
+        } | {
+            type: "fridge-double";
+            id: string;
+            height?: number | undefined;
+        } | {
+            type: "fridge-top-freezer";
+            id: string;
+            height?: number | undefined;
+        } | {
+            type: "fridge-bottom-freezer";
+            id: string;
+            height?: number | undefined;
+        } | {
+            type: "hood-pyramid";
+            id: string;
+            height?: number | undefined;
+        } | {
+            type: "hood-curved-glass";
+            id: string;
+            height?: number | undefined;
+        })[] | undefined;
+    } | {
+        object: "node";
+        position: [number, number, number];
+        id: `cabinet-module_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        depth: number;
+        rotation: number;
+        children: string[];
+        width: number;
+        operationState: number;
+        carcassHeight: number;
+        plinthHeight: number;
+        toeKickDepth: number;
+        boardThickness: number;
+        countertopThickness: number;
+        countertopOverhang: number;
+        countertopBackOverhang: number;
+        withFinishedBack: boolean;
+        frontThickness: number;
+        frontGap: number;
+        frontStyle: "slab" | "shaker" | "raised-arch";
+        panelReady: boolean;
+        handleStyle: "cutout" | "none" | "bar" | "hole" | "knob";
+        handlePosition: "center" | "top" | "auto";
+        frontOverlay: "inset" | "full";
+        withBottomPanel: boolean;
+        showPlinth: boolean;
+        withCountertop: boolean;
+        cabinetType: "base" | "tall";
+        moduleKind: "standard" | "corner-filler";
+        topFinish: "trim" | "none" | "top-cabinet";
+        topFinishHeight: number;
+        topFinishDepth: number;
+        type: "cabinet-module";
+        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;
+        supportSlabId?: string | undefined;
+        slots?: Record<string, string> | undefined;
+        material?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        materialPreset?: string | undefined;
+        stack?: ({
+            type: "shelf";
+            id: string;
+            shelfCount?: number | undefined;
+            height?: number | undefined;
+        } | {
+            type: "drawer";
+            id: string;
+            drawerCount?: number | undefined;
+            height?: number | undefined;
+        } | {
+            type: "door";
+            id: string;
+            doorType?: "glass" | "double" | "single-left" | "single-right" | undefined;
+            shelfCount?: number | undefined;
+            height?: number | undefined;
+        } | {
+            type: "sink";
+            id: string;
+            sinkLayout?: "double" | "single" | "double-offset" | undefined;
+            height?: number | undefined;
+        } | {
+            type: "oven";
+            id: string;
+            height?: number | undefined;
+        } | {
+            type: "microwave";
+            id: string;
+            height?: number | undefined;
+        } | {
+            type: "dishwasher";
+            id: string;
+            height?: number | undefined;
+        } | {
+            type: "cooktop-gas";
+            id: string;
+            cooktopLayout?: "gas-2burner" | "gas-4burner" | "gas-5burner-wok" | "gas-6burner" | undefined;
+            cooktopBurnersOn?: boolean | undefined;
+            cooktopActiveBurners?: number[] | undefined;
+            cooktopKnobProgress?: number[] | undefined;
+            cooktopShowGrate?: boolean | undefined;
+            height?: number | undefined;
+        } | {
+            type: "cooktop-induction";
+            id: string;
+            cooktopLayout?: "induction-2zone" | "induction-4zone" | undefined;
+            cooktopBurnersOn?: boolean | undefined;
+            cooktopActiveBurners?: number[] | undefined;
+            cooktopKnobProgress?: number[] | undefined;
+            cooktopShowGrate?: boolean | undefined;
+            height?: number | undefined;
+        } | {
+            type: "pull-out-pantry";
+            id: string;
+            shelfCount?: number | undefined;
+            pantryRackStyle?: "glass" | "wire" | "tray" | undefined;
+            height?: number | undefined;
+        } | {
+            type: "fridge-single";
+            id: string;
+            height?: number | undefined;
+        } | {
+            type: "fridge-double";
+            id: string;
+            height?: number | undefined;
+        } | {
+            type: "fridge-top-freezer";
+            id: string;
+            height?: number | undefined;
+        } | {
+            type: "fridge-bottom-freezer";
+            id: string;
+            height?: number | undefined;
+        } | {
+            type: "hood-pyramid";
+            id: string;
+            height?: number | undefined;
+        } | {
+            type: "hood-curved-glass";
+            id: string;
+            height?: number | undefined;
+        })[] | undefined;
+        openSide?: "left" | "right" | undefined;
+        cornerShelf?: boolean | undefined;
+    } | {
+        object: "node";
+        position: [number, number, number];
+        id: `item_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        scale: [number, number, number];
+        rotation: [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;
+            } | 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;
+                    };
+                    mode?: "ambient" | "open-close" | undefined;
+                    control?: number | undefined;
+                } | {
+                    kind: "light";
+                    color: string;
+                    intensityRange: [number, number];
+                    offset: [number, number, number];
+                    distance?: number | undefined;
+                })[];
+            } | undefined;
+        };
+        type: "item";
+        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;
+        side?: "front" | "back" | undefined;
+        supportSlabId?: string | undefined;
+        slots?: Record<string, string> | undefined;
+        roofSegmentId?: string | undefined;
+        source?: {
+            kind: "script";
+            language: "three" | "bpy";
+            script: string;
+            params: Record<string, string | number | boolean>;
+            artifact: string;
+            manifest: {
+                bounds: {
+                    min: [number, number, number];
+                    max: [number, number, number];
+                };
+                params: {
+                    id: string;
+                    kind: "string" | "number" | "boolean";
+                    default: string | number | boolean;
+                    label?: string | undefined;
+                    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: {
+                    y: number;
+                    polygon: [number, number][];
+                    part?: string | undefined;
+                }[];
+                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: {
+                    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";
+                    polygon: number[][];
+                    minY: number;
+                    maxY: 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;
+        wallId?: string | undefined;
+        wallT?: number | undefined;
+        roofFace?: "left" | "right" | "front" | "back" | undefined;
+        blockFaceId?: string | undefined;
+        collectionIds?: `collection_${string}`[] | undefined;
+    } | {
+        object: "node";
+        position: [number, number, number];
+        id: `procedural-item_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        rotation: [number, number, number];
+        children: string[];
+        slots: Record<string, string>;
+        parameters: Record<string, number>;
+        recipe: {
+            version: 2 | 1;
+            name: string;
+            description: string;
+            parameters: {
+                id: string;
+                label: string;
+                default: number;
+                min: number;
+                max: number;
+                step: number;
+                unit: "count" | "m" | "rad" | "s" | "bool" | "choice";
+                options?: string[] | undefined;
+                part?: string | undefined;
+                axis?: "x" | "z" | "y" | undefined;
+            }[];
+            slots: {
+                id: string;
+                label: string;
+                color: string;
+                finish?: "wood" | "glass" | "metal" | undefined;
+            }[];
+            parts: {
+                id: string;
+                label: string;
+                count: import("../../procedural-items/index.js").Expr;
+                shapes: ({
+                    id: string;
+                    primitive: "box" | "roundedBox" | "cylinder" | "ellipsoid";
+                    slot: string;
+                    size: [import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr];
+                    position: [import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr];
+                    support?: boolean | undefined;
+                    when?: import("../../procedural-items/index.js").Expr | undefined;
+                    rotation?: [import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr] | undefined;
+                    radius?: import("../../procedural-items/index.js").Expr | undefined;
+                    topScale?: import("../../procedural-items/index.js").Expr | undefined;
+                    segments?: number | undefined;
+                    open?: boolean | undefined;
+                    inner?: import("../../procedural-items/index.js").Expr | undefined;
+                    arc?: import("../../procedural-items/index.js").Expr | undefined;
+                } | {
+                    id: string;
+                    primitive: "extrude";
+                    slot: string;
+                    section: {
+                        kind: "rectangle";
+                        width: import("../../procedural-items/index.js").Expr;
+                        depth: import("../../procedural-items/index.js").Expr;
+                        corner?: import("../../procedural-items/index.js").Expr | undefined;
+                    } | {
+                        kind: "round";
+                        radius: import("../../procedural-items/index.js").Expr;
+                        wall?: import("../../procedural-items/index.js").Expr | undefined;
+                    } | {
+                        kind: "oval";
+                        width: import("../../procedural-items/index.js").Expr;
+                        depth: import("../../procedural-items/index.js").Expr;
+                    } | {
+                        kind: "section";
+                        family: "C" | "I" | "L" | "T" | "Z" | "rect-tube";
+                        width: import("../../procedural-items/index.js").Expr;
+                        depth: import("../../procedural-items/index.js").Expr;
+                        web: import("../../procedural-items/index.js").Expr;
+                        flange: import("../../procedural-items/index.js").Expr;
+                    } | {
+                        kind: "polygon";
+                        outer: [import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr][];
+                        holes?: [import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr][][] | undefined;
+                    };
+                    length: import("../../procedural-items/index.js").Expr;
+                    position: [import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr];
+                    support?: boolean | undefined;
+                    when?: import("../../procedural-items/index.js").Expr | undefined;
+                    bevel?: import("../../procedural-items/index.js").Expr | undefined;
+                    rotation?: [import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr] | undefined;
+                } | {
+                    id: string;
+                    primitive: "revolve";
+                    slot: string;
+                    profile: [import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr][];
+                    position: [import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr];
+                    support?: boolean | undefined;
+                    when?: import("../../procedural-items/index.js").Expr | undefined;
+                    segments?: number | undefined;
+                    arc?: import("../../procedural-items/index.js").Expr | undefined;
+                    rotation?: [import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr] | undefined;
+                })[];
+                parent?: string | undefined;
+                frame?: {
+                    position: [import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr];
+                    rotation?: [import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr] | undefined;
+                } | undefined;
+                when?: import("../../procedural-items/index.js").Expr | undefined;
+                motion?: {
+                    kind: "hinge";
+                    pivot: [import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr];
+                    axis: "x" | "z" | "y";
+                    angle: import("../../procedural-items/index.js").Expr;
+                    delay?: import("../../procedural-items/index.js").Expr | undefined;
+                    duration?: import("../../procedural-items/index.js").Expr | undefined;
+                    easing?: "linear" | "smooth" | "soft" | undefined;
+                } | {
+                    kind: "slide";
+                    axis: "x" | "z" | "y";
+                    distance: import("../../procedural-items/index.js").Expr;
+                    delay?: import("../../procedural-items/index.js").Expr | undefined;
+                    duration?: import("../../procedural-items/index.js").Expr | undefined;
+                    easing?: "linear" | "smooth" | "soft" | undefined;
+                } | {
+                    kind: "spin";
+                    pivot: [import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr];
+                    axis: "x" | "z" | "y";
+                    radiansPerSecond: import("../../procedural-items/index.js").Expr;
+                } | undefined;
+                light?: {
+                    position: [import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr];
+                    color: string;
+                    intensity?: number | undefined;
+                    distance?: number | undefined;
+                    emissiveSlot?: string | undefined;
+                } | undefined;
+            }[];
+            constraints: {
+                left: import("../../procedural-items/index.js").Expr;
+                relation: "lte" | "gte";
+                right: import("../../procedural-items/index.js").Expr;
+                message: string;
+            }[];
+            classification?: {
+                category: string;
+                functionTags: string[];
+                tags: string[];
+            } | undefined;
+            mounting?: {
+                attachTo: "ceiling" | "wall-side";
+                reference: string;
+            } | undefined;
+            base?: import("../../procedural-items/index.js").Expr | undefined;
+            cuts?: ({
+                shape: "rect";
+                size: [import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr];
+                center?: [import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr] | undefined;
+            } | {
+                shape: "circle";
+                diameter: import("../../procedural-items/index.js").Expr;
+                center?: [import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr] | undefined;
+            })[] | undefined;
+            surfaces?: {
+                id: string;
+                label: string;
+                position: [import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr];
+                size: [import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr];
+                part?: string | undefined;
+                rotation?: [import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr] | undefined;
+            }[] | undefined;
+            joints?: {
+                child: string;
+                kind: "fixed" | "continuous" | "revolute" | "prismatic";
+                origin: [import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr];
+                axis: [import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr];
+                delay?: import("../../procedural-items/index.js").Expr | undefined;
+                duration?: import("../../procedural-items/index.js").Expr | undefined;
+                easing?: "linear" | "smooth" | "soft" | undefined;
+                open?: import("../../procedural-items/index.js").Expr | undefined;
+                rest?: import("../../procedural-items/index.js").Expr | undefined;
+                range?: [import("../../procedural-items/index.js").Expr, import("../../procedural-items/index.js").Expr] | undefined;
+                speed?: import("../../procedural-items/index.js").Expr | undefined;
+            }[] | undefined;
+        };
+        attachments: Record<string, string>;
+        type: "procedural-item";
+        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;
+        side?: "front" | "back" | undefined;
+        supportSlabId?: string | undefined;
+        wallId?: string | undefined;
+    } | {
+        object: "node";
+        position: [number, number, number];
+        id: `imesh_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        rotation: [number, number, number];
+        primitives: {
+            positions: number[];
+            indices: number[];
+            color: string;
+            opacity: number;
+            normals?: number[] | undefined;
+        }[];
+        type: "imported-mesh";
+        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;
+    } | {
+        object: "node";
+        holes: [number, number][][];
+        id: `zone_${string}`;
+        name: string;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        polygon: [number, number][];
+        color: string;
+        autoFromWalls: boolean;
+        boundaryWallIds: `wall_${string}`[];
+        boundarySeparatorIds: string[];
+        spaceRole: "room" | "generic";
+        roomNumber: string;
+        enclosureStatus: "auto" | "open" | "enclosed";
+        floorFinish: string;
+        wallFinish: string;
+        ceilingFinish: string;
+        ceilingHeight: number;
+        occupancy: string;
+        clearDimensionPolicy: "none" | "inside-faces" | "finish-faces";
+        type: "zone";
+        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;
+        ceiling?: {
+            regions?: {
+                id: string;
+                polygon: [number, number][];
+                finish: string | Record<string, unknown>;
+            }[] | undefined;
+        } | undefined;
+        floor?: {
+            elevation?: number | undefined;
+            support?: "open" | undefined;
+            footprint?: string | undefined;
+            thickness?: number | undefined;
+            sourceSlabId?: `slab_${string}` | undefined;
+            finish?: string | Record<string, unknown> | undefined;
+            regions?: {
+                id: string;
+                polygon: [number, number][];
+                finish: string | Record<string, unknown>;
+            }[] | undefined;
+        } | undefined;
+        wallMaterial?: string | undefined;
+        hostZoneId?: string | undefined;
+        seed?: [number, number] | undefined;
+        floorStepFinish?: string | undefined;
+        floorStepOverrides?: {
+            key: string;
+            finish: string;
+            step?: number | undefined;
+        }[] | undefined;
+        floorEdgeFinish?: string | undefined;
+        wallOverrides?: {
+            wallId: string;
+            face: "a" | "b";
+            finish: string;
+        }[] | undefined;
+        hasFloor?: false | undefined;
+        hasCeiling?: false | undefined;
+    } | {
+        object: "node";
+        holes: [number, number][][];
+        id: `slab_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        polygon: [number, number][];
+        recessed: boolean;
+        holeMetadata: {
+            source: "stair" | "elevator" | "manual" | "room" | "floor-opening";
+            openingId?: string | undefined;
+            stairId?: string | undefined;
+            elevatorId?: string | undefined;
+        }[];
+        autoFromWalls: boolean;
+        elevation: number;
+        thickness: number;
+        type: "slab";
+        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;
+        slots?: Record<string, string> | undefined;
+        material?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        materialPreset?: string | undefined;
+        boundary?: "auto" | undefined;
+        support?: "open" | undefined;
+        floorHeight?: number | undefined;
+        referenceFloorElevation?: number | undefined;
+        foundation?: {
+            type: "solid" | "none";
+            material?: string | {
+                id?: string | undefined;
+                preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+                properties?: {
+                    color: string;
+                    roughness: number;
+                    metalness: number;
+                    opacity: number;
+                    transparent: boolean;
+                    side: "front" | "back" | "double";
+                } | undefined;
+                texture?: {
+                    url: string;
+                    repeat?: [number, number] | undefined;
+                    scale?: number | undefined;
+                } | undefined;
+            } | undefined;
+        } | undefined;
+        recessedRimElevation?: number | undefined;
+        fillToTerrain?: boolean | undefined;
+        plateRole?: "base" | "platform" | "sunken" | undefined;
+        railing?: {
+            start: [number, number];
+            end: [number, number];
+        }[] | undefined;
+        zoneIds?: string[] | undefined;
+        associatedZoneIds?: string[] | undefined;
+    } | {
+        object: "node";
+        holes: [number, number][][];
+        id: `ceiling_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        polygon: [number, number][];
+        children: (`item_${string}` | `procedural-item_${string}`)[];
+        holeMetadata: {
+            source: "stair" | "elevator" | "manual" | "room" | "floor-opening";
+            openingId?: string | undefined;
+            stairId?: string | undefined;
+            elevatorId?: string | undefined;
+        }[];
+        autoFromWalls: boolean;
+        type: "ceiling";
+        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;
+        slots?: Record<string, string> | undefined;
+        material?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        materialPreset?: string | undefined;
+        height?: number | undefined;
+        openingIds?: string[] | undefined;
+        regions?: {
+            id: string;
+            polygon: [number, number][];
+            finish: string | Record<string, unknown>;
+        }[] | undefined;
+        boundary?: "auto" | undefined;
+        zoneId?: string | undefined;
+    } | {
+        object: "node";
+        position: [number, number, number];
+        id: `roof_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        rotation: number;
+        children: `rseg_${string}`[];
+        support: {
+            kind: "level";
+        } | {
+            kind: "walls";
+        } | {
+            kind: "roof";
+            roofSegmentId: `rseg_${string}`;
+            localPosition: [number, number];
+            curbHeight: number;
+        };
+        type: "roof";
+        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;
+        slots?: Record<string, string> | undefined;
+        material?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        materialPreset?: string | undefined;
+        topMaterial?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        topMaterialPreset?: string | undefined;
+        edgeMaterial?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        edgeMaterialPreset?: string | undefined;
+        wallMaterial?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        wallMaterialPreset?: string | undefined;
+        assembly?: {
+            layers: {
+                id: string;
+                role: "fill" | "shell" | "finish" | "lining" | "substrate" | "sheathing" | "membrane" | "underlay" | "insulation" | "air" | "furring" | "structure" | "deck" | "covering" | "glazing";
+                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: "fill" | "shell" | "finish" | "lining" | "substrate" | "sheathing" | "membrane" | "underlay" | "insulation" | "air" | "furring" | "structure" | "deck" | "covering" | "glazing";
+                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?: "front" | "exterior" | undefined;
+            presetId?: string | undefined;
+            cavityInsulation?: string | undefined;
+        } | undefined;
+    } | {
+        object: "node";
+        position: [number, number, number];
+        id: `rseg_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        depth: number;
+        rotation: number;
+        children: string[];
+        trim: {
+            left: number;
+            right: number;
+            front: number;
+            back: number;
+            frontLeft: number;
+            frontRight: number;
+            backLeft: number;
+            backRight: number;
+            frontLeftX: number;
+            frontLeftZ: number;
+            frontRightX: number;
+            frontRightZ: number;
+            backLeftX: number;
+            backLeftZ: number;
+            backRightX: number;
+            backRightZ: number;
+        };
+        width: number;
+        roofType: "flat" | "hip" | "gable" | "shed" | "gambrel" | "dutch" | "mansard" | "conical";
+        wallHeight: number;
+        pitch: number;
+        wallThickness: number;
+        deckThickness: number;
+        overhang: number;
+        shingleThickness: number;
+        managedByParent: boolean;
+        wallShell: "auto" | "omit" | "include";
+        shedInsetEndPanels: boolean;
+        gambrelLowerWidthRatio: number;
+        gambrelLowerHeightRatio: number;
+        mansardSteepWidthRatio: number;
+        mansardSteepHeightRatio: number;
+        dutchHipWidthRatio: number;
+        dutchHipHeightRatio: number;
+        dutchWaistLengthRatio: number;
+        dutchGabletRake: number;
+        dutchTopRakeThickness: number;
+        type: "roof-segment";
+        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;
+        material?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        materialPreset?: string | undefined;
+        topMaterial?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        topMaterialPreset?: string | undefined;
+        edgeMaterial?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        edgeMaterialPreset?: string | undefined;
+        wallMaterial?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        wallMaterialPreset?: string | undefined;
+        conicalStartAngle?: number | undefined;
+        conicalSweepAngle?: number | undefined;
+        conicalFullCircle?: boolean | undefined;
+        arc?: {
+            centerX: number;
+            centerZ: number;
+            radius: number;
+        } | undefined;
+        shedSideInfillSpan?: number | undefined;
+        shedSideInfillMinX?: number | undefined;
+        shedSideInfillMaxX?: number | undefined;
+        shedFootprintPieces?: [number, number][][] | undefined;
+        shedOpenEndSides?: ("left" | "right")[] | undefined;
+        shedJointFrame?: {
+            position: [number, number, number];
+            rotation: number;
+        } | undefined;
+        shedJointOwnerId?: string | undefined;
+        shedJointNeighborIds?: string[] | undefined;
+        shedJointScopeId?: string | undefined;
+        fascia?: boolean | undefined;
+        fasciaHighEdge?: boolean | undefined;
+    } | {
+        object: "node";
+        position: [number, number, number];
+        id: `shelf_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        depth: number;
+        rotation: [number, number, number];
+        children: string[];
+        width: number;
+        height: number;
+        style: "wall-shelf" | "bookshelf" | "open-rack" | "cubby";
+        rows: number;
+        columns: number;
+        thickness: number;
+        withBack: boolean;
+        withSides: boolean;
+        withBottom: boolean;
+        bracketStyle: "hidden" | "minimal" | "industrial";
+        type: "shelf";
+        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;
+        supportSlabId?: string | undefined;
+        slots?: Record<string, string> | undefined;
+        material?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        materialPreset?: string | undefined;
+    } | {
+        object: "node";
+        position: [number, number, number];
+        id: `stair_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        rotation: number;
+        children: `sseg_${string}`[];
+        width: number;
+        fromLevelId: string | null;
+        toLevelId: string | null;
+        thickness: number;
+        stairType: "straight" | "spiral" | "curved";
+        slabOpeningMode: "none" | "destination";
+        openingOffset: number;
+        stepCount: number;
+        fillToFloor: boolean;
+        innerRadius: number;
+        sweepAngle: number;
+        topLandingMode: "none" | "integrated";
+        topLandingDepth: number;
+        showCenterColumn: boolean;
+        showStepSupports: boolean;
+        railingMode: "left" | "right" | "none" | "both";
+        railingHeight: number;
+        type: "stair";
+        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;
+        supportSlabId?: string | undefined;
+        slots?: Record<string, string> | undefined;
+        material?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        materialPreset?: string | undefined;
+        construction?: {
+            mode: "solid" | "open" | "waist" | "side-stringers" | "center-stringer";
+            waistThickness: number;
+            treadThickness: number;
+            riserThickness: number;
+            nosing: number;
+            finishThickness: number;
+            closedRisers: boolean;
+            stringerWidth: number;
+            stringerDepth: number;
+        } | undefined;
+        railingMaterial?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        railingMaterialPreset?: string | undefined;
+        treadMaterial?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        treadMaterialPreset?: string | undefined;
+        sideMaterial?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        sideMaterialPreset?: string | undefined;
+        deckSlabId?: string | undefined;
+        totalRise?: number | undefined;
+        designTargets?: {
+            maxRiserHeight: number;
+            minimumGoing: number;
+            targetGoing: number;
+            minimumHeadroom: number;
+        } | undefined;
+        uniformRisers?: boolean | undefined;
+        railingStyle?: "glass" | "metal" | "balusters" | "cable" | "boards" | "post-and-rail" | undefined;
+        railingPath?: "continuous" | "original" | undefined;
+        handrail?: {
+            mode: "left" | "right" | "none" | "both";
+            height: number;
+            diameter: number;
+            offset: number;
+            bottom?: {
+                extension: number;
+                return: "wall" | "floor" | "none" | "post";
+                returnLength: number;
+            } | undefined;
+            top?: {
+                extension: number;
+                return: "wall" | "floor" | "none" | "post";
+                returnLength: number;
+            } | undefined;
+        } | undefined;
+        railingTopPost?: boolean | undefined;
+        railingTopReach?: number | undefined;
+        railingPostThrough?: boolean | undefined;
+    } | {
+        object: "node";
+        length: number;
+        position: [number, number, number];
+        id: `sseg_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        rotation: number;
+        width: number;
+        height: number;
+        thickness: number;
+        stepCount: number;
+        fillToFloor: boolean;
+        segmentType: "stair" | "landing";
+        attachmentSide: "left" | "right" | "front";
+        type: "stair-segment";
+        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;
+        slots?: Record<string, string> | undefined;
+        material?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        materialPreset?: string | undefined;
+        construction?: {
+            mode: "solid" | "open" | "waist" | "side-stringers" | "center-stringer";
+            waistThickness: number;
+            treadThickness: number;
+            riserThickness: number;
+            nosing: number;
+            finishThickness: number;
+            closedRisers: boolean;
+            stringerWidth: number;
+            stringerDepth: number;
+        } | undefined;
+        winder?: {
+            turn: "left" | "right";
+            innerGap: number;
+            walkingLineOffset: number;
+            division: "equal-going" | "equal-angle";
+        } | undefined;
+    } | {
+        object: "node";
+        position: [number, number, number];
+        id: `scan_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        opacity: number;
+        url: string | null;
+        scale: number;
+        rotation: [number, number, number];
+        layers: Record<string, boolean>;
+        captureSession: {
+            sessionId: string;
+            schemaVersion?: number | undefined;
+            revisionId?: string | undefined;
+            manifestUrl?: string | undefined;
+        } | null;
+        type: "scan";
+        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;
+    } | {
+        object: "node";
+        position: [number, number, number];
+        id: `guide_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        opacity: number;
+        url: string;
+        scale: number;
+        rotation: [number, number, number];
+        scaleReference: {
+            start: [number, number];
+            end: [number, number];
+            realLengthMeters: number;
+            measuredLengthUnits: number;
+            metersPerUnit: number;
+            label: string;
+        } | null;
+        type: "guide";
+        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;
+    } | {
+        object: "node";
+        id: `measurement_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        measurement: {
+            kind: "distance";
+            points: [[number, number, number] | {
+                kind: "feature";
+                reference: {
+                    nodeId: string;
+                    featureId: string;
+                    parameters?: Record<string, string | number | boolean> | undefined;
+                };
+                fallback: [number, number, number];
+            }, [number, number, number] | {
+                kind: "feature";
+                reference: {
+                    nodeId: string;
+                    featureId: string;
+                    parameters?: Record<string, string | number | boolean> | undefined;
+                };
+                fallback: [number, number, number];
+            }];
+        } | {
+            kind: "angle";
+            points: [[number, number, number] | {
+                kind: "feature";
+                reference: {
+                    nodeId: string;
+                    featureId: string;
+                    parameters?: Record<string, string | number | boolean> | undefined;
+                };
+                fallback: [number, number, number];
+            }, [number, number, number] | {
+                kind: "feature";
+                reference: {
+                    nodeId: string;
+                    featureId: string;
+                    parameters?: Record<string, string | number | boolean> | undefined;
+                };
+                fallback: [number, number, number];
+            }, [number, number, number] | {
+                kind: "feature";
+                reference: {
+                    nodeId: string;
+                    featureId: string;
+                    parameters?: Record<string, string | number | boolean> | undefined;
+                };
+                fallback: [number, number, number];
+            }];
+        } | {
+            kind: "area";
+            base: ([number, number, number] | {
+                kind: "feature";
+                reference: {
+                    nodeId: string;
+                    featureId: string;
+                    parameters?: Record<string, string | number | boolean> | undefined;
+                };
+                fallback: [number, number, number];
+            })[];
+        } | {
+            kind: "perimeter";
+            base: ([number, number, number] | {
+                kind: "feature";
+                reference: {
+                    nodeId: string;
+                    featureId: string;
+                    parameters?: Record<string, string | number | boolean> | undefined;
+                };
+                fallback: [number, number, number];
+            })[];
+        } | {
+            kind: "volume";
+            base: ([number, number, number] | {
+                kind: "feature";
+                reference: {
+                    nodeId: string;
+                    featureId: string;
+                    parameters?: Record<string, string | number | boolean> | undefined;
+                };
+                fallback: [number, number, number];
+            })[];
+            extrusion: [number, number, number];
+        };
+        type: "measurement";
+        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;
+    } | {
+        object: "node";
+        position: [number, number, number];
+        id: `spawn_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        rotation: number;
+        type: "spawn";
+        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;
+        supportSlabId?: string | undefined;
+    } | {
+        object: "node";
+        position: [number, number, number];
+        id: `window_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        rotation: [number, number, number];
+        width: number;
+        height: number;
+        floorThresholdVersion: 0 | 1;
+        constructionType: "masonry" | "framed";
+        dimensionReference: "nominal" | "rough-opening" | "masonry-opening" | "finish-opening";
+        operationState: number;
+        openingKind: "window" | "opening";
+        openingShape: "rectangle" | "rounded" | "arch";
+        openingRadiusMode: "all" | "individual";
+        cornerRadius: number;
+        archHeight: number;
+        openingRevealRadius: number;
+        frameThickness: number;
+        frameDepth: number;
+        hingesSide: "left" | "right";
+        columnRatios: number[];
+        windowType: "fixed" | "sliding" | "casement" | "awning" | "hopper" | "single-hung" | "double-hung" | "bay" | "bow" | "louvered";
+        awningDirection: "up" | "down";
+        casementStyle: "french" | "single";
+        openingCornerRadii: [number, number, number, number];
+        rowRatios: number[];
+        columnDividerThickness: number;
+        rowDividerThickness: number;
+        sill: boolean;
+        sillDepth: number;
+        sillThickness: number;
+        type: "window";
+        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;
+        side?: "front" | "back" | undefined;
+        slots?: Record<string, string> | undefined;
+        material?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        roofSegmentId?: string | undefined;
+        source?: {
+            kind: "script";
+            language: "three" | "bpy";
+            script: string;
+            params: Record<string, string | number | boolean>;
+            artifact: string;
+            manifest: {
+                bounds: {
+                    min: [number, number, number];
+                    max: [number, number, number];
+                };
+                params: {
+                    id: string;
+                    kind: "string" | "number" | "boolean";
+                    default: string | number | boolean;
+                    label?: string | undefined;
+                    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: {
+                    y: number;
+                    polygon: [number, number][];
+                    part?: string | undefined;
+                }[];
+                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: {
+                    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";
+                    polygon: number[][];
+                    minY: number;
+                    maxY: 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;
+        wallId?: string | undefined;
+        roofFace?: "left" | "right" | "front" | "back" | undefined;
+        verticalAnchor?: "wall" | "floor" | undefined;
+        mark?: string | undefined;
+        roughOpeningWidth?: number | undefined;
+        roughOpeningHeight?: number | undefined;
+        masonryOpeningWidth?: number | undefined;
+        masonryOpeningHeight?: number | undefined;
+        finishOpeningWidth?: number | undefined;
+        finishOpeningHeight?: number | undefined;
+        dormerId?: string | undefined;
+        dormerFace?: "left" | "right" | "front" | "back" | undefined;
+    } | {
+        object: "node";
+        position: [number, number, number];
+        id: `door_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        rotation: [number, number, number];
+        width: number;
+        height: number;
+        leafCount: 2 | 1 | 3 | 4;
+        floorThresholdVersion: 0 | 1;
+        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";
+        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;
+        type: "door";
+        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;
+        side?: "front" | "back" | undefined;
+        slots?: Record<string, string> | undefined;
+        material?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        roofSegmentId?: string | undefined;
+        source?: {
+            kind: "script";
+            language: "three" | "bpy";
+            script: string;
+            params: Record<string, string | number | boolean>;
+            artifact: string;
+            manifest: {
+                bounds: {
+                    min: [number, number, number];
+                    max: [number, number, number];
+                };
+                params: {
+                    id: string;
+                    kind: "string" | "number" | "boolean";
+                    default: string | number | boolean;
+                    label?: string | undefined;
+                    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: {
+                    y: number;
+                    polygon: [number, number][];
+                    part?: string | undefined;
+                }[];
+                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: {
+                    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";
+                    polygon: number[][];
+                    minY: number;
+                    maxY: 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;
+        wallId?: string | undefined;
+        roofFace?: "left" | "right" | "front" | "back" | undefined;
+        verticalAnchor?: "wall" | "floor" | undefined;
+        mark?: string | undefined;
+        roughOpeningWidth?: number | undefined;
+        roughOpeningHeight?: number | undefined;
+        masonryOpeningWidth?: number | undefined;
+        masonryOpeningHeight?: number | undefined;
+        finishOpeningWidth?: number | undefined;
+        finishOpeningHeight?: number | undefined;
+    } | {
+        object: "node";
+        position: [number, number, number];
+        id: `bvent_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        depth: number;
+        rotation: number;
+        materialPreset: string;
+        width: number;
+        height: number;
+        hoodOverhang: number;
+        topTaper: number;
+        capHeight: number;
+        capGap: number;
+        domeCurvature: number;
+        baseInset: number;
+        baseHeight: number;
+        cornerBevel: number;
+        style: "box" | "cap" | "dome";
+        type: "box-vent";
+        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;
+        slots?: Record<string, string> | undefined;
+        material?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        roofSegmentId?: string | undefined;
+    } | {
+        object: "node";
+        length: number;
+        position: [number, number, number];
+        id: `rvent_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        rotation: number;
+        width: number;
+        height: number;
+        style: "metal" | "standard" | "shingled";
+        endCaps: boolean;
+        type: "ridge-vent";
+        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;
+        material?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        materialPreset?: string | undefined;
+        roofSegmentId?: string | undefined;
+    } | {
+        object: "node";
+        position: [number, number, number];
+        id: `tvent_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        rotation: number;
+        materialPreset: string;
+        height: number;
+        style: "cylinder" | "globe";
+        diameter: number;
+        neckHeight: number;
+        baseOverhang: number;
+        vaneCount: number;
+        spinSpeed: number;
+        type: "turbine-vent";
+        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;
+        slots?: Record<string, string> | undefined;
+        material?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        roofSegmentId?: string | undefined;
+    } | {
+        object: "node";
+        position: [number, number, number];
+        id: `cupola_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        depth: number;
+        rotation: number;
+        materialPreset: string;
+        width: number;
+        height: number;
+        roofStyle: "dome" | "pyramid";
+        finial: boolean;
+        type: "cupola";
+        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;
+        slots?: Record<string, string> | undefined;
+        material?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        roofSegmentId?: string | undefined;
+    } | {
+        object: "node";
+        position: [number, number, number];
+        id: `eyebrow-vent_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        depth: number;
+        rotation: number;
+        materialPreset: string;
+        width: number;
+        height: number;
+        style: "half-round" | "scoop" | "slant-box";
+        louverCount: number;
+        backRatio: number;
+        type: "eyebrow-vent";
+        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;
+        slots?: Record<string, string> | undefined;
+        material?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        roofSegmentId?: string | undefined;
+    } | {
+        object: "node";
+        length: number;
+        position: [number, number, number];
+        id: `gutter_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        rotation: number;
+        materialPreset: string;
+        thickness: number;
+        profile: "box" | "k-style" | "half-round";
+        size: number;
+        hangerStyle: "none" | "strap";
+        hangerSpacing: number;
+        endCapLeft: boolean;
+        endCapRight: boolean;
+        outlets: {
+            id: string;
+            offset: number;
+            diameter: number;
+            generatedBy?: "default-downspout" | undefined;
+        }[];
+        type: "gutter";
+        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;
+        slots?: Record<string, string> | undefined;
+        material?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        roofSegmentId?: string | undefined;
+        arc?: {
+            centerX: number;
+            centerZ: number;
+            radius: number;
+        } | undefined;
+    } | {
+        object: "node";
+        position: [number, number, number];
+        id: `chimney_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        depth: number;
+        rotation: number;
+        width: number;
+        cornerBevel: number;
+        cap: boolean;
+        panelDepth: number;
+        panelHeight: number;
+        bodyShape: "round" | "square";
+        bodyHollowDepth: number;
+        bodyHollowMargin: number;
+        heightAboveRidge: number;
+        cutoutOffset: number;
+        capShape: "flat" | "none" | "stepped" | "sloped";
+        capOverhang: number;
+        capThickness: number;
+        flueCount: number;
+        flueShape: "round" | "square";
+        flueHeight: number;
+        flueDiameter: number;
+        flueSpacing: number;
+        flueWallThickness: number;
+        shoulderStyle: "tapered" | "none" | "corbeled";
+        shoulderHeight: number;
+        shoulderExtent: number;
+        bandStyle: "double" | "none" | "single";
+        bandHeight: number;
+        bandExtent: number;
+        bandOffset: number;
+        cricketStyle: "none" | "simple";
+        cricketLength: number;
+        cricketHeight: number;
+        cricketSide: "front" | "back";
+        panelStyle: "rectangular" | "none";
+        panelOffsetTop: number;
+        panelMargin: number;
+        type: "chimney";
+        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;
+        material?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        materialPreset?: string | undefined;
+        roofSegmentId?: string | undefined;
+        topMaterial?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        topMaterialPreset?: string | undefined;
+    } | {
+        object: "node";
+        position: [number, number, number];
+        id: `solarpanel_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        rotation: number;
+        rows: number;
+        columns: number;
+        frameThickness: number;
+        frameDepth: number;
+        panelWidth: number;
+        panelHeight: number;
+        gapX: number;
+        gapY: number;
+        mountingType: "flush" | "tilted";
+        tiltAngle: number;
+        standoffHeight: number;
+        type: "solar-panel";
+        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;
+        material?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        materialPreset?: string | undefined;
+        roofSegmentId?: string | undefined;
+        panelMaterial?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        panelMaterialPreset?: string | undefined;
+        panelTypePreset?: "residential" | "residential-large" | "compact" | "frameless" | undefined;
+        surfaceNormal?: [number, number, number] | undefined;
+    } | {
+        object: "node";
+        position: [number, number, number];
+        id: `skylight_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        rotation: number;
+        width: number;
+        height: number;
+        glassThickness: number;
+        operationState: number;
+        slideDirection: "x" | "z";
+        frameThickness: number;
+        frameDepth: number;
+        curbHeight: number;
+        cutoutOffset: number;
+        skylightType: "flat" | "sliding" | "opening" | "walk-on" | "lantern";
+        lanternHeight: number;
+        lanternTopScale: number;
+        openingAngle: number;
+        openingSide: "left" | "right" | "top" | "bottom";
+        motorHousing: boolean;
+        slideFraction: number;
+        trackWidth: number;
+        motorHousingSize: number;
+        curb: boolean;
+        type: "skylight";
+        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;
+        material?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        materialPreset?: string | undefined;
+        roofSegmentId?: string | undefined;
+        surfaceNormal?: [number, number, number] | undefined;
+        glassMaterial?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        glassMaterialPreset?: string | undefined;
+    } | {
+        object: "node";
+        position: [number, number, number];
+        id: `dormer_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        depth: number;
+        rotation: number;
+        children: `window_${string}`[];
+        width: number;
+        height: number;
+        roofType: "flat" | "hip" | "gable" | "shed" | "gambrel" | "dutch" | "mansard" | "conical";
+        roofHeight: number;
+        shedHighSide: "front" | "back";
+        wallSkirtHeight: number;
+        windowWidth: number;
+        windowHeight: number;
+        windowOffsetX: number;
+        windowOffsetY: number;
+        windowFrameThickness: number;
+        windowFrameDepth: number;
+        windowColumns: number;
+        windowRows: number;
+        windowDividerThickness: number;
+        windowShape: "rectangle" | "rounded" | "arch";
+        windowArchHeight: number;
+        windowCornerRadii: [number, number, number, number];
+        windowSill: boolean;
+        windowSillDepth: number;
+        windowSillThickness: number;
+        type: "dormer";
+        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;
+        material?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        materialPreset?: string | undefined;
+        roofSegmentId?: string | undefined;
+        topMaterial?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        topMaterialPreset?: string | undefined;
+        wallMaterial?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        wallMaterialPreset?: string | undefined;
+        sideMaterial?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        sideMaterialPreset?: string | undefined;
+    } | {
+        object: "node";
+        length: number;
+        id: `downspout_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        shape: "auto" | "round" | "rect";
+        materialPreset: string;
+        diameter: number;
+        standoff: number;
+        strapStyle: "none" | "band";
+        strapSpacing: number;
+        terminal: "straight" | "splash" | "kickout";
+        type: "downspout";
+        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;
+        slots?: Record<string, string> | undefined;
+        material?: {
+            id?: string | undefined;
+            preset?: "custom" | "white" | "brick" | "concrete" | "wood" | "glass" | "metal" | "plaster" | "tile" | "marble" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "front" | "back" | "double";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        gutterId?: string | undefined;
+        outletId?: string | undefined;
+        lengthMode?: "manual" | "to-ground" | undefined;
+    } | {
+        object: "node";
+        id: `duct-segment_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        shape: "round" | "rect" | "oval";
+        path: [number, number, number][];
+        width: number;
+        height: number;
+        diameter: number;
+        roll: number;
+        ductMaterial: "spiral" | "sheet-metal" | "flex" | "duct-board";
+        seamDetail: boolean;
+        insulated: boolean;
+        insulationR: number;
+        system: "return" | "supply";
+        type: "duct-segment";
+        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;
+        slots?: Record<string, string> | undefined;
+        autoHangers?: boolean | undefined;
+        hangerOverrides?: Record<string, {
+            fraction?: number | undefined;
+            skipped?: boolean | undefined;
+            hostId?: string | undefined;
+        }> | undefined;
+        hangerStyle?: "double" | "single" | undefined;
+        hangerSpacing?: number | undefined;
+        hangerMaxReach?: number | undefined;
+        wallAttachment?: {
+            wallId: `wall_${string}`;
+            side: "front" | "back";
+            startUV: [number, number];
+            endUV: [number, number];
+            offset: number;
+        } | undefined;
+    } | {
+        object: "node";
+        position: [number, number, number];
+        id: `duct-fitting_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        shape: "round" | "rect" | "oval";
+        rotation: [number, number, number];
+        width: number;
+        height: number;
+        angle: number;
+        diameter: number;
+        ductMaterial: "sheet-metal" | "flex" | "duct-board";
+        system: "return" | "supply";
+        fittingType: "elbow" | "tee" | "cross" | "reducer" | "transition" | "end-cap" | "damper" | "access-panel" | "coupling";
+        shape2: "round" | "rect" | "oval";
+        width2: number;
+        height2: number;
+        branchAngle: number;
+        diameter2: number;
+        damperAngle: number;
+        panelWidth: number;
+        panelHeight: number;
+        type: "duct-fitting";
+        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;
+        slots?: Record<string, string> | undefined;
+        inletShape?: "round" | "rect" | "oval" | undefined;
+        outletShape?: "round" | "rect" | "oval" | undefined;
+    } | {
+        object: "node";
+        position: [number, number, number];
+        id: `duct-terminal_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        depth: number;
+        rotation: number;
+        width: number;
+        mount: "wall" | "ceiling" | "floor";
+        terminalType: "supply-register" | "diffuser" | "return-grille";
+        collarShape: "round" | "rect" | "oval";
+        collarDiameter: number;
+        collarWidth: number;
+        collarHeight: number;
+        type: "duct-terminal";
+        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;
+        supportSlabId?: string | undefined;
+    } | {
+        object: "node";
+        position: [number, number, number];
+        id: `hvac-equipment_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        depth: number;
+        rotation: number;
+        width: number;
+        height: number;
+        equipmentType: "furnace" | "air-handler" | "condenser";
+        supplyShape: "round" | "rect" | "oval";
+        returnShape: "round" | "rect" | "oval";
+        supplyDiameter: number;
+        returnDiameter: number;
+        supplyWidth: number;
+        supplyHeight: number;
+        returnWidth: number;
+        returnHeight: number;
+        type: "hvac-equipment";
+        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;
+        supportSlabId?: string | undefined;
+    } | {
+        object: "node";
+        id: `lineset_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        path: [number, number, number][];
+        insulated: boolean;
+        suctionDiameter: number;
+        liquidDiameter: number;
+        type: "lineset";
+        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;
+    } | {
+        object: "node";
+        id: `liquid-line_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        path: [number, number, number][];
+        diameter: number;
+        type: "liquid-line";
+        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;
+    } | {
+        object: "node";
+        id: `pipe-segment_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        path: [number, number, number][];
+        diameter: number;
+        system: "waste" | "vent";
+        pipeMaterial: "abs" | "pvc" | "cast-iron";
+        type: "pipe-segment";
+        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;
+        autoHangers?: boolean | undefined;
+        hangerOverrides?: Record<string, {
+            fraction?: number | undefined;
+            skipped?: boolean | undefined;
+            hostId?: string | undefined;
+        }> | undefined;
+        hangerStyle?: "double" | "single" | undefined;
+        hangerSpacing?: number | undefined;
+        hangerMaxReach?: number | undefined;
+        wallAttachment?: {
+            wallId: `wall_${string}`;
+            side: "front" | "back";
+            startUV: [number, number];
+            endUV: [number, number];
+            offset: number;
+        } | undefined;
+    } | {
+        object: "node";
+        position: [number, number, number];
+        id: `pipe-fitting_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        rotation: [number, number, number];
+        angle: number;
+        diameter: number;
+        system: "waste" | "vent";
+        fittingType: "elbow" | "cross" | "reducer" | "end-cap" | "coupling" | "wye" | "sanitary-tee" | "cleanout";
+        diameter2: number;
+        pipeMaterial: "abs" | "pvc" | "cast-iron";
+        cleanoutStyle: "end" | "inline";
+        type: "pipe-fitting";
+        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;
+    } | {
+        object: "node";
+        position: [number, number, number];
+        id: `pipe-trap_${string}`;
+        parentId: string | null;
+        visible: boolean;
+        metadata: Record<string, unknown>;
+        rotation: number;
+        diameter: number;
+        pipeMaterial: "abs" | "pvc" | "cast-iron";
+        armLengthM: number;
+        type: "pipe-trap";
+        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;
+    }>;
+    rootNodeIds: (`block_${string}` | `bvent_${string}` | `elevator_${string}` | `ceiling_${string}` | `item_${string}` | `procedural-item_${string}` | `column_${string}` | `construction-dimension_${string}` | `site_${string}` | `building_${string}` | `level_${string}` | `wall_${string}` | `door_${string}` | `window_${string}` | `leanto_${string}` | `roof_${string}` | `rseg_${string}` | `slab_${string}` | `separator_${string}` | `floor-opening_${string}` | `fence_${string}` | `structural-grid_${string}` | `imesh_${string}` | `zone_${string}` | `stair_${string}` | `sseg_${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}` | `unit_${string}` | `fence-gate_${string}` | `fence-opening_${string}` | `cabinet_${string}` | `cabinet-module_${string}` | `rvent_${string}` | `tvent_${string}` | `cupola_${string}` | `eyebrow-vent_${string}` | `gutter_${string}` | `chimney_${string}` | `solarpanel_${string}` | `skylight_${string}` | `dormer_${string}` | `downspout_${string}`)[];
+    collections: Record<`collection_${string}`, Collection>;
+    dirtyIds: (`block_${string}` | `bvent_${string}` | `elevator_${string}` | `ceiling_${string}` | `item_${string}` | `procedural-item_${string}` | `column_${string}` | `construction-dimension_${string}` | `site_${string}` | `building_${string}` | `level_${string}` | `wall_${string}` | `door_${string}` | `window_${string}` | `leanto_${string}` | `roof_${string}` | `rseg_${string}` | `slab_${string}` | `separator_${string}` | `floor-opening_${string}` | `fence_${string}` | `structural-grid_${string}` | `imesh_${string}` | `zone_${string}` | `stair_${string}` | `sseg_${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}` | `unit_${string}` | `fence-gate_${string}` | `fence-opening_${string}` | `cabinet_${string}` | `cabinet-module_${string}` | `rvent_${string}` | `tvent_${string}` | `cupola_${string}` | `eyebrow-vent_${string}` | `gutter_${string}` | `chimney_${string}` | `solarpanel_${string}` | `skylight_${string}` | `dormer_${string}` | `downspout_${string}`)[];
+};
+export declare const createNodesAction: (set: Parameters<typeof createNodesActionImpl>[0], get: Parameters<typeof createNodesActionImpl>[1], ops: NodeCreateOp[], options?: DerivedWriteOptions) => void;
+export declare const applyNodeChangesAction: (set: Parameters<typeof applyNodeChangesActionImpl>[0], get: Parameters<typeof applyNodeChangesActionImpl>[1], changes: Parameters<typeof applyNodeChangesActionImpl>[2], options?: DerivedWriteOptions) => void;
+export declare const updateNodesAction: (set: Parameters<typeof updateNodesActionImpl>[0], get: Parameters<typeof updateNodesActionImpl>[1], updates: Parameters<typeof updateNodesActionImpl>[2], options?: DerivedWriteOptions) => void;
+export declare const deleteNodesAction: (set: Parameters<typeof deleteNodesActionImpl>[0], get: Parameters<typeof deleteNodesActionImpl>[1], ids: AnyNodeId[], options?: DerivedWriteOptions) => void;
+/**
+ * The sanctioned conversion from derived construction to an authored surface:
+ * the boundary editors' polygon edit, a 2D reshape, a manual move. Clears the
+ * derived markers (and the zone link) in the same update that carries the
+ * caller's own change, so the reconciler stops owning the surface from this
+ * commit on.
+ */
+export declare const detachDerivedNodeAction: (set: Parameters<typeof updateNodesActionImpl>[0], get: Parameters<typeof updateNodesActionImpl>[1], id: AnyNodeId, data?: Partial<AnyNode>) => void;
+/**
+ * What the default gutter refresh of `roofIds` would touch, without running
+ * it: the existing default gutters and downspouts it may keep or replace, and
+ * the roof segments whose `children` it rewrites. For previews of edits that
+ * trigger the refresh (a roof segment update, a delete).
+ */
+export declare function previewDefaultGutterRefresh(nodes: Record<AnyNodeId, AnyNode>, roofIds: Iterable<AnyNodeId>): {
+    unsettledIds: Set<AnyNodeId>;
+    regeneratedHostIds: Set<AnyNodeId>;
+};
 export {};
 //# sourceMappingURL=node-actions.d.ts.map