brepjs-bim 0.23.0 → 0.23.2

package/dist/import/fromIfc.d.ts

@@ -1,6 +1,6 @@
 import { Result } from 'brepjs';
 import { BimError } from '../errors/bimError.js';
-import { ImportedModel } from './importedModel.js';
+import { ImportedModel, ImportedElement, ImportedGeometry } from './importedModel.js';
 export type { ImportedModel } from './importedModel.js';
 export interface FromIfcOptions {
     /** Activate web-ifc's large-coordinate recentering on open. Default false. */
@@ -8,6 +8,12 @@ export interface FromIfcOptions {
     /** Skip body-geometry reconstruction for fast metadata-only reads. Default false. */
     readonly skipGeometry?: boolean | undefined;
 }
+export interface FromIfcTestHooks {
+    readonly afterGeometry?: ((expressId: number, geometry: ImportedGeometry) => void) | undefined;
+    readonly afterElement?: ((element: ImportedElement, accumulatedCount: number) => void) | undefined;
+}
+/** Package-internal deterministic failure seam for import ownership tests. */
+export declare function setFromIfcTestHooksForTesting(hooks: FromIfcTestHooks | null): void;
 /**
  * Reads an IFC STEP-SPF byte buffer into an {@link ImportedModel}: schema, unit
  * scale, spatial tree, and one {@link ImportedElement} per physical product

package/dist/import/geometryRead.d.ts

@@ -7,7 +7,7 @@ import { SpfReader } from './spfReader.js';
  * Outcome of reconstructing a single product's body geometry.
  *
  * - `SOLID` — a brepjs ValidSolid was rebuilt (parametrically from a swept
- *   solid, or by a manifold STL round-trip of a tessellated mesh).
+ *   solid, or by sewing a manifold tessellated mesh).
  * - `MESH` — geometry exists but could not be turned into a closed solid;
  *   raw triangle data is returned and flagged lossy via `diagnostic`.
  * - `NONE` — the product carries no recognised body representation.
@@ -24,6 +24,16 @@ export type GeometryResult = {
 } | {
     readonly kind: 'NONE';
 };
+export interface BodyGeometryItems {
+    readonly hasBody: boolean;
+    readonly itemCount: number;
+    readonly items: readonly GeometryResult[];
+}
+export interface GeometryReadTestHooks {
+    readonly afterItemSolid?: ((itemExpressId: number, solid: ValidSolid) => void) | undefined;
+}
+/** Package-internal deterministic failure seam for import ownership tests. */
+export declare function setGeometryReadTestHooksForTesting(hooks: GeometryReadTestHooks | null): void;
 /**
  * Reconstructs the `Body` (SweptSolid) representation of a product into a brepjs
  * solid, falling back to tessellated mesh import when no parametric path exists.
@@ -34,6 +44,8 @@ export type GeometryResult = {
  * single bad element never aborts a model import.
  */
 export declare function readBodyGeometry(reader: SpfReader, productExpressId: number, scale: number, diagnostics: ValidationIssue[]): GeometryResult;
+/** Reconstructs each supported IFC Body item independently in representation order. */
+export declare function readBodyItems(reader: SpfReader, productExpressId: number, scale: number, diagnostics: ValidationIssue[]): BodyGeometryItems;
 /**
  * Reads an IfcProfileDef into a brepjs Profile (mm). Mirrors the writer's
  * profile-def emission (geometryWriter.writeProfile / profileDefWriter).

package/dist/import/importedModel.d.ts

@@ -1,25 +1,34 @@
-import { ValidSolid } from 'brepjs';
+import { Bounds3D, ValidSolid } from 'brepjs';
 import { ValidationReport } from '../validation/severity.js';
 import { IfcGuid } from '../identity/ifcGuid.js';
 import { ImportedSchema } from './spfReader.js';
 export type { ImportedSchema } from './spfReader.js';
 /**
- * How faithfully a product's body geometry was reconstructed:
+ * How faithfully the least faithful retained Body item was reconstructed:
  * - `PARAMETRIC` — rebuilt losslessly from a swept solid (extrude/revolve).
  * - `TESSELLATED_MANIFOLD` — a tessellated mesh was recovered as a closed solid
- *   via an STL round-trip; geometrically faithful but topology was re-derived.
- * - `TESSELLATED_LOSSY` — geometry exists only as raw triangles (mesh did not
- *   close into a solid); `solid` is null, `meshVertices`/`meshIndices` carry it.
+ *   by sewing its triangles; geometrically faithful but topology was re-derived.
+ * - `TESSELLATED_LOSSY` — at least one item exists only as raw triangles because
+ *   its mesh did not close into a solid. More faithful siblings may remain in `solids`.
  * - `NONE` — no recognised body representation was found.
  */
 export type GeometryFidelity = 'PARAMETRIC' | 'TESSELLATED_MANIFOLD' | 'TESSELLATED_LOSSY' | 'NONE';
+export type ImportedBodyCompleteness = 'COMPLETE' | 'PARTIAL' | 'NONE';
 export interface ImportedGeometry {
     readonly fidelity: GeometryFidelity;
-    /** The reconstructed solid; null when fidelity is `NONE` or `TESSELLATED_LOSSY`. */
+    /** Whether every IFC Body item reconstructed into an owned solid. */
+    readonly completeness: ImportedBodyCompleteness;
+    /** Owned World-placed reconstructed handles. Dispose them through disposeImportedModel(). */
+    readonly solids: readonly ValidSolid[];
+    /** Borrowed alias for a COMPLETE one-solid Body. Otherwise null. */
     readonly solid: ValidSolid | null;
-    /** Raw triangle vertices (interleaved xyz), present only for `TESSELLATED_LOSSY`. */
+    /** Component-wise union of all item bounds for a COMPLETE Body. Null if measurement fails. */
+    readonly bounds: Bounds3D | null;
+    /** Sum of item volumes in mm³ for a COMPLETE Body. Null if measurement fails. */
+    readonly volumeMm3: number | null;
+    /** Combined raw triangle vertices (interleaved xyz), present for `TESSELLATED_LOSSY`. */
     readonly meshVertices?: Float32Array | undefined;
-    /** Raw triangle indices, present only for `TESSELLATED_LOSSY`. */
+    /** Combined raw triangle indices, present for `TESSELLATED_LOSSY`. */
     readonly meshIndices?: Uint32Array | undefined;
 }
 export interface ImportedPset {

package/dist/index.d.ts

@@ -83,7 +83,7 @@ export type { ClassificationRef } from './types/classificationTypes.js';
 export type { PsetCategory, PsetMeasureType, PsetTemplate, PsetPropertyTemplate, } from './psets/psetTemplates.js';
 export { importError } from './errors/bimError.js';
 export type { BimError, BimErrorKind } from './errors/bimError.js';
-export type { ImportedModel, ImportedSchema, ImportedElement, ImportedElementCategory, ImportedGeometry, GeometryFidelity, ImportedPset, ImportedMaterial, ImportedClassification, ImportedSpatialNode, } from './import/importedModel.js';
+export type { ImportedModel, ImportedSchema, ImportedElement, ImportedElementCategory, ImportedGeometry, ImportedBodyCompleteness, GeometryFidelity, ImportedPset, ImportedMaterial, ImportedClassification, ImportedSpatialNode, } from './import/importedModel.js';
 export type { IfcGuid } from './identity/ifcGuid.js';
 export type { LocalId, LocalIdCounter } from './identity/localId.js';
 export type { UnitSystem, LengthUnit } from './units/units.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brepjs-bim",
-  "version": "0.23.0",
+  "version": "0.23.2",
   "description": "BIM layer for brepjs — IFC4-aligned parametric building elements",
   "keywords": [
     "bim",