@ifc-lite/clash 1.8.0 → 1.9.0

package/README.md

@@ -32,6 +32,24 @@ const result = await engine.run(elements, [
 console.log(result.summary.total, 'clashes');
 ```
 
+If your host has already shifted `mesh.expressId` into a federated global id
+space (as the viewer's loader does for every model past the first) while the
+`IfcDataStore` keeps local ids, pass that shift as `meshIdOffset` so the adapter
+can address the store correctly:
+
+```ts
+elementsFromStep({ store, meshes, modelId, federation, meshIdOffset: model.idOffset });
+```
+
+`ClashElement.key` is the element's IFC GlobalId. An element that has none — a
+malformed root, or every element of a GLB-sourced model, whose store carries no
+IFC entities — falls back to `expressid:<encoded modelId>:<expressId>`. Express
+ids are only unique within a model, so the model id is part of that key:
+`clashReviewKey` and the viewer's element-pair exclusions key on the element key
+alone, and an unqualified fallback would let a review or an exclusion set on one
+model apply to another model's element. That fallback is stable only for as long
+as the host's `modelId` is (in the viewer it is a per-load uuid).
+
 Includes the TypeScript reference engine, a Rust→WASM kernel kept in lockstep by a
 differential test (opt-in via `@ifc-lite/clash/wasm`; `backend: 'auto'` currently
 resolves to the TS engine), STEP and IFC5/USD source adapters, spatial grouping,

package/dist/adapters/ifcx.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ifcx.d.ts","sourceRoot":"","sources":["../../src/adapters/ifcx.ts"],"names":[],"mappings":"AAuCA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE9D;;;;;;;GAOG;AACH,UAAU,gBAAgB;IACxB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACxC;AACD,UAAU,gBAAgB;IACxB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,kCAAkC;IAClC,MAAM,EAAE,WAAW,CAAC;IACpB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,UAAU,EAAE,YAAY,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA4D9F;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,gBAAgB,EAC/B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GACrC,YAAY,CAoBd"}
+{"version":3,"file":"ifcx.d.ts","sourceRoot":"","sources":["../../src/adapters/ifcx.ts"],"names":[],"mappings":"AAgDA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG9D;;;;;;;GAOG;AACH,UAAU,gBAAgB;IACxB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACxC;AACD,UAAU,gBAAgB;IACxB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,kCAAkC;IAClC,MAAM,EAAE,WAAW,CAAC;IACpB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,UAAU,EAAE,YAAY,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAqE9F;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,gBAAgB,EAC/B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GACrC,YAAY,CAoBd"}

package/dist/adapters/ifcx.js

@@ -29,12 +29,22 @@
  * builds from the USD `children` structure). This is the IFCX analogue of the
  * STEP void/host/assembly exclusions; it fabricates no relationships.
  *
- * This module is reached via the `@ifc-lite/clash/ifcx` subpath so the core
- * stays representation- and parser-neutral.
+ * Non-clashable classes (openings, spaces, grids, materials, type objects,
+ * spatial containers) are dropped before they become candidates, and every
+ * mesh belonging to one durable prim path is coalesced into a single
+ * `ClashElement` — both via `./shared.ts`, so this adapter and `step.ts`
+ * agree on the same predicate/merge instead of maintaining separate copies.
+ * See `shared.ts`'s doc comment for the full rationale, including why it
+ * imports `@ifc-lite/parser` for the spatial-container schema walk.
+ *
+ * This module is reached via the `@ifc-lite/clash/ifcx` subpath so the CORE
+ * clash engine (`engine.ts`/`types.ts`) stays representation-neutral — this
+ * adapter itself is not required to avoid every non-core dependency.
  */
 import { parseIfcx } from '@ifc-lite/ifcx';
 import { makeExclusionSet, qualifiedKey } from '../exclude.js';
 import { fromPositions } from '../math/aabb.js';
+import { isNonClashableTag, mergeMeshes } from './shared.js';
 /**
  * Parse an IFCX buffer and project its pre-tessellated meshes into
  * `ClashElement`s. Async because `parseIfcx` is async.
@@ -76,12 +86,20 @@ export async function elementsFromIfcx(options) {
         const key = idToPath.get(expressId);
         if (!key)
             continue;
+        // Drop non-physical / container classes before they become clash
+        // candidates — the IFCX analogue of `step.ts`'s #1464 filter. `tag` here
+        // is the real IFC class code (see `resolveTag` below), spelled
+        // identically to STEP's `node.type`, so the SAME shared predicate applies
+        // verbatim. (#1464)
+        const tag = resolveTag(group[0], entities, expressId);
+        if (isNonClashableTag(tag))
+            continue;
         const merged = mergeMeshes(group);
         const element = {
             key,
             ref: refFromPath(key),
             model: modelId,
-            tag: resolveTag(group[0], entities, expressId),
+            tag,
             name: resolveName(entities, expressId),
             bounds: fromPositions(merged.positions),
             positions: merged.positions,
@@ -141,39 +159,7 @@ function resolveName(entities, expressId) {
     const name = entities.getName(expressId);
     return name && name.length > 0 ? name : undefined;
 }
-/**
- * Concatenate a group of meshes (all belonging to the same entity) into a
- * single position/index buffer. Each subsequent mesh's indices are offset by
- * the running vertex count so the merged index buffer addresses the combined
- * vertex array. A single mesh is returned as-is (no copy) for the common case.
- */
-function mergeMeshes(group) {
-    if (group.length === 1) {
-        return { positions: group[0].positions, indices: group[0].indices };
-    }
-    let totalPositions = 0;
-    let totalIndices = 0;
-    for (const mesh of group) {
-        totalPositions += mesh.positions.length;
-        totalIndices += mesh.indices.length;
-    }
-    const positions = new Float32Array(totalPositions);
-    const indices = new Uint32Array(totalIndices);
-    let positionOffset = 0;
-    let indexOffset = 0;
-    let vertexBase = 0;
-    for (const mesh of group) {
-        positions.set(mesh.positions, positionOffset);
-        for (let i = 0; i < mesh.indices.length; i++) {
-            indices[indexOffset + i] = mesh.indices[i] + vertexBase;
-        }
-        positionOffset += mesh.positions.length;
-        indexOffset += mesh.indices.length;
-        // 3 floats per vertex; the next mesh's indices start after these vertices.
-        vertexBase += mesh.positions.length / 3;
-    }
-    return { positions, indices };
-}
+// `mergeMeshes` now lives in `./shared.ts`, shared verbatim with `step.ts`.
 /**
  * Deterministic non-negative 31-bit ref derived purely from the prim path via
  * FNV-1a over the UTF-16 code units. No clock, no randomness: the same path

package/dist/adapters/ifcx.js.map

@@ -1 +1 @@
-{"version":3,"file":"ifcx.js","sourceRoot":"","sources":["../../src/adapters/ifcx.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,EAAE,SAAS,EAAiB,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAiChD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAA2B;IAChE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAE5D,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,MAAM,CAAC;IAE7D,yEAAyE;IACzE,yEAAyE;IACzE,uEAAuE;IACvE,uEAAuE;IACvE,2EAA2E;IAC3E,uEAAuE;IACvE,8DAA8D;IAC9D,MAAM,MAAM,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC7C,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAC7D,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAEzD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QACjC,wEAAwE;QACxE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC;YAAE,SAAS;QAEvC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACpC,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,MAAM,WAAW,GAAG,IAAI,GAAG,EAAwB,CAAC;IAEpD,KAAK,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;QACxC,0EAA0E;QAC1E,wEAAwE;QACxE,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;QAElC,MAAM,OAAO,GAAiB;YAC5B,GAAG;YACH,GAAG,EAAE,WAAW,CAAC,GAAG,CAAC;YACrB,KAAK,EAAE,OAAO;YACd,GAAG,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC;YAC9C,IAAI,EAAE,WAAW,CAAC,QAAQ,EAAE,SAAS,CAAC;YACtC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC;YACvC,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC;QAEF,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvB,WAAW,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,UAAU,GAAG,eAAe;QAChC,CAAC,CAAC,mBAAmB,CAAC,aAAa,EAAE,WAAW,CAAC;QACjD,CAAC,CAAC,gBAAgB,EAAE,CAAC;IAEvB,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;AAClC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,aAA+B,EAC/B,WAAsC;IAEtC,MAAM,KAAK,GAA4B,EAAE,CAAC;IAE1C,KAAK,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,WAAW,EAAE,CAAC;QAC/C,yEAAyE;QACzE,qEAAqE;QACrE,MAAM,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;QACpD,MAAM,QAAQ,GAAG,aAAa,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAC7D,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAC5D,KAAK,MAAM,SAAS,IAAI,QAAQ,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC3C,IAAI,OAAO;gBAAE,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC1E,CAAC;QACD,KAAK,MAAM,SAAS,IAAI,OAAO,EAAE,CAAC;YAChC,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC3C,IAAI,OAAO;gBAAE,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IAED,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC;AACjC,CAAC;AAED;;;;GAIG;AACH,SAAS,UAAU,CACjB,IAAc,EACd,QAA6C,EAC7C,SAAiB;IAEjB,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,OAAO,CAAC;IACjE,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IACjD,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC/E,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,SAAS,WAAW,CAClB,QAAyC,EACzC,SAAiB;IAEjB,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACzC,OAAO,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACpD,CAAC;AAED;;;;;GAKG;AACH,SAAS,WAAW,CAAC,KAAiB;IACpC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IACtE,CAAC;IAED,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,cAAc,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;QACxC,YAAY,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IACtC,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC,cAAc,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,YAAY,CAAC,CAAC;IAC9C,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QAC9C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7C,OAAO,CAAC,WAAW,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC;QAC1D,CAAC;QACD,cAAc,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;QACxC,WAAW,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QACnC,2EAA2E;QAC3E,UAAU,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;AAChC,CAAC;AAED;;;;GAIG;AACH,SAAS,WAAW,CAAC,IAAY;IAC/B,IAAI,IAAI,GAAG,UAAU,CAAC,CAAC,6BAA6B;IACpD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;QAClC,uEAAuE;QACvE,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC7F,wEAAwE;QACxE,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;QAC9C,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;YACf,IAAI,IAAI,IAAI,CAAC;YACb,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC/F,CAAC;IACH,CAAC;IACD,uEAAuE;IACvE,OAAO,IAAI,GAAG,UAAU,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"ifcx.js","sourceRoot":"","sources":["../../src/adapters/ifcx.ts"],"names":[],"mappings":"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"}

package/dist/adapters/shared.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Types that are never physical clash candidates: voids, virtual/reference
+ * geometry, and non-product material associations. Including them produced
+ * phantom clashes (IfcVirtualElement, IfcOpeningElement, even
+ * IfcMaterialConstituent) that no clash rule referenced - they are dropped
+ * from the candidate set entirely, so "detect all" and per-rule runs only
+ * ever consider real building elements. (#1464)
+ *
+ * Spatial containers are handled separately by {@link isSpatialContainerTag},
+ * which derives them from the schema rather than from a list.
+ */
+export declare const NON_CLASHABLE_TAGS: ReadonlySet<string>;
+/**
+ * True for spatial *containers* - the entities whose geometry describes an
+ * extent that, by construction, encloses the elements assigned to it. A
+ * storey against the slab it contains is not a coordination problem, and
+ * IFC4.3 infrastructure exports routinely give IfcBuildingStorey / IfcRoad /
+ * IfcBridge tessellated bodies, so every contained element clashed with its
+ * own container. (follow-up to #1464)
+ *
+ * Derived from the schema, not enumerated: `getInheritanceChainAcrossSchemas`
+ * walks the bundled IFC2X3 + IFC4 + IFC4X3 union, so the IFC4.3 facility
+ * leaves (IfcRoad, IfcBridge, IfcFacilityPart, ...) resolve even though the
+ * parser's own codegen pin is IFC4_ADD2_TC1 and would return an empty chain
+ * for them. Both supertypes are checked because IFC2X3 has no
+ * `IfcSpatialElement` - `IfcSpatialStructureElement` descends straight from
+ * `IfcProduct` there. This subsumes the IfcSpace / IfcSpatialZone entries
+ * that #1464 listed by hand.
+ */
+export declare function isSpatialContainerTag(tag: string): boolean;
+/**
+ * Whether an element carrying this IFC class `tag` should never become a
+ * clash candidate: non-physical/reference geometry, a spatial container, or
+ * a type/style object (a template, not an occurrence — see `step.ts`'s
+ * original comment on `isIfcTypeLikeEntity` for why type geometry sails
+ * through the mesher and lands on top of the occurrences that use it).
+ */
+export declare function isNonClashableTag(tag: string): boolean;
+/** A mesh-shaped input to {@link mergeMeshes}: just the two buffers it needs. */
+export interface MergeableMesh {
+    positions: Float32Array;
+    indices: Uint32Array;
+}
+/**
+ * Concatenate a group of meshes (all belonging to the same durable entity)
+ * into a single position/index buffer, so one entity with several mesh
+ * representations (e.g. Body + Axis, or several sub-meshes) becomes exactly
+ * ONE `ClashElement` instead of several aliasing elements that share a
+ * key/ref. Each subsequent mesh's indices are offset by the running vertex
+ * count so the merged index buffer addresses the combined vertex array.
+ * Bounds are then derived from the MERGED positions by the caller
+ * (`fromPositions` already scans the whole buffer), so the union is correct
+ * for free — there is no separate "combine bounds" step to get wrong.
+ *
+ * A single mesh is returned as-is (no copy) for the common case.
+ */
+export declare function mergeMeshes(group: MergeableMesh[]): {
+    positions: Float32Array;
+    indices: Uint32Array;
+};
+//# sourceMappingURL=shared.d.ts.map

package/dist/adapters/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/adapters/shared.ts"],"names":[],"mappings":"AA2CA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAUjD,CAAC;AAKH;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAS1D;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAMtD;AAED,iFAAiF;AACjF,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,YAAY,CAAC;IACxB,OAAO,EAAE,WAAW,CAAC;CACtB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG;IAAE,SAAS,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,CA6BrG"}

package/dist/adapters/shared.js

@@ -0,0 +1,143 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/**
+ * Format-independent logic shared by `adapters/step.ts` and `adapters/ifcx.ts`.
+ *
+ * Both adapters turn a source-specific representation into `ClashElement`s,
+ * and both need the SAME two things done to get there correctly:
+ *
+ * 1. Drop non-physical / container classes before they become clash
+ *    candidates (openings, spaces, grids, materials, type objects, and
+ *    spatial containers whose geometry encloses — rather than physically
+ *    touches — what it contains). (#1464 and its follow-up.)
+ * 2. Coalesce every mesh belonging to one durable entity into exactly ONE
+ *    `ClashElement`, so an entity with multiple representations (e.g.
+ *    Body + Axis) never aliases into several clash candidates that share
+ *    one identity.
+ *
+ * Both are expressed purely in terms of IFC class names / merged geometry
+ * buffers — nothing here is STEP- or IFCX-specific. `elementsFromIfcx`'s
+ * `tag` is the real IFC class code (`bsi::ifc::class`) or the resolved
+ * entity-table type name, so it is spelled identically to `node.type` on the
+ * STEP side (`IfcWall`, `IfcSpace`, `IfcOpeningElement`, ...) — verified by
+ * `ifcx.ts`'s `resolveTag`. There is nothing format-specific to branch on, so
+ * this lives in ONE place both adapters call instead of two copies that can
+ * (and did) drift apart.
+ *
+ * `isSpatialContainerTag` needs `@ifc-lite/parser`'s schema-union inheritance
+ * walk to catch IFC4.3 leaves (IfcRoad, IfcBridge, ...) that are not in any
+ * hand-maintained list — the exact gap the original #1464 follow-up closed
+ * for STEP. `@ifc-lite/parser` is already a full dependency of
+ * `@ifc-lite/clash` (see package.json), so importing it here does not add a
+ * new package to the graph; it only makes explicit, in the file that needs
+ * it, a dependency the package already carries. `elementsFromIfcx`'s own
+ * module doc describes the CORE clash engine as representation- and
+ * parser-neutral — that claim is about `engine.ts`/`types.ts`, not about this
+ * filtering utility, which is allowed to lean on the schema registry both
+ * formats already agree on.
+ */
+import { getInheritanceChainAcrossSchemas, isIfcTypeLikeEntity } from '@ifc-lite/parser';
+/**
+ * Types that are never physical clash candidates: voids, virtual/reference
+ * geometry, and non-product material associations. Including them produced
+ * phantom clashes (IfcVirtualElement, IfcOpeningElement, even
+ * IfcMaterialConstituent) that no clash rule referenced - they are dropped
+ * from the candidate set entirely, so "detect all" and per-rule runs only
+ * ever consider real building elements. (#1464)
+ *
+ * Spatial containers are handled separately by {@link isSpatialContainerTag},
+ * which derives them from the schema rather than from a list.
+ */
+export const NON_CLASHABLE_TAGS = new Set([
+    'IfcOpeningElement',
+    'IfcOpeningStandardCase',
+    'IfcVirtualElement',
+    'IfcGrid',
+    'IfcGridAxis',
+    'IfcAnnotation',
+    'IfcMaterial',
+    'IfcMaterialConstituent',
+    'IfcMaterialLayer',
+]);
+/** Memoizes the schema walk below; IFC type names are a bounded vocabulary. */
+const spatialContainerByTag = new Map();
+/**
+ * True for spatial *containers* - the entities whose geometry describes an
+ * extent that, by construction, encloses the elements assigned to it. A
+ * storey against the slab it contains is not a coordination problem, and
+ * IFC4.3 infrastructure exports routinely give IfcBuildingStorey / IfcRoad /
+ * IfcBridge tessellated bodies, so every contained element clashed with its
+ * own container. (follow-up to #1464)
+ *
+ * Derived from the schema, not enumerated: `getInheritanceChainAcrossSchemas`
+ * walks the bundled IFC2X3 + IFC4 + IFC4X3 union, so the IFC4.3 facility
+ * leaves (IfcRoad, IfcBridge, IfcFacilityPart, ...) resolve even though the
+ * parser's own codegen pin is IFC4_ADD2_TC1 and would return an empty chain
+ * for them. Both supertypes are checked because IFC2X3 has no
+ * `IfcSpatialElement` - `IfcSpatialStructureElement` descends straight from
+ * `IfcProduct` there. This subsumes the IfcSpace / IfcSpatialZone entries
+ * that #1464 listed by hand.
+ */
+export function isSpatialContainerTag(tag) {
+    const cached = spatialContainerByTag.get(tag);
+    if (cached !== undefined)
+        return cached;
+    const chain = getInheritanceChainAcrossSchemas(tag);
+    const spatial = chain.some((a) => a === 'IfcSpatialElement' || a === 'IfcSpatialStructureElement');
+    spatialContainerByTag.set(tag, spatial);
+    return spatial;
+}
+/**
+ * Whether an element carrying this IFC class `tag` should never become a
+ * clash candidate: non-physical/reference geometry, a spatial container, or
+ * a type/style object (a template, not an occurrence — see `step.ts`'s
+ * original comment on `isIfcTypeLikeEntity` for why type geometry sails
+ * through the mesher and lands on top of the occurrences that use it).
+ */
+export function isNonClashableTag(tag) {
+    return (NON_CLASHABLE_TAGS.has(tag) ||
+        isSpatialContainerTag(tag) ||
+        isIfcTypeLikeEntity(tag.toUpperCase()));
+}
+/**
+ * Concatenate a group of meshes (all belonging to the same durable entity)
+ * into a single position/index buffer, so one entity with several mesh
+ * representations (e.g. Body + Axis, or several sub-meshes) becomes exactly
+ * ONE `ClashElement` instead of several aliasing elements that share a
+ * key/ref. Each subsequent mesh's indices are offset by the running vertex
+ * count so the merged index buffer addresses the combined vertex array.
+ * Bounds are then derived from the MERGED positions by the caller
+ * (`fromPositions` already scans the whole buffer), so the union is correct
+ * for free — there is no separate "combine bounds" step to get wrong.
+ *
+ * A single mesh is returned as-is (no copy) for the common case.
+ */
+export function mergeMeshes(group) {
+    if (group.length === 1) {
+        return { positions: group[0].positions, indices: group[0].indices };
+    }
+    let totalPositions = 0;
+    let totalIndices = 0;
+    for (const mesh of group) {
+        totalPositions += mesh.positions.length;
+        totalIndices += mesh.indices.length;
+    }
+    const positions = new Float32Array(totalPositions);
+    const indices = new Uint32Array(totalIndices);
+    let positionOffset = 0;
+    let indexOffset = 0;
+    let vertexBase = 0;
+    for (const mesh of group) {
+        positions.set(mesh.positions, positionOffset);
+        for (let i = 0; i < mesh.indices.length; i++) {
+            indices[indexOffset + i] = mesh.indices[i] + vertexBase;
+        }
+        positionOffset += mesh.positions.length;
+        indexOffset += mesh.indices.length;
+        // 3 floats per vertex; the next mesh's indices start after these vertices.
+        vertexBase += mesh.positions.length / 3;
+    }
+    return { positions, indices };
+}
+//# sourceMappingURL=shared.js.map

package/dist/adapters/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/adapters/shared.ts"],"names":[],"mappings":"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"}

package/dist/adapters/step.d.ts

@@ -3,9 +3,11 @@
  * into representation-agnostic `ClashElement`s, and precompute the
  * void/host/assembly pair exclusions from IFC relationships.
  *
- * This module is the only part of the package that depends on
+ * This module (along with `ifcx.ts`, via `shared.ts`) depends on
  * `@ifc-lite/parser` / `@ifc-lite/query`; it is reached via the
- * `@ifc-lite/clash/step` subpath so the core stays version-neutral.
+ * `@ifc-lite/clash/step` subpath so the core stays version-neutral. The
+ * non-clashable-tag filter and per-entity mesh coalescing are shared with
+ * `ifcx.ts` through `./shared.ts` — see that module's doc comment for why.
  */
 import { type IfcDataStore } from '@ifc-lite/parser';
 import type { MeshData } from '@ifc-lite/geometry';
@@ -21,6 +23,63 @@ export interface StepAdapterOptions {
     modelId: string;
     /** When provided, `ref` is the federated globalId; otherwise the expressId. */
     federation?: FederationLike;
+    /**
+     * The federation offset the HOST has ALREADY added to every `mesh.expressId`,
+     * so this adapter can subtract it back out and address `store` in its own
+     * (local) id space. Default 0 — meshes are local.
+     *
+     * The viewer's loader shifts meshes into the global id space in place
+     * (`useIfcLoader`: `mesh.expressId = mesh.expressId + idOffset`) while
+     * `IfcDataStore` keeps LOCAL ids, so for every federated model past the first
+     * `mesh.expressId` is NOT a key into `store`. Without this, every lookup in
+     * the loop below misses: `key` degrades to the synthetic fallback, `tag`
+     * reads `Unknown`, name/storey come back empty, and `buildStepExclusions`
+     * finds no relationships at all — so void/host/assembly pairs silently stop
+     * being excluded. `ref` was wrong in the other direction, with
+     * `federation.toGlobalId` adding the offset a second time.
+     *
+     * `tag` degrades with the rest, despite the `node.type || mesh.ifcType`
+     * expression below reading as though the mesh could rescue it: every
+     * production `EntityTable` returns the literal string `'Unknown'` from
+     * `getTypeName` on a miss, and `'Unknown'` is truthy, so the `mesh.ifcType`
+     * arm is unreachable on a store lookup that missed. `Unknown` next to a blank
+     * name is the loudest on-screen symptom of this bug.
+     *
+     * The viewer's own compare path (`lib/compare/buildFingerprints.ts`) does the
+     * same subtraction for the same reason. The CLI / MCP / playground callers
+     * hand over local meshes and leave this at its `0` default.
+     *
+     * ## Optional ON PURPOSE — not an oversight
+     *
+     * The obvious hardening is to make this REQUIRED, and the repo has the
+     * precedent: `buildFingerprints.ts` declares `idOffset: number` and does this
+     * exact subtraction, which is why compare never had this bug. It is
+     * deliberately NOT copied here. `buildFingerprints` is app-internal
+     * (`apps/viewer`), free to break at will; `elementsFromStep` is published API
+     * — `@ifc-lite/clash` exposes it as the `./step` subpath export — so
+     * requiring the member is a breaking change for every external caller, all of
+     * which legitimately pass local meshes and would have to add a `0` to keep
+     * compiling. That is a major bump to harden one in-repo call site, on a
+     * patch-level bugfix.
+     *
+     * What covers the gap instead, since the optional signature is exactly what
+     * let the viewer wiring be deleted and stay green:
+     *   - `apps/viewer/src/hooks/useClash.federated-id-offset.test.tsx` pins the
+     *     viewer's call at the level that actually broke (it fails if
+     *     `meshIdOffset` is dropped from `gatherElements`);
+     *   - the total-miss `console.warn` at the end of `elementsFromStep` reports
+     *     a forgotten offset at RUNTIME, in any host, including new ones — for
+     *     any model whose store actually holds GlobalIds. It stays silent for a
+     *     store that holds none (a GLB import), where a total miss is the normal
+     *     state and warning would only teach the reader to ignore the message.
+     *
+     * A dev-only `expressId < 0` assert was considered and rejected: it fires
+     * only when the subtrahend is too LARGE, whereas the failure that shipped was
+     * a forgotten offset, i.e. a subtrahend of 0 producing positive, plausible,
+     * entirely wrong ids. It would not have caught this bug. The total-miss check
+     * keys on the damage instead, so it catches both directions.
+     */
+    meshIdOffset?: number;
     /** Aligns this model into the common world frame (RTC + building rotation). */
     worldTransform?: Mat4;
     /** Precompute void/host/assembly exclusions. Default true. */
@@ -40,5 +99,5 @@ export declare function elementsFromStep(options: StepAdapterOptions): StepAdapt
  * - element vs its own (meshed) opening
  * - members of the same `IfcRelAggregates` assembly
  */
-export declare function buildStepExclusions(store: IfcDataStore, byExpressId: Map<number, ClashElement>): ExclusionSet;
+export declare function buildStepExclusions(store: IfcDataStore, byExpressId: Map<number, ClashElement[]>): ExclusionSet;
 //# sourceMappingURL=step.d.ts.map

package/dist/adapters/step.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../src/adapters/step.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AAEH,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAEpE,uFAAuF;AACvF,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;CACxD;AAuDD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,+EAA+E;IAC/E,cAAc,CAAC,EAAE,IAAI,CAAC;IACtB,8DAA8D;IAC9D,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,UAAU,EAAE,YAAY,CAAC;CAC1B;AAiBD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,GAAG,iBAAiB,CAoF/E;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,YAAY,EACnB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GACrC,YAAY,CAiCd"}
+{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../src/adapters/step.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAGpE,uFAAuF;AACvF,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;CACxD;AAMD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuDG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,cAAc,CAAC,EAAE,IAAI,CAAC;IACtB,8DAA8D;IAC9D,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,UAAU,EAAE,YAAY,CAAC;CAC1B;AAiED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,GAAG,iBAAiB,CA6L/E;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,YAAY,EACnB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,GACvC,YAAY,CAuCd"}