bimatter-viewer-react 1.0.0 → 1.0.2

package/lib/sharedMeshMaterials.d.ts

@@ -0,0 +1,24 @@
+import type { DataTexture, Material, Plane } from "three";
+import type { BmtMaterialData } from "./Loaders/BmtLoader";
+import type { ViewerMaterialMode } from "./types";
+/**
+ * Materials shared by the meshes of one model that look the same. The cache
+ * must stay per model: preselection writes the element id into the material
+ * uniforms of every mesh of the preselected model, so a material shared
+ * between models would highlight the same id in all of them.
+ *
+ * Keys include everything a material is built from, so a cache can outlive
+ * palette or renderer changes without handing out a mismatched material.
+ */
+export declare class SharedMeshMaterials {
+    private readonly materials;
+    get<T extends Material>(key: string, create: () => T): T;
+    dispose(): void;
+}
+export declare function getSharedMeshMaterialKey(renderer: "webgl" | "webgpu", colorPaletteTexture: DataTexture, material: BmtMaterialData, materialMode: ViewerMaterialMode, useDoubleSideMaterial: boolean): string;
+/**
+ * Gives a model material the current section planes before it is rendered,
+ * so a mesh added while clipping is active never shows up unclipped for a
+ * frame. It also compiles the shader with the planes right away.
+ */
+export declare function applyMaterialClippingPlanes(material: Material, planes: Plane[] | undefined): void;

package/lib/utils/ClippingUtils/ClippingUtils.d.ts

@@ -112,6 +112,11 @@ export declare class ClippingUtils {
     private getSelectedWorldBox;
     setControlsEnabled(enabled: boolean): void;
     setSelectionInteractionDisabled(disabled: boolean): void;
+    /**
+     * The plane array model materials reference: the live planes while
+     * clipping is active, so dragging a plane needs no material update.
+     */
+    getMaterialPlanes(): Plane[];
     updateMaterials(): void;
     setActive(active: boolean): void;
     toggle(): void;
@@ -140,6 +145,7 @@ export declare function useClippingUtils(modelRef: ViewerModelRef, controlRef: V
     getPlanVisualObjects: () => Object3D[];
     setCapsCameraMotionActive: (active: boolean) => void;
     setEdgesCameraMotionActive: (active: boolean) => void;
+    getMaterialPlanes: () => Plane[];
     setCapsPreselection: (preselection: ClippingPreselection) => void;
     syncWithModel: () => void;
 };

package/lib/utils/DimentionsUtils/DimentionsUtils.d.ts

@@ -30,6 +30,7 @@ export type ViewerDimensionsApi = {
     deleteAll: () => void;
     getActive: () => boolean;
     getDimensions: () => DimensionLine[];
+    getPointAtPointer: (event: PointerEvent, snapToNearestPoint?: boolean) => Vector3 | null;
     getSnapDistance: () => number;
     getUnit: () => DimensionUnit;
     setActive: (active: boolean) => void;
@@ -40,6 +41,9 @@ export type ViewerDimensionsApi = {
     setWidth: (width: number) => void;
     toggle: () => void;
 };
+export type DimensionAxis = "x" | "y" | "z";
+export declare function getAxisConstrainedPoint(start: Vector3, point: Vector3, axis: DimensionAxis): Vector3;
+export declare function getDominantAxis(start: Vector3, point: Vector3): DimensionAxis;
 export declare class DimensionsUtils {
     private active;
     private axis;
@@ -73,6 +77,7 @@ export declare class DimensionsUtils {
     setContext(context: DimensionsContext): void;
     getActive(): boolean;
     getDimensions(): DimensionLine[];
+    getPointAtPointer(event: PointerEvent, snapToNearestPoint?: boolean): Vector3 | null;
     getSnapDistance(): number;
     getUnit(): DimensionUnit;
     setActive(active: boolean): void;

package/lib/utils/DimentionsUtils/index.d.ts

@@ -1,2 +1,2 @@
-export { DimensionsUtils, useDimensionsUtils, type ViewerDimensionsApi, } from "./DimentionsUtils";
+export { DimensionsUtils, getAxisConstrainedPoint, getDominantAxis, useDimensionsUtils, type DimensionAxis, type ViewerDimensionsApi, } from "./DimentionsUtils";
 export { DimensionLine, type DimensionUnit } from "./DimentionLine";

package/lib/utils/GeometryUtils/ElementCreationPreview.d.ts

@@ -0,0 +1,23 @@
+import { Scene, Vector3, type Camera } from "three";
+import { type IfcElementType } from "./createElements";
+export type ElementCreationPreviewState = {
+    height: number;
+    points: Vector3[];
+    type: IfcElementType;
+    width: number;
+};
+export declare class ElementCreationPreview {
+    private readonly cursor;
+    private readonly lineMaterial;
+    private readonly outline;
+    private readonly previewGroup;
+    private readonly root;
+    private readonly wall;
+    private readonly wallOutline;
+    constructor(scene: Scene);
+    update(point: Vector3 | null, state: ElementCreationPreviewState, camera: Camera, viewportHeight: number): void;
+    hide(): void;
+    dispose(): void;
+    private updateWall;
+    private updateSlabOutline;
+}

package/lib/utils/GeometryUtils/createElements.d.ts

@@ -0,0 +1,79 @@
+import { BufferGeometry } from "three";
+import type { BmtElementProps, BmtGeomData, BmtModelData, BmtModelStructure, BmtModelStructureNode } from "../../Loaders/BmtLoader";
+export type IfcElementType = "IfcWall" | "IfcSlab";
+export type BmtElementType = IfcElementType | "IfcElementProxy";
+export type IfcElementQuantities = Record<string, {
+    kind: "length" | "area" | "volume";
+    value: number;
+}>;
+export type CreatedBmtElement = {
+    geometry: BmtGeomData;
+    props: BmtElementProps;
+    structureNode: BmtModelStructureNode;
+};
+export type CreateIfcElementOptions = {
+    coordinationMatrix?: string;
+    name?: string;
+    quantities?: IfcElementQuantities;
+};
+export declare function createIfcGuid(): string;
+export declare function getNextElementID(models: Record<number, BmtModelData>): number;
+export declare function createWallGeometry(start: {
+    x: number;
+    y: number;
+    z: number;
+}, end: {
+    x: number;
+    y: number;
+    z: number;
+}, height: number, thickness?: number): {
+    geometry: BufferGeometry<import("three").NormalBufferAttributes, import("three").BufferGeometryEventMap>;
+    quantities: {
+        Length: {
+            kind: "length";
+            value: number;
+        };
+        Width: {
+            kind: "length";
+            value: number;
+        };
+        Height: {
+            kind: "length";
+            value: number;
+        };
+        GrossFootprintArea: {
+            kind: "area";
+            value: number;
+        };
+        NetFootprintArea: {
+            kind: "area";
+            value: number;
+        };
+        GrossSideArea: {
+            kind: "area";
+            value: number;
+        };
+        NetSideArea: {
+            kind: "area";
+            value: number;
+        };
+        GrossVolume: {
+            kind: "volume";
+            value: number;
+        };
+        NetVolume: {
+            kind: "volume";
+            value: number;
+        };
+    };
+};
+export declare function createSlabGeometry(outline: Array<{
+    x: number;
+    y: number;
+    z: number;
+}>, thickness: number): {
+    geometry: BufferGeometry<import("three").NormalBufferAttributes, import("three").BufferGeometryEventMap>;
+    quantities: IfcElementQuantities;
+};
+export declare function createBmtElement(sourceGeometry: BufferGeometry, type: BmtElementType, elementID: number, options?: CreateIfcElementOptions): CreatedBmtElement;
+export declare function appendElementToStructure(structure: BmtModelStructure, element: BmtModelStructureNode): BmtModelStructure;

package/lib/workers/WorkerErrors.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Turns a worker "error" event into an Error with whatever the browser told
+ * us. Errors thrown inside a running task come back as messages instead, so
+ * an event without a message usually means the worker script never started.
+ */
+export declare function createWorkerEventError(workerName: string, event: ErrorEvent): Error;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "bimatter-viewer-react",
-    "version": "1.0.0",
+    "version": "1.0.2",
     "license": "PolyForm-Noncommercial-1.0.0",
     "type": "module",
     "main": "./lib/index.js",