@pascal-app/core 1.0.6 → 1.1.0

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

@@ -0,0 +1,324 @@
+import { type Grid } from './field.js';
+import { type FloorGroup } from './level-field.js';
+import type { Prism, Ring, UsageShapes } from './types.js';
+import type { Nodes } from './walls.js';
+/** A person's trunk needs 0.45 m either side only in the loosest reading; the unit of passage is 0.60 m, so a clearance of 0.30 m. */
+export declare const UNIT_CLEARANCE_M = 0.3;
+export type ObstacleRef = {
+    nodeId: string;
+    kind: Prism['kind'];
+    shape: Prism['shape'];
+    why?: string;
+};
+export type Passage = {
+    /** Width of the widest path to the room, refined to the millimetre. */
+    width: number;
+    /** What the grid alone said. */
+    grid: number;
+    at: [number, number];
+    /** What bounds the width: the pair whose exact gap it is, or the obstacles a disc of that width touches at the pinch. */
+    by: ObstacleRef[];
+    /** The door the path starts at (ground floor), or null from a stair arrival. */
+    fromDoorId: string | null;
+};
+export type RoomMeasure = {
+    roomId: string;
+    levelId: string;
+    name: string;
+    kind: 'room' | 'stair-foot';
+    /** A point inside the room, for the finding's place. */
+    at: [number, number];
+    /** False when no way from the entrance reaches it. */
+    reached: boolean;
+    passage: Passage | null;
+    /** The same room measured from the best other exterior door, when that is wider. */
+    alternative: {
+        doorId: string;
+        width: number;
+    } | null;
+    /** Largest clear circle in the feet band, as a diameter. */
+    turning: {
+        diameter: number;
+        at: [number, number];
+        approximate: boolean;
+    } | null;
+    /** Floor where a unit of passage fits but cannot get out. */
+    pocket: {
+        isolatedM2: number;
+        freeM2: number;
+        whole: boolean;
+        at: [number, number] | null;
+        /** The two nearest things around it. */
+        by: ObstacleRef[];
+    };
+};
+export type GroupMeasure = {
+    levelId: string;
+    y: number;
+    source: {
+        kind: 'door' | 'stair-arrival' | 'none';
+        doorId: string | null;
+    };
+    rooms: RoomMeasure[];
+};
+export type UsageMeasure = {
+    groups: GroupMeasure[];
+    /** The entrance the ground floor was measured from. */
+    entranceDoorId: string | null;
+};
+export type MeasureOptions = {
+    /** Grid step of the clearance field, metres. 2 cm for checks, 5 cm for the editor. */
+    cell?: number;
+    entranceDoorId?: string;
+};
+/** The field and the floor a person can walk on, for one floor group: shared by the usage measures and the flow's widths. */
+export declare function prepareGroup(nodes: Nodes, shapes: UsageShapes, group: FloorGroup, cell: number, underlay: (prism: Prism) => boolean): {
+    arrival: {
+        top: Ring[];
+        all: Ring[];
+    };
+    body: import("./level-field.js").LevelField;
+    feet: import("./level-field.js").LevelField;
+    grid: Grid;
+    arrivalCells: Set<number>;
+    plate: Uint8Array<ArrayBuffer>;
+    stairMask: Uint8Array<ArrayBufferLike>;
+    doorsHere: {
+        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;
+    }[];
+};
+/**
+ * The widest-path, turning-circle and evacuation measures of every floor of the building, from the
+ * shapes `usageShapes` read. The floor is a cell grid of the clearance to the nearest obstacle in a
+ * band a body stands in; a passage is the widest path from the entrance to the room, its pinch
+ * re-solved on a finer grid to the millimetre; a pocket is floor where a 0.60 m unit fits but
+ * cannot get out.
+ */
+export declare function measureUsage(nodes: Nodes, shapes: UsageShapes, options?: MeasureOptions): UsageMeasure;
+//# sourceMappingURL=measure.d.ts.map

package/dist/spatial/usage-field/measure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"measure.d.ts","sourceRoot":"","sources":["../../../src/spatial/usage-field/measure.ts"],"names":[],"mappings":"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"}