@pascal-app/core 1.0.6 → 1.1.0

package/dist/spatial/usage-field/swings.d.ts

@@ -0,0 +1,847 @@
+import type { DoorNode } from '../../schema/index.js';
+import { type UsageIssue } from './findings.js';
+import type { LevelShapes, Prism, UsageShapes } from './types.js';
+import type { Nodes } from './walls.js';
+/** The leaf is swept in steps of this many degrees. */
+export declare const SWEEP_STEP_DEG = 3;
+/** A door that stops before this angle does not open fully: a leaf flat against a wall at 90 degrees reads a few degrees short, and one that opens to 80 leaves the way clear. */
+export declare const OPENS_FULLY_DEG = 80;
+/** A leaf that stops short of this angle is no way through: the finding is ranked with the blockers. */
+export declare const DOOR_STOPPED_BLOCKING_DEG = 30;
+/** The leaf is a little narrower than its opening: the frame takes this much (m). */
+export declare const FRAME_M = 0.04;
+export declare const FIXTURE: RegExp;
+export type Hung = {
+    swing: 1 | -1;
+    hs: 1 | -1;
+};
+type Point = [number, number];
+type Sweep = {
+    free: number;
+    by: {
+        prism: Prism;
+        name: string;
+        kind: 'wall' | 'cabinet' | 'fixture' | 'furniture' | 'door' | 'stair';
+    } | null;
+};
+/**
+ * Which way each door's leaf can be swept: a door swinging to a side of its wall, hinged at one jamb.
+ * The side and the hinge follow the floor plan's drawing (`hingesSide`, `swingDirection`, both flipped for a turned door).
+ */
+export declare function hungOf(door: DoorNode): Hung;
+/** The door fields that give `hung` on a door that is not turned: the inverse of `hungOf`. */
+export declare function hangingOf(hung: Hung): Pick<DoorNode, 'hingesSide' | 'swingDirection'>;
+/** The doors on a level whose leaf swings: not sliding, garage, pocket or open doorways. */
+export declare function swingDoors(nodes: Nodes, levelId: string): DoorNode[];
+/** A door in its wall's frame: the wall's origin, unit tangent and normal, half the opening and where it is along the wall. */
+export declare function doorFrame(nodes: Nodes, door: DoorNode): {
+    wall: {
+        object: "node";
+        name?: string | undefined;
+        parentId: string | null;
+        visible: boolean;
+        camera?: {
+            position: [number, number, number];
+            target: [number, number, number];
+            mode: "orthographic" | "perspective";
+            fov?: number | undefined;
+            zoom?: number | undefined;
+        } | undefined;
+        metadata: Record<string, unknown>;
+        provenance?: {
+            refs: {
+                ns?: string | undefined;
+                id: string;
+                role?: "absorbed" | "alias" | "derived" | "piece" | "primary" | undefined;
+            }[];
+            lineage?: {
+                op: "attach" | "convert" | "duplicate" | "import" | "make-independent" | "merge" | "promote" | "split";
+                fromIds: string[];
+            } | undefined;
+        } | undefined;
+        id: `wall_${string}`;
+        type: "wall";
+        wallType?: "curtain" | "railing" | "standard" | undefined;
+        curtainWall?: {
+            construction: "stick" | "unitized";
+            framing: "capped" | "horizontal-caps" | "structural-glazing" | "vertical-caps";
+            columns: {
+                layout: "count" | "fixed-spacing" | "maximum-spacing";
+                count: number;
+                spacing: number;
+                alignment: "center" | "end" | "start";
+            };
+            rows: {
+                layout: "count" | "fixed-spacing" | "maximum-spacing";
+                count: number;
+                spacing: number;
+                alignment: "center" | "end" | "start";
+            };
+            mullionWidth: number;
+            transomWidth: number;
+            perimeterWidth: number;
+            jointWidth: number;
+            glassThickness: number;
+            panelType: "empty" | "glass" | "solid";
+            spandrel: "bottom" | "none" | "top";
+            frameColor: string;
+            glassColor: string;
+            solidColor: string;
+            glassOpacity: number;
+            glassRoughness: number;
+            panels: {
+                column: number;
+                row: number;
+                type: "empty" | "glass" | "solid";
+            }[];
+        } | undefined;
+        railing?: {
+            style: "balusters" | "boards" | "cable" | "glass" | "metal" | "post-and-rail";
+            postSpacing: number;
+            postSize: number;
+            infillSize: number;
+            infillGap: number;
+            bottomClearance: number;
+            cap: boolean;
+        } | undefined;
+        children: (`door_${string}` | `item_${string}` | `leanto_${string}` | `procedural-item_${string}` | `window_${string}`)[];
+        material?: {
+            id?: string | undefined;
+            preset?: "brick" | "concrete" | "custom" | "glass" | "marble" | "metal" | "plaster" | "tile" | "white" | "wood" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "back" | "double" | "front";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+                offset?: [number, number] | undefined;
+                normalMap?: string | undefined;
+                normalScale?: number | undefined;
+                bumpMap?: string | undefined;
+                bumpScale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        materialPreset?: string | undefined;
+        interiorMaterial?: {
+            id?: string | undefined;
+            preset?: "brick" | "concrete" | "custom" | "glass" | "marble" | "metal" | "plaster" | "tile" | "white" | "wood" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "back" | "double" | "front";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+                offset?: [number, number] | undefined;
+                normalMap?: string | undefined;
+                normalScale?: number | undefined;
+                bumpMap?: string | undefined;
+                bumpScale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        interiorMaterialPreset?: string | undefined;
+        exteriorMaterial?: {
+            id?: string | undefined;
+            preset?: "brick" | "concrete" | "custom" | "glass" | "marble" | "metal" | "plaster" | "tile" | "white" | "wood" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "back" | "double" | "front";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+                offset?: [number, number] | undefined;
+                normalMap?: string | undefined;
+                normalScale?: number | undefined;
+                bumpMap?: string | undefined;
+                bumpScale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        exteriorMaterialPreset?: string | undefined;
+        slots?: Record<string, string> | undefined;
+        legacyFaceMaterials?: {
+            a?: {
+                material?: {
+                    id?: string | undefined;
+                    preset?: "brick" | "concrete" | "custom" | "glass" | "marble" | "metal" | "plaster" | "tile" | "white" | "wood" | undefined;
+                    properties?: {
+                        color: string;
+                        roughness: number;
+                        metalness: number;
+                        opacity: number;
+                        transparent: boolean;
+                        side: "back" | "double" | "front";
+                    } | undefined;
+                    texture?: {
+                        url: string;
+                        repeat?: [number, number] | undefined;
+                        scale?: number | undefined;
+                        offset?: [number, number] | undefined;
+                        normalMap?: string | undefined;
+                        normalScale?: number | undefined;
+                        bumpMap?: string | undefined;
+                        bumpScale?: number | undefined;
+                    } | undefined;
+                } | undefined;
+                materialPreset?: string | undefined;
+            } | undefined;
+            b?: {
+                material?: {
+                    id?: string | undefined;
+                    preset?: "brick" | "concrete" | "custom" | "glass" | "marble" | "metal" | "plaster" | "tile" | "white" | "wood" | undefined;
+                    properties?: {
+                        color: string;
+                        roughness: number;
+                        metalness: number;
+                        opacity: number;
+                        transparent: boolean;
+                        side: "back" | "double" | "front";
+                    } | undefined;
+                    texture?: {
+                        url: string;
+                        repeat?: [number, number] | undefined;
+                        scale?: number | undefined;
+                        offset?: [number, number] | undefined;
+                        normalMap?: string | undefined;
+                        normalScale?: number | undefined;
+                        bumpMap?: string | undefined;
+                        bumpScale?: number | undefined;
+                    } | undefined;
+                } | undefined;
+                materialPreset?: string | undefined;
+            } | undefined;
+        } | undefined;
+        faceRegions?: {
+            id: string;
+            face: "a" | "b";
+            u0?: number | undefined;
+            u1?: number | undefined;
+            v0?: number | undefined;
+            v1?: number | undefined;
+            finish: string;
+        }[] | undefined;
+        thickness?: number | undefined;
+        assembly?: {
+            layers: {
+                id: string;
+                role: "air" | "covering" | "deck" | "fill" | "finish" | "furring" | "glazing" | "insulation" | "lining" | "membrane" | "sheathing" | "shell" | "structure" | "substrate" | "underlay";
+                thickness: number;
+                core?: true | undefined;
+                spacing?: number | undefined;
+                material?: string | undefined;
+                slot?: string | undefined;
+                returns?: boolean | undefined;
+                display?: "construction" | "finished" | undefined;
+                inset?: number | undefined;
+                bottom?: number | undefined;
+                lift?: number | undefined;
+                src?: string | undefined;
+            }[];
+            backing?: {
+                id: string;
+                role: "air" | "covering" | "deck" | "fill" | "finish" | "furring" | "glazing" | "insulation" | "lining" | "membrane" | "sheathing" | "shell" | "structure" | "substrate" | "underlay";
+                thickness: number;
+                core?: true | undefined;
+                spacing?: number | undefined;
+                material?: string | undefined;
+                slot?: string | undefined;
+                returns?: boolean | undefined;
+                display?: "construction" | "finished" | undefined;
+                inset?: number | undefined;
+                bottom?: number | undefined;
+                lift?: number | undefined;
+                src?: string | undefined;
+            }[] | undefined;
+            face?: "exterior" | "front" | undefined;
+            presetId?: string | undefined;
+            cavityInsulation?: string | undefined;
+        } | undefined;
+        justification?: "a" | "b" | undefined;
+        height?: number | undefined;
+        endHeightOffset?: number | undefined;
+        curveOffset?: number | undefined;
+        supportSlabId?: string | undefined;
+        supportOffset?: number | undefined;
+        fillToTerrain?: boolean | undefined;
+        cap?: boolean | undefined;
+        underpinning?: {
+            rim: number;
+            stem: number;
+            openings?: {
+                u: number;
+                width: number;
+                top: number;
+                bottom: number;
+            }[] | undefined;
+        } | undefined;
+        skirting?: {
+            enabled: boolean;
+            sides: "a" | "b" | "both" | "exterior" | "interior";
+            height: number;
+            proud: number;
+            profile: "base-colonial" | "base-modern" | "base-ogee" | "base-shoe" | "bevel" | "bullnose" | "cove" | "crown-cove" | "crown-craftsman" | "crown-layered" | "crown-ogee" | "flat" | "rail-ogee" | "rail-picture" | "rail-rounded" | "rail-stepped" | "triangle";
+            offsetY?: number | undefined;
+        } | undefined;
+        crown?: {
+            enabled: boolean;
+            sides: "a" | "b" | "both" | "exterior" | "interior";
+            height: number;
+            proud: number;
+            profile: "base-colonial" | "base-modern" | "base-ogee" | "base-shoe" | "bevel" | "bullnose" | "cove" | "crown-cove" | "crown-craftsman" | "crown-layered" | "crown-ogee" | "flat" | "rail-ogee" | "rail-picture" | "rail-rounded" | "rail-stepped" | "triangle";
+            offsetY?: number | undefined;
+        } | undefined;
+        chairRail?: {
+            enabled: boolean;
+            sides: "a" | "b" | "both" | "exterior" | "interior";
+            height: number;
+            proud: number;
+            profile: "base-colonial" | "base-modern" | "base-ogee" | "base-shoe" | "bevel" | "bullnose" | "cove" | "crown-cove" | "crown-craftsman" | "crown-layered" | "crown-ogee" | "flat" | "rail-ogee" | "rail-picture" | "rail-rounded" | "rail-stepped" | "triangle";
+            offsetY?: number | undefined;
+        } | undefined;
+        finishScripts?: {
+            a?: {
+                kind: "script";
+                meta?: {
+                    description?: string | undefined;
+                    category?: string | undefined;
+                    tags?: string[] | undefined;
+                    parent?: string | undefined;
+                } | undefined;
+                language: "bpy" | "three";
+                script: string;
+                params: Record<string, string | number | boolean>;
+                artifact: string;
+                manifest: {
+                    bounds: {
+                        min: [number, number, number];
+                        max: [number, number, number];
+                    };
+                    params: {
+                        id: string;
+                        label?: string | undefined;
+                        kind: "boolean" | "number" | "string";
+                        default: string | number | boolean;
+                        min?: number | undefined;
+                        max?: number | undefined;
+                        step?: number | undefined;
+                        unit?: string | undefined;
+                        options?: string[] | undefined;
+                    }[];
+                    parts: {
+                        id: string;
+                        label?: string | undefined;
+                        type?: string | undefined;
+                        bounds?: {
+                            min: [number, number, number];
+                            max: [number, number, number];
+                        } | undefined;
+                    }[];
+                    surfaces: {
+                        part?: string | undefined;
+                        y: number;
+                        polygon: [number, number][];
+                    }[];
+                    slots: {
+                        id: string;
+                        label?: string | undefined;
+                        color?: string | undefined;
+                        roughness?: number | undefined;
+                        metalness?: number | undefined;
+                        transparent?: boolean | undefined;
+                        emissive?: boolean | undefined;
+                    }[];
+                    anchors: {
+                        id: string;
+                        position: [number, number, number];
+                        normal?: [number, number, number] | undefined;
+                    }[];
+                    lights: {
+                        id: string;
+                        position: [number, number, number];
+                        color: string;
+                        intensity: number;
+                        distance?: number | undefined;
+                        spot?: {
+                            direction: [number, number, number];
+                            angle: number;
+                            softness: number;
+                        } | undefined;
+                        shadows?: boolean | undefined;
+                        glow?: {
+                            size: number;
+                            strength: number;
+                        } | undefined;
+                    }[];
+                    undersides: {
+                        part?: string | undefined;
+                        polygon: [number, number][];
+                        plane: [number, number, number, number];
+                    }[];
+                    animations: {
+                        name: string;
+                        duration: number;
+                    }[];
+                    cutters?: {
+                        host: "ceiling" | "mounted" | "slab" | "wall";
+                        polygon: number[][];
+                        minY: number;
+                        maxY: number;
+                    }[] | undefined;
+                    cutout: boolean;
+                    collider: boolean;
+                    shape?: {
+                        tolerance: number;
+                        bands: {
+                            y0: number;
+                            y1: number;
+                            polygons: {
+                                outer: [number, number][];
+                                holes?: [number, number][][] | undefined;
+                            }[];
+                        }[];
+                    } | undefined;
+                    triangles: number;
+                    coverage?: number | undefined;
+                    uncovered?: {
+                        min: [number, number];
+                        max: [number, number];
+                    }[] | undefined;
+                };
+                images?: {
+                    artifact: string;
+                    thumbnail: string;
+                    floorPlan: string;
+                } | undefined;
+                inputs: string;
+                toHeight?: number | undefined;
+            } | undefined;
+            b?: {
+                kind: "script";
+                meta?: {
+                    description?: string | undefined;
+                    category?: string | undefined;
+                    tags?: string[] | undefined;
+                    parent?: string | undefined;
+                } | undefined;
+                language: "bpy" | "three";
+                script: string;
+                params: Record<string, string | number | boolean>;
+                artifact: string;
+                manifest: {
+                    bounds: {
+                        min: [number, number, number];
+                        max: [number, number, number];
+                    };
+                    params: {
+                        id: string;
+                        label?: string | undefined;
+                        kind: "boolean" | "number" | "string";
+                        default: string | number | boolean;
+                        min?: number | undefined;
+                        max?: number | undefined;
+                        step?: number | undefined;
+                        unit?: string | undefined;
+                        options?: string[] | undefined;
+                    }[];
+                    parts: {
+                        id: string;
+                        label?: string | undefined;
+                        type?: string | undefined;
+                        bounds?: {
+                            min: [number, number, number];
+                            max: [number, number, number];
+                        } | undefined;
+                    }[];
+                    surfaces: {
+                        part?: string | undefined;
+                        y: number;
+                        polygon: [number, number][];
+                    }[];
+                    slots: {
+                        id: string;
+                        label?: string | undefined;
+                        color?: string | undefined;
+                        roughness?: number | undefined;
+                        metalness?: number | undefined;
+                        transparent?: boolean | undefined;
+                        emissive?: boolean | undefined;
+                    }[];
+                    anchors: {
+                        id: string;
+                        position: [number, number, number];
+                        normal?: [number, number, number] | undefined;
+                    }[];
+                    lights: {
+                        id: string;
+                        position: [number, number, number];
+                        color: string;
+                        intensity: number;
+                        distance?: number | undefined;
+                        spot?: {
+                            direction: [number, number, number];
+                            angle: number;
+                            softness: number;
+                        } | undefined;
+                        shadows?: boolean | undefined;
+                        glow?: {
+                            size: number;
+                            strength: number;
+                        } | undefined;
+                    }[];
+                    undersides: {
+                        part?: string | undefined;
+                        polygon: [number, number][];
+                        plane: [number, number, number, number];
+                    }[];
+                    animations: {
+                        name: string;
+                        duration: number;
+                    }[];
+                    cutters?: {
+                        host: "ceiling" | "mounted" | "slab" | "wall";
+                        polygon: number[][];
+                        minY: number;
+                        maxY: number;
+                    }[] | undefined;
+                    cutout: boolean;
+                    collider: boolean;
+                    shape?: {
+                        tolerance: number;
+                        bands: {
+                            y0: number;
+                            y1: number;
+                            polygons: {
+                                outer: [number, number][];
+                                holes?: [number, number][][] | undefined;
+                            }[];
+                        }[];
+                    } | undefined;
+                    triangles: number;
+                    coverage?: number | undefined;
+                    uncovered?: {
+                        min: [number, number];
+                        max: [number, number];
+                    }[] | undefined;
+                };
+                images?: {
+                    artifact: string;
+                    thumbnail: string;
+                    floorPlan: string;
+                } | undefined;
+                inputs: string;
+                toHeight?: number | undefined;
+            } | undefined;
+        } | undefined;
+        start: [number, number];
+        end: [number, number];
+        frontSide: "exterior" | "interior" | "unknown";
+        backSide: "exterior" | "interior" | "unknown";
+    };
+    sx: number;
+    sz: number;
+    tx: number;
+    tz: number;
+    nx: number;
+    nz: number;
+    half: number;
+    along: number;
+};
+/** Where a door's leaf is hinged: at the jamb, on the face of the wall it swings to. */
+export declare function hingeOf(nodes: Nodes, door: DoorNode, hung: Hung): Point;
+/** The direction the leaf points at `theta` radians from closed. */
+export declare function leafDirection(f: ReturnType<typeof doorFrame>, hung: Hung, theta: number): Point;
+/**
+ * What reads how the doors of one level swing: a door's leaf swept against what stands round it (`sweepOf`), and the way
+ * into the room it opens into past the leaf open at an angle (`wayOf`).
+ */
+export declare function swingReader(nodes: Nodes, shapes: UsageShapes, level: LevelShapes): {
+    baseY: number;
+    doors: {
+        object: "node";
+        name?: string | undefined;
+        parentId: string | null;
+        visible: boolean;
+        camera?: {
+            position: [number, number, number];
+            target: [number, number, number];
+            mode: "orthographic" | "perspective";
+            fov?: number | undefined;
+            zoom?: number | undefined;
+        } | undefined;
+        metadata: Record<string, unknown>;
+        provenance?: {
+            refs: {
+                ns?: string | undefined;
+                id: string;
+                role?: "absorbed" | "alias" | "derived" | "piece" | "primary" | undefined;
+            }[];
+            lineage?: {
+                op: "attach" | "convert" | "duplicate" | "import" | "make-independent" | "merge" | "promote" | "split";
+                fromIds: string[];
+            } | undefined;
+        } | undefined;
+        id: `door_${string}`;
+        type: "door";
+        material?: {
+            id?: string | undefined;
+            preset?: "brick" | "concrete" | "custom" | "glass" | "marble" | "metal" | "plaster" | "tile" | "white" | "wood" | undefined;
+            properties?: {
+                color: string;
+                roughness: number;
+                metalness: number;
+                opacity: number;
+                transparent: boolean;
+                side: "back" | "double" | "front";
+            } | undefined;
+            texture?: {
+                url: string;
+                repeat?: [number, number] | undefined;
+                scale?: number | undefined;
+                offset?: [number, number] | undefined;
+                normalMap?: string | undefined;
+                normalScale?: number | undefined;
+                bumpMap?: string | undefined;
+                bumpScale?: number | undefined;
+            } | undefined;
+        } | undefined;
+        slots?: Record<string, string> | undefined;
+        source?: {
+            kind: "script";
+            meta?: {
+                description?: string | undefined;
+                category?: string | undefined;
+                tags?: string[] | undefined;
+                parent?: string | undefined;
+            } | undefined;
+            language: "bpy" | "three";
+            script: string;
+            params: Record<string, string | number | boolean>;
+            artifact: string;
+            manifest: {
+                bounds: {
+                    min: [number, number, number];
+                    max: [number, number, number];
+                };
+                params: {
+                    id: string;
+                    label?: string | undefined;
+                    kind: "boolean" | "number" | "string";
+                    default: string | number | boolean;
+                    min?: number | undefined;
+                    max?: number | undefined;
+                    step?: number | undefined;
+                    unit?: string | undefined;
+                    options?: string[] | undefined;
+                }[];
+                parts: {
+                    id: string;
+                    label?: string | undefined;
+                    type?: string | undefined;
+                    bounds?: {
+                        min: [number, number, number];
+                        max: [number, number, number];
+                    } | undefined;
+                }[];
+                surfaces: {
+                    part?: string | undefined;
+                    y: number;
+                    polygon: [number, number][];
+                }[];
+                slots: {
+                    id: string;
+                    label?: string | undefined;
+                    color?: string | undefined;
+                    roughness?: number | undefined;
+                    metalness?: number | undefined;
+                    transparent?: boolean | undefined;
+                    emissive?: boolean | undefined;
+                }[];
+                anchors: {
+                    id: string;
+                    position: [number, number, number];
+                    normal?: [number, number, number] | undefined;
+                }[];
+                lights: {
+                    id: string;
+                    position: [number, number, number];
+                    color: string;
+                    intensity: number;
+                    distance?: number | undefined;
+                    spot?: {
+                        direction: [number, number, number];
+                        angle: number;
+                        softness: number;
+                    } | undefined;
+                    shadows?: boolean | undefined;
+                    glow?: {
+                        size: number;
+                        strength: number;
+                    } | undefined;
+                }[];
+                undersides: {
+                    part?: string | undefined;
+                    polygon: [number, number][];
+                    plane: [number, number, number, number];
+                }[];
+                animations: {
+                    name: string;
+                    duration: number;
+                }[];
+                cutters?: {
+                    host: "ceiling" | "mounted" | "slab" | "wall";
+                    polygon: number[][];
+                    minY: number;
+                    maxY: number;
+                }[] | undefined;
+                cutout: boolean;
+                collider: boolean;
+                shape?: {
+                    tolerance: number;
+                    bands: {
+                        y0: number;
+                        y1: number;
+                        polygons: {
+                            outer: [number, number][];
+                            holes?: [number, number][][] | undefined;
+                        }[];
+                    }[];
+                } | undefined;
+                triangles: number;
+                coverage?: number | undefined;
+                uncovered?: {
+                    min: [number, number];
+                    max: [number, number];
+                }[] | undefined;
+            };
+            images?: {
+                artifact: string;
+                thumbnail: string;
+                floorPlan: string;
+            } | undefined;
+        } | undefined;
+        position: [number, number, number];
+        rotation: [number, number, number];
+        side?: "back" | "front" | undefined;
+        verticalAnchor?: "floor" | "wall" | undefined;
+        floorThresholdVersion: 0 | 1;
+        wallId?: string | undefined;
+        roofSegmentId?: string | undefined;
+        roofFace?: "back" | "front" | "left" | "right" | undefined;
+        width: number;
+        height: number;
+        sidelightLeft?: number | undefined;
+        sidelightRight?: number | undefined;
+        transomHeight?: number | undefined;
+        slidingStyle?: "bypass" | "patio" | undefined;
+        mark?: string | undefined;
+        constructionType: "framed" | "masonry";
+        dimensionReference: "finish-opening" | "masonry-opening" | "nominal" | "rough-opening";
+        roughOpeningWidth?: number | undefined;
+        roughOpeningHeight?: number | undefined;
+        masonryOpeningWidth?: number | undefined;
+        masonryOpeningHeight?: number | undefined;
+        finishOpeningWidth?: number | undefined;
+        finishOpeningHeight?: number | undefined;
+        doorCategory: "garage" | "interior";
+        doorType: "barn" | "double" | "folding" | "french" | "garage-rollup" | "garage-sectional" | "garage-tiltup" | "hinged" | "pocket" | "sliding";
+        leafCount: 1 | 2 | 3 | 4 | 6 | 8;
+        operationState: number;
+        slideDirection: "left" | "right";
+        trackStyle: "none" | "overhead" | "pocket" | "visible";
+        garagePanelCount: number;
+        openingKind: "door" | "opening";
+        openingShape: "arch" | "rectangle" | "rounded";
+        openingRadiusMode: "all" | "individual";
+        openingTopRadii: [number, number];
+        cornerRadius: number;
+        archHeight: number;
+        openingRevealRadius: number;
+        frameThickness: number;
+        frameDepth?: number | undefined;
+        threshold: boolean;
+        thresholdHeight: number;
+        casingFaceA?: boolean | undefined;
+        casingFaceB?: boolean | undefined;
+        casingWidth?: number | undefined;
+        hingesSide: "left" | "right";
+        swingDirection: "inward" | "outward";
+        swingAngle: number;
+        segments: {
+            type: "empty" | "glass" | "panel";
+            heightRatio: number;
+            columnRatios: number[];
+            dividerThickness: number;
+            panelDepth: number;
+            panelInset: number;
+        }[];
+        handle: boolean;
+        handleStyle?: "bar" | "knob" | "lever" | "lever-curved" | "plate" | undefined;
+        handleHeight: number;
+        handleSide: "left" | "right";
+        contentPadding: [number, number];
+        doorCloser: boolean;
+        panicBar: boolean;
+        panicBarStyle: "crossbar" | "touchbar";
+        panicBarRods: boolean;
+        panicBarHeight: number;
+    }[];
+    roomBeyond: (door: DoorNode, swing: 1 | -1) => {
+        id: string;
+        name: string;
+    } | null;
+    sweepOf: (door: DoorNode, hung: Hung) => Sweep & {
+        pivot: Point;
+    };
+    wayOf: (door: DoorNode, hung: Hung, angle: number) => {
+        room: {
+            id: string;
+            name: string;
+        };
+        way: import("./way-in.js").Way | null;
+        leaf: Prism;
+    } | null;
+    rests: (door: DoorNode, hung: Hung) => boolean;
+    wayInIssue: (door: DoorNode, hung: Hung, angle: number) => UsageIssue | null;
+};
+type SwingReader = ReturnType<typeof swingReader>;
+/**
+ * Prefer the served side, then a leaf resting against a wall, but only among clear, fully opening hangings.
+ * Read the costly way-in measure down that ranking only until the first clear one.
+ */
+export declare function hangToClear(reader: SwingReader, door: DoorNode, order: readonly [Hung, ...Hung[]]): {
+    hung: Hung;
+    why: string;
+};
+/**
+ * A door's leaf swept from its closed position to 90 degrees about its hinge at the jamb, on the face of the wall
+ * it swings to, against the pieces, cabinets, fixtures, walls, the treads and landings of a stair that rise above the
+ * door's floor and the closed leaves of other doors: the first
+ * angle at which it is in something. Read on the real outlines; the leaf is a line, so it is as long as the opening
+ * is wide less the frame. A leaf that cannot open to 90 degrees is a finding; so is one that would open fully hung
+ * the other way, which the message says. A door that cannot open at all (its hinge in a corner wall's body) reads 0.
+ * A leaf stopped below `OPENS_FULLY_DEG` warns whatever outline its blocker has; an approximate
+ * outline keeps its uncertainty and the message says "about" for the angle.
+ *
+ * A door that does open fully has its open leaf, at the angle it stops at, as an obstacle on the way from
+ * the doorway into the room: a way under a passage's width that the leaf bounds is the second case of the
+ * finding (`wayIn`), with what hanging the leaf at the other jamb would leave.
+ */
+export declare function doorSwingIssues(nodes: Nodes, shapes: UsageShapes): UsageIssue[];
+export {};
+//# sourceMappingURL=swings.d.ts.map