brepjs-bim 0.24.2 → 0.24.3

package/README.md

@@ -192,3 +192,9 @@ npm run lint --workspace=brepjs-bim
 npm run build --workspace=brepjs-bim
 npm run test --workspace=brepjs-bim
 ```
+
+### Body material measurement
+
+Exact Wall quantities measure occupied material across all retained items. Overlapping solids count once. Bounds include every item. Measurement and temporary cleanup failures make these optional measurements unavailable and preserve the borrowed inputs. Cleanup never retries an uncertain native release.
+
+The BIM package requires `brepjs >=19.0.5` for native cleanup-error reporting.

package/dist/brepjs-bim.cjs

@@ -7621,6 +7621,71 @@ function coveringToSolid(spec) {
 	}
 }
 //#endregion
+//#region src/productBodyCleanup.ts
+var COMPLETE_CLEANUP = Object.freeze({ kind: "COMPLETE" });
+function cleanupReport(diagnostics) {
+	const [first, ...rest] = diagnostics;
+	if (first === void 0) return COMPLETE_CLEANUP;
+	const snapshot = Object.freeze([first, ...rest]);
+	return Object.freeze({
+		kind: "FAILED",
+		diagnostics: snapshot
+	});
+}
+/** Read known cleanup failures through Result, AggregateError and `using` error chains.
+* This reports prior attempts only; it never takes ownership or retries a release.
+*/
+function nestedCleanupDiagnostics(error, context) {
+	const diagnostics = [];
+	const seen = /* @__PURE__ */ new Set();
+	const visit = (value) => {
+		if (typeof value !== "object" || value === null || seen.has(value)) return;
+		seen.add(value);
+		if (value instanceof brepjs.GeometryCleanupError) {
+			diagnostics.push(Object.freeze({
+				...context,
+				resourceKind: value.resourceKind,
+				cause: value.cause
+			}));
+			return;
+		}
+		if (value instanceof AggregateError) value.errors.forEach(visit);
+		if ("cause" in value) visit(value.cause);
+		if ("error" in value && "suppressed" in value) {
+			visit(value.error);
+			visit(value.suppressed);
+		}
+	};
+	visit(error);
+	return diagnostics;
+}
+/** Owner-only, attempt-all cleanup. Never retry a release with an uncertain outcome. */
+function cleanupOwnedResources(items, context) {
+	const attempted = /* @__PURE__ */ new Set();
+	const diagnostics = [];
+	for (const { resource, itemIndex, resourceKind = "SHAPE" } of items) {
+		if (attempted.has(resource)) continue;
+		attempted.add(resource);
+		try {
+			resource[Symbol.dispose]();
+		} catch (cause) {
+			diagnostics.push(Object.freeze({
+				...context,
+				itemIndex,
+				resourceKind,
+				cause
+			}));
+		}
+	}
+	return cleanupReport(diagnostics);
+}
+//#endregion
+//#region src/productBodyTestHooks.ts
+var hooks = null;
+function productBodyTestHooks() {
+	return hooks;
+}
+//#endregion
 //#region src/types/productBody.ts
 /** Returns borrowed Product-local solids. The model retains ownership. */
 function bodySolids(body) {
@@ -7633,6 +7698,113 @@ function bodySolids(body) {
 function disposeProductBody(body) {
 	for (const solid of bodySolids(body)) solid[Symbol.dispose]();
 }
+function bodyError(operation, code, message, cause, itemIndex, cleanup = COMPLETE_CLEANUP) {
+	return {
+		kind: "BIM_GEOMETRY",
+		operation,
+		code,
+		message,
+		cause,
+		cleanup,
+		...itemIndex === void 0 ? {} : { itemIndex }
+	};
+}
+/** @internal Exact resource object identity only, without native topology queries. */
+function wrappedResourceObject(solid) {
+	if (typeof solid !== "object" || solid === null || !("wrapped" in solid)) return void 0;
+	if ("disposed" in solid && solid.disposed) return void 0;
+	const wrapped = solid.wrapped;
+	return typeof wrapped === "object" && wrapped !== null ? wrapped : void 0;
+}
+/** Validate the public handle contract and native solid topology before narrowing opaque input. */
+function isLiveValidSolid(value) {
+	return typeof value === "object" && value !== null && "disposed" in value && value.disposed === false && "wrapped" in value && value.wrapped !== null && value.wrapped !== void 0 && "delete" in value && typeof value.delete === "function" && "onDispose" in value && typeof value.onDispose === "function" && Symbol.dispose in value && typeof value[Symbol.dispose] === "function" && (0, brepjs.getKernel)().shapeType(value.wrapped) === "solid" && (0, brepjs.getKernel)().isValid(value.wrapped);
+}
+function validateItems(input, operation) {
+	if (!Array.isArray(input) || input.length === 0) return (0, brepjs.err)(bodyError(operation, "BODY_EMPTY_ITEMS", "Expected a nonempty solids array"));
+	const identities = /* @__PURE__ */ new Set();
+	const resources = /* @__PURE__ */ new Set();
+	const solids = [];
+	for (let itemIndex = 0; itemIndex < input.length; itemIndex++) try {
+		const injected = productBodyTestHooks()?.before?.({
+			step: "validate",
+			itemIndex
+		});
+		if (injected && !injected.ok) return (0, brepjs.err)(bodyError(operation, "BODY_VALIDATION_FAILED", "Item validation failed", injected.error, itemIndex));
+		const item = input[itemIndex];
+		if (!isLiveValidSolid(item)) return (0, brepjs.err)(bodyError(operation, "BODY_INVALID_ITEM", "Expected a live valid solid handle", void 0, itemIndex));
+		const resource = wrappedResourceObject(item);
+		if (identities.has(item) || resource !== void 0 && resources.has(resource)) return (0, brepjs.err)(bodyError(operation, "BODY_DUPLICATE_ITEM", "Item duplicates an earlier handle or its wrapped resource object", void 0, itemIndex));
+		identities.add(item);
+		if (resource !== void 0) resources.add(resource);
+		solids.push(item);
+	} catch (cause) {
+		return (0, brepjs.err)(bodyError(operation, "BODY_VALIDATION_FAILED", "Item validation threw", cause, itemIndex));
+	}
+	const [first, ...rest] = solids;
+	if (first === void 0) return (0, brepjs.err)(bodyError(operation, "BODY_EMPTY_ITEMS", "Expected a nonempty solids array"));
+	return (0, brepjs.ok)(Object.freeze([first, ...rest]));
+}
+function diagnostics(report) {
+	return report.kind === "FAILED" ? report.diagnostics : [];
+}
+function ownedOperation(operation, work) {
+	const scope = {
+		itemIndex: 0,
+		temporaries: []
+	};
+	let result;
+	try {
+		result = work(scope);
+	} catch (cause) {
+		result = (0, brepjs.err)(bodyError(operation, "BODY_OPERATION_FAILED", "Native Body operation threw", cause, scope.itemIndex));
+	}
+	const retired = cleanupOwnedResources(scope.temporaries, { operation });
+	if (result.ok && retired.kind === "COMPLETE") return result;
+	const cleanup = cleanupReport([...result.ok ? [] : nestedCleanupDiagnostics(result.error, {
+		operation,
+		itemIndex: scope.itemIndex
+	}), ...diagnostics(retired)]);
+	if (result.ok) return (0, brepjs.err)(bodyError(operation, "BODY_CLEANUP_FAILED", "Could not retire operation temporaries", void 0, void 0, cleanup));
+	return (0, brepjs.err)(bodyError(operation, result.error.code, result.error.message, result.error, scope.itemIndex, cleanup));
+}
+function before(step, itemIndex) {
+	return productBodyTestHooks()?.before?.({
+		step,
+		itemIndex
+	}) ?? (0, brepjs.ok)(void 0);
+}
+/** Occupied material in mm³. Borrowed imported items need no authored Body descriptor. */
+function measureProductBodyMaterial(solids) {
+	const checked = validateItems(solids, "measureProductBodyMaterial");
+	if (!checked.ok) return checked;
+	return ownedOperation("measureProductBodyMaterial", (scope) => {
+		let material = checked.value[0];
+		if (checked.value.length > 1) {
+			const ready = before("union", 0);
+			if (!ready.ok) return ready;
+			const fused = (0, brepjs.fuseAll)([...checked.value], { trackEvolution: false });
+			if (!fused.ok) return (0, brepjs.err)(fromBrepError(fused.error, "BODY_UNION_FAILED", "Could not union occupied material"));
+			material = fused.value;
+			scope.temporaries.push({
+				resource: material,
+				itemIndex: 0
+			});
+			const injected = productBodyTestHooks()?.afterAllocate?.({
+				step: "union",
+				itemIndex: 0,
+				solid: material
+			});
+			if (injected && !injected.ok) return injected;
+		}
+		const ready = before("measure", 0);
+		if (!ready.ok) return ready;
+		const measured = (productBodyTestHooks()?.measure ?? brepjs.measureVolume)(material);
+		if (!measured.ok) return (0, brepjs.err)(fromBrepError(measured.error, "BODY_MEASUREMENT_FAILED", "Could not measure occupied material"));
+		if (!Number.isFinite(measured.value) || measured.value <= 0) return (0, brepjs.err)(bodyError("measureProductBodyMaterial", "BODY_INVALID_VOLUME", "Expected a positive finite occupied volume in mm³", measured.value));
+		return measured;
+	});
+}
 //#endregion
 //#region src/model/bimModel.ts
 function exactWallBodyImmutable() {
@@ -15018,41 +15190,21 @@ function preflightExactBody(input) {
 //#endregion
 //#region src/serialize/exactWallQuantities.ts
 function deriveExactWallQuantities(input) {
-	const measure = input.dependencies?.measure ?? brepjs.measureVolume;
-	let volumeMm3;
-	if (input.solids.length === 1) try {
-		const measured = measure(input.solids[0]);
-		if (!measured.ok) return exactVolumeError(measured.error);
-		volumeMm3 = measured.value;
+	try {
+		const measured = measureProductBodyMaterial(input.solids);
+		if (!measured.ok) return wallVolumeError(measured.error);
+		return (0, brepjs.ok)({
+			lengthM: toIfcLengthM(input.spec.length),
+			widthM: toIfcLengthM(input.spec.thickness),
+			heightM: toIfcLengthM(input.spec.height),
+			netVolumeM3: measured.value / 1e9
+		});
 	} catch (cause) {
-		return exactVolumeError(cause);
+		return wallVolumeError(cause);
 	}
-	else {
-		const fuse = input.dependencies?.fuse ?? brepjs.fuseAll;
-		let union = null;
-		try {
-			const fused = fuse([...input.solids]);
-			if (!fused.ok) return exactVolumeError(fused.error);
-			union = fused.value;
-			const measured = measure(union);
-			if (!measured.ok) return exactVolumeError(measured.error);
-			volumeMm3 = measured.value;
-		} catch (cause) {
-			return exactVolumeError(cause);
-		} finally {
-			union?.[Symbol.dispose]();
-		}
-	}
-	if (!Number.isFinite(volumeMm3) || volumeMm3 <= 0) return exactVolumeError(/* @__PURE__ */ new Error(`Measured exact wall volume was ${volumeMm3}`));
-	return (0, brepjs.ok)({
-		lengthM: toIfcLengthM(input.spec.length),
-		widthM: toIfcLengthM(input.spec.thickness),
-		heightM: toIfcLengthM(input.spec.height),
-		netVolumeM3: volumeMm3 / 1e9
-	});
 }
-function exactVolumeError(cause) {
-	return (0, brepjs.err)(ifcError("IFC_EXACT_WALL_QUANTITY_DERIVATION_FAILED", "Failed to derive a positive finite NetVolume for an exact wall Product Body", cause));
+function wallVolumeError(cause) {
+	return (0, brepjs.err)(ifcError("IFC_EXACT_WALL_QUANTITY_DERIVATION_FAILED", "Failed to derive a positive finite NetVolume for the retained Wall Body", cause));
 }
 //#endregion
 //#region src/serialize/toIfc.ts

package/dist/brepjs-bim.js

@@ -1,4 +1,4 @@
-import { addHoles, applyMatrix, autoHeal, box, castShape, clone, convexHull, cut, err, extrude, fuse, fuseAll, getBounds, getKernel, getSolids, isClosedWire, isOk, isPlanarWire, isSolid, isValid, isValidSolid, locate, measureVolume, mesh, ok, outerWire, polygon, revolve, rotate, translate, validSolid } from "brepjs";
+import { GeometryCleanupError, addHoles, applyMatrix, autoHeal, box, castShape, clone, convexHull, cut, err, extrude, fuse, fuseAll, getBounds, getKernel, getSolids, isClosedWire, isOk, isPlanarWire, isSolid, isValid, isValidSolid, locate, measureVolume, mesh, ok, outerWire, polygon, revolve, rotate, translate, validSolid } from "brepjs";
 import * as WebIFC from "web-ifc";
 import { Handle, IFCROOT, IfcAPI } from "web-ifc";
 //#region src/identity/ifcGuid.ts
@@ -7598,6 +7598,71 @@ function coveringToSolid(spec) {
 	}
 }
 //#endregion
+//#region src/productBodyCleanup.ts
+var COMPLETE_CLEANUP = Object.freeze({ kind: "COMPLETE" });
+function cleanupReport(diagnostics) {
+	const [first, ...rest] = diagnostics;
+	if (first === void 0) return COMPLETE_CLEANUP;
+	const snapshot = Object.freeze([first, ...rest]);
+	return Object.freeze({
+		kind: "FAILED",
+		diagnostics: snapshot
+	});
+}
+/** Read known cleanup failures through Result, AggregateError and `using` error chains.
+* This reports prior attempts only; it never takes ownership or retries a release.
+*/
+function nestedCleanupDiagnostics(error, context) {
+	const diagnostics = [];
+	const seen = /* @__PURE__ */ new Set();
+	const visit = (value) => {
+		if (typeof value !== "object" || value === null || seen.has(value)) return;
+		seen.add(value);
+		if (value instanceof GeometryCleanupError) {
+			diagnostics.push(Object.freeze({
+				...context,
+				resourceKind: value.resourceKind,
+				cause: value.cause
+			}));
+			return;
+		}
+		if (value instanceof AggregateError) value.errors.forEach(visit);
+		if ("cause" in value) visit(value.cause);
+		if ("error" in value && "suppressed" in value) {
+			visit(value.error);
+			visit(value.suppressed);
+		}
+	};
+	visit(error);
+	return diagnostics;
+}
+/** Owner-only, attempt-all cleanup. Never retry a release with an uncertain outcome. */
+function cleanupOwnedResources(items, context) {
+	const attempted = /* @__PURE__ */ new Set();
+	const diagnostics = [];
+	for (const { resource, itemIndex, resourceKind = "SHAPE" } of items) {
+		if (attempted.has(resource)) continue;
+		attempted.add(resource);
+		try {
+			resource[Symbol.dispose]();
+		} catch (cause) {
+			diagnostics.push(Object.freeze({
+				...context,
+				itemIndex,
+				resourceKind,
+				cause
+			}));
+		}
+	}
+	return cleanupReport(diagnostics);
+}
+//#endregion
+//#region src/productBodyTestHooks.ts
+var hooks = null;
+function productBodyTestHooks() {
+	return hooks;
+}
+//#endregion
 //#region src/types/productBody.ts
 /** Returns borrowed Product-local solids. The model retains ownership. */
 function bodySolids(body) {
@@ -7610,6 +7675,113 @@ function bodySolids(body) {
 function disposeProductBody(body) {
 	for (const solid of bodySolids(body)) solid[Symbol.dispose]();
 }
+function bodyError(operation, code, message, cause, itemIndex, cleanup = COMPLETE_CLEANUP) {
+	return {
+		kind: "BIM_GEOMETRY",
+		operation,
+		code,
+		message,
+		cause,
+		cleanup,
+		...itemIndex === void 0 ? {} : { itemIndex }
+	};
+}
+/** @internal Exact resource object identity only, without native topology queries. */
+function wrappedResourceObject(solid) {
+	if (typeof solid !== "object" || solid === null || !("wrapped" in solid)) return void 0;
+	if ("disposed" in solid && solid.disposed) return void 0;
+	const wrapped = solid.wrapped;
+	return typeof wrapped === "object" && wrapped !== null ? wrapped : void 0;
+}
+/** Validate the public handle contract and native solid topology before narrowing opaque input. */
+function isLiveValidSolid(value) {
+	return typeof value === "object" && value !== null && "disposed" in value && value.disposed === false && "wrapped" in value && value.wrapped !== null && value.wrapped !== void 0 && "delete" in value && typeof value.delete === "function" && "onDispose" in value && typeof value.onDispose === "function" && Symbol.dispose in value && typeof value[Symbol.dispose] === "function" && getKernel().shapeType(value.wrapped) === "solid" && getKernel().isValid(value.wrapped);
+}
+function validateItems(input, operation) {
+	if (!Array.isArray(input) || input.length === 0) return err(bodyError(operation, "BODY_EMPTY_ITEMS", "Expected a nonempty solids array"));
+	const identities = /* @__PURE__ */ new Set();
+	const resources = /* @__PURE__ */ new Set();
+	const solids = [];
+	for (let itemIndex = 0; itemIndex < input.length; itemIndex++) try {
+		const injected = productBodyTestHooks()?.before?.({
+			step: "validate",
+			itemIndex
+		});
+		if (injected && !injected.ok) return err(bodyError(operation, "BODY_VALIDATION_FAILED", "Item validation failed", injected.error, itemIndex));
+		const item = input[itemIndex];
+		if (!isLiveValidSolid(item)) return err(bodyError(operation, "BODY_INVALID_ITEM", "Expected a live valid solid handle", void 0, itemIndex));
+		const resource = wrappedResourceObject(item);
+		if (identities.has(item) || resource !== void 0 && resources.has(resource)) return err(bodyError(operation, "BODY_DUPLICATE_ITEM", "Item duplicates an earlier handle or its wrapped resource object", void 0, itemIndex));
+		identities.add(item);
+		if (resource !== void 0) resources.add(resource);
+		solids.push(item);
+	} catch (cause) {
+		return err(bodyError(operation, "BODY_VALIDATION_FAILED", "Item validation threw", cause, itemIndex));
+	}
+	const [first, ...rest] = solids;
+	if (first === void 0) return err(bodyError(operation, "BODY_EMPTY_ITEMS", "Expected a nonempty solids array"));
+	return ok(Object.freeze([first, ...rest]));
+}
+function diagnostics(report) {
+	return report.kind === "FAILED" ? report.diagnostics : [];
+}
+function ownedOperation(operation, work) {
+	const scope = {
+		itemIndex: 0,
+		temporaries: []
+	};
+	let result;
+	try {
+		result = work(scope);
+	} catch (cause) {
+		result = err(bodyError(operation, "BODY_OPERATION_FAILED", "Native Body operation threw", cause, scope.itemIndex));
+	}
+	const retired = cleanupOwnedResources(scope.temporaries, { operation });
+	if (result.ok && retired.kind === "COMPLETE") return result;
+	const cleanup = cleanupReport([...result.ok ? [] : nestedCleanupDiagnostics(result.error, {
+		operation,
+		itemIndex: scope.itemIndex
+	}), ...diagnostics(retired)]);
+	if (result.ok) return err(bodyError(operation, "BODY_CLEANUP_FAILED", "Could not retire operation temporaries", void 0, void 0, cleanup));
+	return err(bodyError(operation, result.error.code, result.error.message, result.error, scope.itemIndex, cleanup));
+}
+function before(step, itemIndex) {
+	return productBodyTestHooks()?.before?.({
+		step,
+		itemIndex
+	}) ?? ok(void 0);
+}
+/** Occupied material in mm³. Borrowed imported items need no authored Body descriptor. */
+function measureProductBodyMaterial(solids) {
+	const checked = validateItems(solids, "measureProductBodyMaterial");
+	if (!checked.ok) return checked;
+	return ownedOperation("measureProductBodyMaterial", (scope) => {
+		let material = checked.value[0];
+		if (checked.value.length > 1) {
+			const ready = before("union", 0);
+			if (!ready.ok) return ready;
+			const fused = fuseAll([...checked.value], { trackEvolution: false });
+			if (!fused.ok) return err(fromBrepError(fused.error, "BODY_UNION_FAILED", "Could not union occupied material"));
+			material = fused.value;
+			scope.temporaries.push({
+				resource: material,
+				itemIndex: 0
+			});
+			const injected = productBodyTestHooks()?.afterAllocate?.({
+				step: "union",
+				itemIndex: 0,
+				solid: material
+			});
+			if (injected && !injected.ok) return injected;
+		}
+		const ready = before("measure", 0);
+		if (!ready.ok) return ready;
+		const measured = (productBodyTestHooks()?.measure ?? measureVolume)(material);
+		if (!measured.ok) return err(fromBrepError(measured.error, "BODY_MEASUREMENT_FAILED", "Could not measure occupied material"));
+		if (!Number.isFinite(measured.value) || measured.value <= 0) return err(bodyError("measureProductBodyMaterial", "BODY_INVALID_VOLUME", "Expected a positive finite occupied volume in mm³", measured.value));
+		return measured;
+	});
+}
 //#endregion
 //#region src/model/bimModel.ts
 function exactWallBodyImmutable() {
@@ -14995,41 +15167,21 @@ function preflightExactBody(input) {
 //#endregion
 //#region src/serialize/exactWallQuantities.ts
 function deriveExactWallQuantities(input) {
-	const measure = input.dependencies?.measure ?? measureVolume;
-	let volumeMm3;
-	if (input.solids.length === 1) try {
-		const measured = measure(input.solids[0]);
-		if (!measured.ok) return exactVolumeError(measured.error);
-		volumeMm3 = measured.value;
+	try {
+		const measured = measureProductBodyMaterial(input.solids);
+		if (!measured.ok) return wallVolumeError(measured.error);
+		return ok({
+			lengthM: toIfcLengthM(input.spec.length),
+			widthM: toIfcLengthM(input.spec.thickness),
+			heightM: toIfcLengthM(input.spec.height),
+			netVolumeM3: measured.value / 1e9
+		});
 	} catch (cause) {
-		return exactVolumeError(cause);
+		return wallVolumeError(cause);
 	}
-	else {
-		const fuse = input.dependencies?.fuse ?? fuseAll;
-		let union = null;
-		try {
-			const fused = fuse([...input.solids]);
-			if (!fused.ok) return exactVolumeError(fused.error);
-			union = fused.value;
-			const measured = measure(union);
-			if (!measured.ok) return exactVolumeError(measured.error);
-			volumeMm3 = measured.value;
-		} catch (cause) {
-			return exactVolumeError(cause);
-		} finally {
-			union?.[Symbol.dispose]();
-		}
-	}
-	if (!Number.isFinite(volumeMm3) || volumeMm3 <= 0) return exactVolumeError(/* @__PURE__ */ new Error(`Measured exact wall volume was ${volumeMm3}`));
-	return ok({
-		lengthM: toIfcLengthM(input.spec.length),
-		widthM: toIfcLengthM(input.spec.thickness),
-		heightM: toIfcLengthM(input.spec.height),
-		netVolumeM3: volumeMm3 / 1e9
-	});
 }
-function exactVolumeError(cause) {
-	return err(ifcError("IFC_EXACT_WALL_QUANTITY_DERIVATION_FAILED", "Failed to derive a positive finite NetVolume for an exact wall Product Body", cause));
+function wallVolumeError(cause) {
+	return err(ifcError("IFC_EXACT_WALL_QUANTITY_DERIVATION_FAILED", "Failed to derive a positive finite NetVolume for the retained Wall Body", cause));
 }
 //#endregion
 //#region src/serialize/toIfc.ts

package/dist/productBodyCleanup.d.ts

@@ -0,0 +1,33 @@
+import { NonEmpty } from './types/productBody.js';
+export interface GeometryCleanupDiagnostic {
+    readonly operation: string;
+    readonly itemIndex: number;
+    readonly resourceKind: 'SHAPE' | 'TRANSFORM';
+    readonly localId?: number;
+    readonly cause: unknown;
+}
+export type CleanupReport = {
+    readonly kind: 'COMPLETE';
+} | {
+    readonly kind: 'FAILED';
+    readonly diagnostics: NonEmpty<GeometryCleanupDiagnostic>;
+};
+export interface OwnedBodyResource {
+    readonly resource: Disposable;
+    readonly itemIndex: number;
+    readonly resourceKind?: 'SHAPE' | 'TRANSFORM';
+}
+export declare const COMPLETE_CLEANUP: CleanupReport;
+export declare function cleanupReport(diagnostics: readonly GeometryCleanupDiagnostic[]): CleanupReport;
+/** Read known cleanup failures through Result, AggregateError and `using` error chains.
+ * This reports prior attempts only; it never takes ownership or retries a release.
+ */
+export declare function nestedCleanupDiagnostics(error: unknown, context: {
+    readonly operation: string;
+    readonly itemIndex: number;
+}): readonly GeometryCleanupDiagnostic[];
+/** Owner-only, attempt-all cleanup. Never retry a release with an uncertain outcome. */
+export declare function cleanupOwnedResources(items: readonly OwnedBodyResource[], context: {
+    readonly operation: string;
+    readonly localId?: number;
+}): CleanupReport;

package/dist/productBodyTestHooks.d.ts

@@ -0,0 +1,19 @@
+import { BimError } from './errors/bimError.js';
+import { Result, ValidSolid, measureVolume, getBounds } from 'brepjs';
+export type BodyNativeStep = 'validate' | 'union' | 'measure' | 'bounds';
+export interface BodyNativeEvent {
+    readonly step: BodyNativeStep;
+    readonly itemIndex: number;
+}
+export interface ProductBodyTestHooks {
+    readonly before?: (event: BodyNativeEvent) => Result<void, BimError> | void;
+    /** Called only after the new handle has been registered for failure cleanup. */
+    readonly afterAllocate?: (event: BodyNativeEvent & {
+        readonly solid: ValidSolid;
+    }) => Result<void, BimError> | void;
+    readonly measure?: typeof measureVolume;
+    readonly bounds?: typeof getBounds;
+}
+/** Package-internal seam. Tests keep native geometry real and reset after each case. */
+export declare function setProductBodyTestHooksForTesting(value: ProductBodyTestHooks | null): void;
+export declare function productBodyTestHooks(): ProductBodyTestHooks | null;

package/dist/serialize/exactWallQuantities.d.ts

@@ -1,20 +1,16 @@
-import { fuseAll, measureVolume, Result, ValidSolid } from 'brepjs';
+import { Result, ValidSolid } from 'brepjs';
 import { BimError } from '../errors/bimError.js';
 import { WallSpec } from '../specs/wallSpec.js';
 import { NonEmpty } from '../types/productBody.js';
-export interface ExactWallQuantityValues {
+interface ExactWallQuantityValues {
     readonly lengthM: number;
     readonly widthM: number;
     readonly heightM: number;
     readonly netVolumeM3: number;
 }
-export interface ExactWallQuantityDependencies {
-    readonly fuse?: typeof fuseAll | undefined;
-    readonly measure?: typeof measureVolume | undefined;
-}
-export interface ExactWallQuantityInput {
+interface ExactWallQuantityInput {
     readonly spec: WallSpec;
     readonly solids: NonEmpty<ValidSolid>;
-    readonly dependencies?: ExactWallQuantityDependencies | undefined;
 }
 export declare function deriveExactWallQuantities(input: ExactWallQuantityInput): Result<ExactWallQuantityValues, BimError>;
+export {};

package/dist/types/productBody.d.ts

@@ -1,4 +1,6 @@
-import { ValidSolid } from 'brepjs';
+import { Bounds3D, Result, ValidSolid } from 'brepjs';
+import { BimError } from '../errors/bimError.js';
+import { CleanupReport } from '../productBodyCleanup.js';
 export type NonEmpty<T> = readonly [T, ...T[]];
 export type ProductBody = {
     readonly kind: 'PARAMETRIC';
@@ -11,3 +13,17 @@ export type ProductBody = {
 export declare function bodySolids(body: ProductBody): NonEmpty<ValidSolid>;
 /** Model-owner cleanup. Borrowers must use {@link bodySolids} without disposing its items. */
 export declare function disposeProductBody(body: ProductBody): void;
+export type ProductBodyOperation = 'productBodyBounds' | 'measureProductBodyMaterial';
+export interface ProductBodyError extends BimError {
+    readonly operation: ProductBodyOperation;
+    readonly itemIndex?: number;
+    readonly cleanup: CleanupReport;
+}
+/** @internal Exact resource object identity only, without native topology queries. */
+export declare function wrappedResourceObject(solid: unknown): object | undefined;
+/** Occupied material in mm³. Borrowed imported items need no authored Body descriptor. */
+export declare function measureProductBodyMaterial(solids: NonEmpty<ValidSolid>): Result<number, ProductBodyError>;
+/** Borrow all items and query their tight bounds in their existing coordinates. */
+export declare function productBodyBounds(solids: NonEmpty<ValidSolid>): Result<{
+    readonly bounds: Readonly<Bounds3D>;
+}, ProductBodyError>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brepjs-bim",
-  "version": "0.24.2",
+  "version": "0.24.3",
   "description": "BIM layer for brepjs — IFC4-aligned parametric building elements",
   "keywords": [
     "bim",
@@ -47,7 +47,7 @@
     "lint": "eslint src tests"
   },
   "peerDependencies": {
-    "brepjs": ">=18.0.0",
+    "brepjs": ">=19.0.5",
     "web-ifc": ">=0.0.50"
   },
   "devDependencies": {