brepjs-bim 0.24.4 → 0.25.0

package/dist/geometryCleanupDiagnostics.d.ts

@@ -0,0 +1,6 @@
+import { BimError } from './errors/bimError.js';
+import { GeometryCleanupDiagnostic } from './productBodyCleanup.js';
+/** Read prior owner attempts without retrying releases or merging distinct failures. */
+export declare function reportedGeometryCleanup(error: BimError, operation: string, context?: {
+    readonly itemIndex?: number;
+}): readonly GeometryCleanupDiagnostic[];

package/dist/ifc-writer/geometryWriter.d.ts

@@ -1,15 +1,10 @@
 import { ValidSolid } from 'brepjs';
 import { IfcWriter } from './ifcWriter.js';
-import { WallSpec } from '../specs/wallSpec.js';
 import { SlabSpec } from '../specs/slabSpec.js';
 import { BeamSpec } from '../specs/beamSpec.js';
 import { ColumnSpec } from '../specs/columnSpec.js';
 import { RoofSpec } from '../specs/roofSpec.js';
 import { Profile } from '../specs/profile.js';
-export interface WallRepresentationIds {
-    localPlacementId: number;
-    productDefinitionShapeId: number;
-}
 export interface SlabRepresentationIds {
     localPlacementId: number;
     productDefinitionShapeId: number;
@@ -18,7 +13,6 @@ export interface LinearElementRepresentationIds {
     localPlacementId: number;
     productDefinitionShapeId: number;
 }
-export declare function writeWallGeometry(w: IfcWriter, spec: WallSpec, geomSubContextId: number, parentPlacementId: number | null): WallRepresentationIds;
 export declare function writeSlabGeometry(w: IfcWriter, spec: SlabSpec, geomSubContextId: number, parentPlacementId: number | null): SlabRepresentationIds;
 export declare function writeRoofGeometry(w: IfcWriter, spec: RoofSpec, solid: ValidSolid, geomSubContextId: number, parentPlacementId: number | null): SlabRepresentationIds & {
     usedFallback: boolean;

package/dist/ifc-writer/headerWriter.d.ts

@@ -28,6 +28,8 @@ export interface BimModelMeta {
     ifcSchema?: IfcSchema | undefined;
 }
 export declare function writeHeader(w: IfcWriter, meta: BimModelMeta): HeaderIds;
+/** Separates display Body geometry from non-subtractive Reference geometry. */
+export declare function writeGeometricSubContext(w: IfcWriter, geomContextId: number, identifier: 'Body' | 'Reference'): number;
 /**
  * Writes IfcProjectedCRS + IfcMapConversion georeferencing the model context
  * (GRF003). Coordinates are metres; rotation defaults to identity.

package/dist/ifc-writer/openingWriter.d.ts

@@ -13,7 +13,7 @@ type OpeningPsetSpec = {
     readonly acousticRating?: string | undefined;
     readonly thermalTransmittance?: number | undefined;
 };
-export declare function writeOpeningGeometry(w: IfcWriter, guid: IfcGuid, openingSpec: WallOpeningSpec, wallSpec: WallSpec, wallPlacementId: number, geomSubContextId: number, ownerHistoryId: number): OpeningIds;
+export declare function writeOpeningGeometry(w: IfcWriter, guid: IfcGuid, openingSpec: WallOpeningSpec, wallSpec: WallSpec, wallPlacementId: number, geomSubContextId: number, ownerHistoryId: number, representationIdentifier: 'Body' | 'Reference'): OpeningIds;
 export declare function writeSlabOpeningGeometry(w: IfcWriter, guid: IfcGuid, openingSpec: SlabOpeningSpec, slabSpec: SlabSpec, slabPlacementId: number, geomSubContextId: number, ownerHistoryId: number): OpeningIds;
 export declare function writeDoorEntity(w: IfcWriter, guid: IfcGuid, name: string, ownerHistoryId: number, openingPlacementId: number, geomSubContextId: number, overallWidthM: number, overallHeightM: number, nominalDepthMm?: number): number;
 export declare function writeWindowEntity(w: IfcWriter, guid: IfcGuid, name: string, ownerHistoryId: number, openingPlacementId: number, geomSubContextId: number, overallWidthM: number, overallHeightM: number, nominalDepthMm?: number): number;

package/dist/ifc-writer/tessellationWriter.d.ts

@@ -25,7 +25,7 @@ export type TessellationPreparation = {
     readonly reason: string;
     readonly cause?: unknown;
 };
-export interface ExactBodyRepresentationIds {
+export interface ProductBodyRepresentationIds {
     readonly localPlacementId: number;
     readonly productDefinitionShapeId: number;
     readonly bodyItemIds: readonly number[];
@@ -53,7 +53,7 @@ export declare function writePreparedTessellationBody(w: IfcWriter, items: NonEm
     readonly productDefinitionShapeId: number;
     readonly bodyItemIds: readonly number[];
 };
-export declare function writeExactBodyGeometry(w: IfcWriter, placement: FrameInput, items: NonEmpty<PreparedTessellation>, geomSubContextId: number, parentPlacementId: number | null): ExactBodyRepresentationIds;
+export declare function writeProductBodyGeometry(w: IfcWriter, placement: FrameInput, items: NonEmpty<PreparedTessellation>, geomSubContextId: number, parentPlacementId: number | null): ProductBodyRepresentationIds;
 export declare function writePreparedTessellationItem(w: IfcWriter, prepared: PreparedTessellation): number;
 /**
  * Builds a wall 'Axis' IfcShapeRepresentation: an IfcPolyline from (0,0) to

package/dist/import/cutImportedSolids.d.ts

@@ -0,0 +1,4 @@
+import { Result, ValidSolid } from 'brepjs';
+import { BimError } from '../errors/bimError.js';
+/** Borrow World-placed inputs; own every disconnected result independently of the cut's cache. */
+export declare function cutImportedSolids(host: ValidSolid, opening: ValidSolid): Result<readonly ValidSolid[], BimError>;

package/dist/import/fromIfc.d.ts

@@ -25,6 +25,6 @@ export declare function setFromIfcTestHooksForTesting(hooks: FromIfcTestHooks |
  * fatal failures — bad bytes, unsupported schema, WASM open failure — return
  * `err`. Inspect {@link ImportedModel.diagnostics} for per-element quality.
  *
- * The web-ifc model handle is always closed in a `finally` block.
+ * The web-ifc model handle is closed before handing reconstructed owners to the caller.
  */
 export declare function fromIfc(bytes: Uint8Array, options?: FromIfcOptions): Promise<Result<ImportedModel, BimError>>;

package/dist/import/importedModel.d.ts

@@ -18,13 +18,16 @@ export interface ImportedGeometry {
     readonly fidelity: GeometryFidelity;
     /** Whether every IFC Body item reconstructed into an owned solid. */
     readonly completeness: ImportedBodyCompleteness;
-    /** Owned World-placed reconstructed handles. Dispose them through disposeImportedModel(). */
+    /**
+     * Owned World-placed handles, in source-item order. Opening cuts can leave zero
+     * or more independent solids per source item. Dispose through disposeImportedModel().
+     */
     readonly solids: readonly ValidSolid[];
     /** Borrowed alias for a COMPLETE one-solid Body. Otherwise null. */
     readonly solid: ValidSolid | null;
-    /** Component-wise union of all item bounds for a COMPLETE Body. Null if measurement fails. */
+    /** All surviving item bounds for a COMPLETE Body. Null for no survivors or measurement failure. */
     readonly bounds: Bounds3D | null;
-    /** Sum of item volumes in mm³ for a COMPLETE Body. Null if measurement fails. */
+    /** Occupied-union mm³ for a COMPLETE Body. Null for no survivors or measurement failure. */
     readonly volumeMm3: number | null;
     /** Combined raw triangle vertices (interleaved xyz), present for `TESSELLATED_LOSSY`. */
     readonly meshVertices?: Float32Array | undefined;

package/dist/serialize/productBodyPreflight.d.ts

@@ -0,0 +1,15 @@
+import { Result, ValidSolid } from 'brepjs';
+import { BimError } from '../errors/bimError.js';
+import { LocalId } from '../identity/localId.js';
+import { NonEmpty } from '../types/productBody.js';
+import { PreparedTessellation, TessellationPreparation } from '../ifc-writer/tessellationWriter.js';
+export type ProductBodyItemPreparer = (solid: ValidSolid) => TessellationPreparation;
+/** Package-internal deterministic failure seam for serialization cleanup tests. */
+export declare function setProductBodyItemPreparerForTesting(prepareItem: ProductBodyItemPreparer | null): void;
+export interface ProductBodyPreflightInput {
+    readonly localId: LocalId;
+    readonly solids: NonEmpty<ValidSolid>;
+    readonly prepareItem?: ProductBodyItemPreparer | undefined;
+}
+/** Prepares every retained Body item without writing IFC lines. Source solids remain borrowed. */
+export declare function preflightProductBody(input: ProductBodyPreflightInput): Result<NonEmpty<PreparedTessellation>, BimError>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brepjs-bim",
-  "version": "0.24.4",
+  "version": "0.25.0",
   "description": "BIM layer for brepjs — IFC4-aligned parametric building elements",
   "keywords": [
     "bim",
@@ -59,7 +59,7 @@
     "vite-plugin-dts": "^5.0.0",
     "vitest": "^5.0.0",
     "web-ifc": "^0.0.77",
-    "zod": "4.6.4"
+    "zod": "4.6.5"
   },
   "dependencies": {
     "brepjs-families": ">=0.1.0 <1.0.0"

package/dist/serialize/exactBodyPreflight.d.ts

@@ -1,15 +0,0 @@
-import { Result, ValidSolid } from 'brepjs';
-import { BimError } from '../errors/bimError.js';
-import { LocalId } from '../identity/localId.js';
-import { NonEmpty } from '../types/productBody.js';
-import { PreparedTessellation, TessellationPreparation } from '../ifc-writer/tessellationWriter.js';
-export type ExactBodyItemPreparer = (solid: ValidSolid) => TessellationPreparation;
-/** Package-internal deterministic failure seam for serialization cleanup tests. */
-export declare function setExactBodyItemPreparerForTesting(prepareItem: ExactBodyItemPreparer | null): void;
-export interface ExactBodyPreflightInput {
-    readonly localId: LocalId;
-    readonly solids: NonEmpty<ValidSolid>;
-    readonly prepareItem?: ExactBodyItemPreparer | undefined;
-}
-/** Prepares every exact Body item without writing IFC lines. Source solids remain borrowed. */
-export declare function preflightExactBody(input: ExactBodyPreflightInput): Result<NonEmpty<PreparedTessellation>, BimError>;