@bldrs-ai/conway 1.437.1313 → 1.440.1336

package/compiled/src/compat/web-ifc/ifc_api_preview_coordination.test.js

@@ -0,0 +1,124 @@
+/* eslint-disable no-magic-numbers, dot-notation */
+// Adopted preview-channel coordination frames must be validated against
+// the durable walk's first geometry (Share#1634): a model can carry
+// geometry in more than one frame, so a preview anchored on a
+// local-scale unit hands the deferred pump a ~identity frame and the
+// georeferenced body streams out raw. The deferred pump now re-derives
+// from its own first geometry when the adopted frame leaves it beyond
+// the large-coordinate budget.
+//
+// The adoption is injected directly (tiny fixtures parse in one tick,
+// so the parse-time preview channel never fires on them); the injected
+// identity frame is exactly what a wrong-frame preview anchor produces.
+import * as fs from "fs";
+import { beforeAll, describe, expect, test } from "@jest/globals";
+import { LARGE_COORDINATE_BUDGET_M } from "./coordination_f64.js";
+import { IfcAPI } from "./ifc_api.js";
+const SETTINGS = {
+    COORDINATE_TO_ORIGIN: true,
+    USE_FAST_BOOLS: true,
+    DEFER_GEOMETRY: true,
+};
+const IDENTITY = [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1];
+let api;
+let georeferenced;
+let local;
+/**
+ * Pump a deferred model to completion and collect every placement
+ * translation.
+ *
+ * @param modelID The deferred model.
+ * @return {number[][]} One [x, y, z] per placed geometry.
+ */
+function pumpTranslations(modelID) {
+    const translations = [];
+    for (;;) {
+        const batch = [];
+        const { extracted, remaining } = api.ExtractGeometryBatch(modelID, 4, (mesh) => batch.push(mesh));
+        for (const mesh of batch) {
+            for (let where = 0; where < mesh.geometries.size(); ++where) {
+                const placed = mesh.geometries.get(where);
+                translations.push([
+                    placed.flatTransformation[12],
+                    placed.flatTransformation[13],
+                    placed.flatTransformation[14],
+                ]);
+            }
+        }
+        if (remaining === 0 || extracted === 0) {
+            break;
+        }
+    }
+    return translations;
+}
+/**
+ * @param translations Placement translations.
+ * @return {number} Largest absolute component.
+ */
+function maxComponent(translations) {
+    return translations.reduce((max, t) => Math.max(max, ...t.map(Math.abs)), 0);
+}
+/**
+ * Simulate a preview channel that anchored in the wrong frame: adopt an
+ * identity coordination exactly the way createDeferred does.
+ *
+ * @param modelID The deferred model.
+ */
+function injectIdentityPreviewFrame(modelID) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const proxy = api.models.get(modelID);
+    expect(proxy).toBeDefined();
+    proxy["demandCoordination_"] = [...IDENTITY];
+    proxy["_isCoordinated"] = true;
+    proxy["demandCoordinationFromPreview_"] = true;
+}
+beforeAll(async () => {
+    api = new IfcAPI();
+    await api.Init();
+    georeferenced = new Uint8Array(fs.readFileSync("data/index_georeferenced.ifc"));
+    local = new Uint8Array(fs.readFileSync("data/index.ifc"));
+}, 120000);
+describe("deferred pump preview-frame validation (Share#1634)", () => {
+    test("wrong-frame adopted coordination is re-derived on a georeferenced model", async () => {
+        // Control: no preview involvement — the pump derives its own frame.
+        const controlID = await api.OpenModelStreamed(georeferenced, { ...SETTINGS });
+        const control = pumpTranslations(controlID);
+        expect(control.length).toBeGreaterThan(0);
+        expect(maxComponent(control)).toBeLessThan(LARGE_COORDINATE_BUDGET_M);
+        // Explicit applied-frame report (Share#1634 acceptance): the real
+        // recenter offset — while GetCoordinationMatrix keeps its classic
+        // identity contract for assembled-model stamping.
+        const applied = api.GetAppliedCoordinationMatrix(controlID);
+        expect(Math.max(...applied.map(Math.abs)))
+            .toBeGreaterThan(LARGE_COORDINATE_BUDGET_M);
+        expect(api.GetCoordinationMatrix(controlID)).toEqual(IDENTITY);
+        // Adopting an identity frame (wrong-frame preview anchor) must not
+        // leave the body raw: the first durable geometry fails the budget
+        // check and the frame re-derives.
+        const adoptedID = await api.OpenModelStreamed(georeferenced, { ...SETTINGS });
+        injectIdentityPreviewFrame(adoptedID);
+        const adopted = pumpTranslations(adoptedID);
+        expect(adopted.length).toEqual(control.length);
+        expect(maxComponent(adopted)).toBeLessThan(LARGE_COORDINATE_BUDGET_M);
+        for (let where = 0; where < control.length; ++where) {
+            expect(adopted[where][0]).toBeCloseTo(control[where][0], 6);
+            expect(adopted[where][1]).toBeCloseTo(control[where][1], 6);
+            expect(adopted[where][2]).toBeCloseTo(control[where][2], 6);
+        }
+    }, 120000);
+    test("a within-budget adopted frame is kept (no false-positive re-derive)", async () => {
+        // On a local-scale model an identity frame is a VALID preview
+        // frame — validation must keep it, preserving preview/durable
+        // agreement, rather than re-deriving to the first-geometry anchor.
+        const adoptedID = await api.OpenModelStreamed(local, { ...SETTINGS });
+        injectIdentityPreviewFrame(adoptedID);
+        const adopted = pumpTranslations(adoptedID);
+        expect(adopted.length).toBeGreaterThan(0);
+        expect(maxComponent(adopted)).toBeLessThan(LARGE_COORDINATE_BUDGET_M);
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const proxy = api.models.get(adoptedID);
+        // Frame survived untouched: still exactly the injected identity.
+        expect([...proxy["demandCoordination_"]]).toEqual(IDENTITY);
+        expect(proxy["demandCoordinationFromPreview_"]).toBe(false);
+    }, 120000);
+});

package/compiled/src/compat/web-ifc/ifc_api_proxy_ap214.d.ts

@@ -70,6 +70,8 @@ export declare class IfcApiProxyAP214 implements IfcApiModelPassthrough {
      * identity contract (see the IFC proxy's demandCoordination_ note).
      */
     private demandCoordination_?;
+    /** Unvalidated adopted preview frame — see the IFC proxy twin. */
+    private demandCoordinationFromPreview_;
     _isCoordinated: boolean;
     linearScalingFactor: number;
     identity: number[];
@@ -316,6 +318,14 @@ export declare class IfcApiProxyAP214 implements IfcApiModelPassthrough {
      * @return {Array<number>}
      */
     getCoordinationMatrix(): Array<number>;
+    /**
+     * The coordination frame actually applied to emitted placements —
+     * the derived (or validated adopted) recenter, identity when no
+     * recenter ran. See ifc_api_model_passthrough.getAppliedCoordination.
+     *
+     * @return {Array<number>} column-major mat4
+     */
+    getAppliedCoordination(): Array<number>;
     /**
      *
      * @param ptr

package/compiled/src/compat/web-ifc/ifc_api_proxy_ap214.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ifc_api_proxy_ap214.d.ts","sourceRoot":"","sources":["../../../../src/compat/web-ifc/ifc_api_proxy_ap214.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ifc_api_proxy_ap214.d.ts","sourceRoot":"","sources":["../../../../src/compat/web-ifc/ifc_api_proxy_ap214.ts"],"names":[],"mappings":"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"}

package/compiled/src/compat/web-ifc/ifc_api_proxy_ap214.js

@@ -1,6 +1,6 @@
 import { ConwayGeometry, } from "../../index.js";
 import * as glmatrix from "gl-matrix";
-import { composeTransformF64, deriveCoordinationF64 } from "./coordination_f64.js";
+import { LARGE_COORDINATE_BUDGET_M, TRANSLATION_X, TRANSLATION_Y, TRANSLATION_Z, composeTransformF64, deriveCoordinationF64 } from "./coordination_f64.js";
 import Logger from "../../logging/logger.js";
 import ParsingBuffer from "../../parsing/parsing_buffer.js";
 import { ExtractResult } from "../../index.js";
@@ -109,6 +109,8 @@ export class IfcApiProxyAP214 {
          * the IFC proxy's delta capture; see its demandCapturedCounts_ note.
          */
         this.demandCapturedCounts_ = new Map();
+        /** Unvalidated adopted preview frame — see the IFC proxy twin. */
+        this.demandCoordinationFromPreview_ = false;
         this._isCoordinated = false;
         this.linearScalingFactor = 1;
         this.identity = [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1];
@@ -214,6 +216,9 @@ export class IfcApiProxyAP214 {
         if (this.deferredMode_ && loadState.previewCoordinationMatrix !== void 0) {
             this.demandCoordination_ = loadState.previewCoordinationMatrix;
             this._isCoordinated = true;
+            // Adopted, not derived — validated against the durable walk's
+            // first geometry (see the IFC proxy's demandCoordinationFromPreview_).
+            this.demandCoordinationFromPreview_ = true;
         }
         let FILE_NAME = stepHeader.headers.get("FILE_NAME");
         if (FILE_NAME !== void 0) {
@@ -848,6 +853,16 @@ export class IfcApiProxyAP214 {
         const coordinationMatrix = this.model[5];
         return Array.from(coordinationMatrix);
     }
+    /**
+     * The coordination frame actually applied to emitted placements —
+     * the derived (or validated adopted) recenter, identity when no
+     * recenter ran. See ifc_api_model_passthrough.getAppliedCoordination.
+     *
+     * @return {Array<number>} column-major mat4
+     */
+    getAppliedCoordination() {
+        return [...(this.demandCoordination_ ?? this.identity)];
+    }
     /**
      *
      * @param ptr
@@ -1002,8 +1017,11 @@ export class IfcApiProxyAP214 {
                 doubleSided: true,
                 blend: 0,
             };
+            const validatePreviewFrame = this.demandCoordinationFromPreview_ &&
+                this.settings?.COORDINATE_TO_ORIGIN === true;
             let nativePt;
-            if (!this._isCoordinated && this.settings?.COORDINATE_TO_ORIGIN) {
+            if ((!this._isCoordinated || validatePreviewFrame) &&
+                this.settings?.COORDINATE_TO_ORIGIN) {
                 nativePt = geometry.geometry.getPoint(0);
             }
             const expressID = model.getElementByLocalID(geometry.localID)?.expressID;
@@ -1017,6 +1035,21 @@ export class IfcApiProxyAP214 {
                 this.demandCoordination_ = derived;
                 this._isCoordinated = true;
             }
+            else if (validatePreviewFrame) {
+                // One-shot adopted-frame validation — see the IFC proxy twin
+                // (Share#1634). Bare composition here: AP214 has no per-leaf
+                // recenter (issue #308).
+                this.demandCoordinationFromPreview_ = false;
+                const probe = composeTransformF64(coordinationMatrix, geometryTransform);
+                const magnitude = Math.max(Math.abs(probe[TRANSLATION_X]), Math.abs(probe[TRANSLATION_Y]), Math.abs(probe[TRANSLATION_Z]));
+                if (magnitude > LARGE_COORDINATE_BUDGET_M) {
+                    const derived = deriveCoordinationF64(geometryTransform, nativePt, this.NormalizeMat, this.linearScalingFactor);
+                    coordinationMatrix = derived;
+                    this.demandCoordination_ = derived;
+                    Logger.info(`[deferred] preview coordination frame rejected (first durable ` +
+                        `placement at ${Math.round(magnitude)}m); re-derived from the durable anchor`);
+                }
+            }
             // Bare composition — no per-leaf recenter (issue #308: AP214
             // instances share one geometry buffer), matching streamAllMeshes.
             const newTransformArr = composeTransformF64(coordinationMatrix, geometryTransform);

package/compiled/src/compat/web-ifc/ifc_api_proxy_ifc.d.ts

@@ -72,16 +72,20 @@ export declare class IfcApiProxyIfc implements IfcApiModelPassthrough {
     /** Cursor into demandProducts_ — products before it are extracted. */
     private demandCursor_;
     /**
-     * Has the pump run the rel-aggregates master-voids pass? Classic's
-     * whole-model walk follows its product loop with a second pass that
-     * re-extracts every IfcRelAggregates related product using the
-     * relating object's rel-voids (extractRelAggregatesGeometry), which
-     * REPLACES the canonical mesh under the same localID — aggregate
-     * parts whose parent carries openings end up cut. The pump must run
-     * that same pass once after its last product batch or GetGeometry
-     * serves the uncut content classic never exposes.
-     */
-    private demandAggregatesDone_;
+     * Deferred-mode rel-aggregates worklist, pumped batch-by-batch AFTER
+     * the product cursor completes. Classic's whole-model walk follows
+     * its product loop with a second pass extracting every
+     * IfcRelAggregates related product using the relating object's
+     * rel-voids. Aggregate-target products are EXCLUDED from
+     * demandProducts_ (see aggregateTargetLocalIDs) so this pass is their
+     * first and only extraction — content is final when their instances
+     * are captured, and no placement is ever appended over an
+     * already-delivered one (the ILNA missing-facades / 388_4
+     * duplicate-placement class).
+     */
+    private demandAggregates_?;
+    /** Cursor into demandAggregates_ — items before it are extracted. */
+    private demandAggregatesCursor_;
     /**
      * Coordination matrix the deferred capture derived (or adopted from
      * the parse-time preview channel). Kept OFF the model tuple's slot 5
@@ -93,6 +97,18 @@ export declare class IfcApiProxyIfc implements IfcApiModelPassthrough {
      * memory.
      */
     private demandCoordination_?;
+    /**
+     * True while an adopted preview-channel coordination frame is still
+     * unvalidated against the durable walk's first geometry. A model can
+     * carry geometry in more than one frame (ISSUE_129: a local-scale
+     * annotation previews first while the body is georeferenced at
+     * ~8.3e6 m), so a frame anchored on the wrong unit leaves the body
+     * raw — the Share#1634 browser-vs-node divergence, which was really
+     * preview-vs-no-preview. streamNewMeshes_ clears this on its first
+     * geometry, re-deriving from it when the adopted frame fails the
+     * large-coordinate budget.
+     */
+    private demandCoordinationFromPreview_;
     _isCoordinated: boolean;
     linearScalingFactor: number;
     identity: number[];
@@ -376,6 +392,14 @@ export declare class IfcApiProxyIfc implements IfcApiModelPassthrough {
      * @return {Array<number>}
      */
     getCoordinationMatrix(): Array<number>;
+    /**
+     * The coordination frame actually applied to emitted placements —
+     * the derived (or validated adopted) recenter, identity when no
+     * recenter ran. See ifc_api_model_passthrough.getAppliedCoordination.
+     *
+     * @return {Array<number>} column-major mat4
+     */
+    getAppliedCoordination(): Array<number>;
     /**
      *
      * @param ptr

package/compiled/src/compat/web-ifc/ifc_api_proxy_ifc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ifc_api_proxy_ifc.d.ts","sourceRoot":"","sources":["../../../../src/compat/web-ifc/ifc_api_proxy_ifc.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ifc_api_proxy_ifc.d.ts","sourceRoot":"","sources":["../../../../src/compat/web-ifc/ifc_api_proxy_ifc.ts"],"names":[],"mappings":"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"}

package/compiled/src/compat/web-ifc/ifc_api_proxy_ifc.js

@@ -1,7 +1,7 @@
 import { ConwayGeometry, } from "../../index.js";
 import IfcStepModel from "../../ifc/ifc_step_model.js";
 import * as glmatrix from "gl-matrix";
-import { composeTransformF64, deriveCoordinationF64 } from "./coordination_f64.js";
+import { LARGE_COORDINATE_BUDGET_M, TRANSLATION_X, TRANSLATION_Y, TRANSLATION_Z, composeTransformF64, deriveCoordinationF64 } from "./coordination_f64.js";
 import { IfcProperties } from "./ifc_properties.js";
 import Logger from "../../logging/logger.js";
 import { ProgressTracker } from "../../core/progress.js";
@@ -20,7 +20,7 @@ import Memory from "../../memory/memory.js";
 import { FromRawLineData } from "./ifc2x4_helper.js";
 import { shimIfcEntityMap, shimIfcEntityReverseMap } from "./shim_schema_mapping.js";
 import { EntityTypesIfcCount } from "../../ifc/ifc4_gen/entity_types_ifc.gen.js";
-import { IfcProduct, IfcRoot } from "../../ifc/ifc4_gen/index.js";
+import { IfcProduct, IfcRelAggregates, IfcRoot } from "../../ifc/ifc4_gen/index.js";
 import { CanonicalMeshType } from "../../index.js";
 // Batch size used when a whole-model consumer (streamAllMeshes) drains
 // a deferred model's remaining products synchronously.
@@ -58,17 +58,20 @@ export class IfcApiProxyIfc {
         this.demandCapturedCounts_ = new Map();
         /** Cursor into demandProducts_ — products before it are extracted. */
         this.demandCursor_ = 0;
+        /** Cursor into demandAggregates_ — items before it are extracted. */
+        this.demandAggregatesCursor_ = 0;
         /**
-         * Has the pump run the rel-aggregates master-voids pass? Classic's
-         * whole-model walk follows its product loop with a second pass that
-         * re-extracts every IfcRelAggregates related product using the
-         * relating object's rel-voids (extractRelAggregatesGeometry), which
-         * REPLACES the canonical mesh under the same localID — aggregate
-         * parts whose parent carries openings end up cut. The pump must run
-         * that same pass once after its last product batch or GetGeometry
-         * serves the uncut content classic never exposes.
+         * True while an adopted preview-channel coordination frame is still
+         * unvalidated against the durable walk's first geometry. A model can
+         * carry geometry in more than one frame (ISSUE_129: a local-scale
+         * annotation previews first while the body is georeferenced at
+         * ~8.3e6 m), so a frame anchored on the wrong unit leaves the body
+         * raw — the Share#1634 browser-vs-node divergence, which was really
+         * preview-vs-no-preview. streamNewMeshes_ clears this on its first
+         * geometry, re-deriving from it when the adopted frame fails the
+         * large-coordinate budget.
          */
-        this.demandAggregatesDone_ = false;
+        this.demandCoordinationFromPreview_ = false;
         this._isCoordinated = false;
         this.linearScalingFactor = 1;
         this.identity = [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1];
@@ -175,6 +178,9 @@ export class IfcApiProxyIfc {
         if (this.deferredMode_ && loadState.previewCoordinationMatrix !== void 0) {
             this.demandCoordination_ = loadState.previewCoordinationMatrix;
             this._isCoordinated = true;
+            // Adopted, not derived: validate against the durable walk's first
+            // geometry before trusting it (see demandCoordinationFromPreview_).
+            this.demandCoordinationFromPreview_ = true;
         }
         let FILE_NAME = stepHeader.headers.get("FILE_NAME");
         if (FILE_NAME !== void 0) {
@@ -984,6 +990,16 @@ export class IfcApiProxyIfc {
         /* eslint-enable no-unused-vars */
         return Array.from(coordinationMatrix);
     }
+    /**
+     * The coordination frame actually applied to emitted placements —
+     * the derived (or validated adopted) recenter, identity when no
+     * recenter ran. See ifc_api_model_passthrough.getAppliedCoordination.
+     *
+     * @return {Array<number>} column-major mat4
+     */
+    getAppliedCoordination() {
+        return [...(this.demandCoordination_ ?? this.identity)];
+    }
     /**
      *
      * @param ptr
@@ -1038,7 +1054,9 @@ export class IfcApiProxyIfc {
     releaseGeometry() {
         if (this.deferredMode_ &&
             this.demandProducts_ !== void 0 &&
-            this.demandCursor_ < this.demandProducts_.length) {
+            (this.demandCursor_ < this.demandProducts_.length ||
+                this.demandAggregatesCursor_ <
+                    (this.demandAggregates_?.length ?? 0))) {
             Logger.warning("[ReleaseModelGeometry]: deferred pump not drained \u2014 not releasing");
             return false;
         }
@@ -1086,14 +1104,33 @@ export class IfcApiProxyIfc {
             return { extracted: 0, remaining: 0 };
         }
         if (this.demandProducts_ === void 0) {
+            // Aggregate-target products are extracted ONLY by the
+            // rel-aggregates pass below (with the relating object's master
+            // rel-voids), never by the per-product pass: extracting them here
+            // first would emit their instances with the uncut/placeholder
+            // content and the pass's later replacement would never reach an
+            // incremental consumer (it copies at delivery), while the pass's
+            // second scene instance would draw over the first (see
+            // aggregateTargetLocalIDs).
+            const aggregateTargets = this.conwayGeometry_.aggregateTargetLocalIDs();
             const products = [];
             for (const product of this.model[0].types(IfcProduct)) {
+                if (aggregateTargets.has(product.localID)) {
+                    continue;
+                }
                 products.push(product.localID);
             }
+            const aggregates = [];
+            for (const relAggregate of this.model[0].types(IfcRelAggregates)) {
+                aggregates.push(relAggregate);
+            }
             this.demandProducts_ = products;
+            this.demandAggregates_ = aggregates;
             this.demandCursor_ = 0;
+            this.demandAggregatesCursor_ = 0;
         }
-        const end = Math.min(this.demandCursor_ + Math.max(batchSize, 1), this.demandProducts_.length);
+        const budget = Math.max(batchSize, 1);
+        const end = Math.min(this.demandCursor_ + budget, this.demandProducts_.length);
         let extracted = 0;
         for (; this.demandCursor_ < end; ++this.demandCursor_) {
             const localID = this.demandProducts_[this.demandCursor_];
@@ -1101,23 +1138,27 @@ export class IfcApiProxyIfc {
                 ++extracted;
             }
         }
-        // Classic parity: once the product walk completes, run the
-        // whole-model walk's second (rel-aggregates master-voids) pass in
-        // the SAME call, so this call's delta capture already emits the
-        // re-extracted instances and the GetGeometry map's last writer for
-        // every replaced mesh matches classic exactly (see
-        // demandAggregatesDone_).
+        // Classic parity: once the product walk completes, pump the
+        // whole-model walk's second (rel-aggregates master-voids) pass with
+        // the same per-call budget — batch-by-batch, not as one end-of-load
+        // stall — so aggregate parts stream in cut, exactly once, with
+        // final content (see demandAggregates_).
+        const aggregates = this.demandAggregates_ ?? [];
         if (this.demandCursor_ >= this.demandProducts_.length &&
-            !this.demandAggregatesDone_) {
-            this.demandAggregatesDone_ = true;
-            this.conwayGeometry_.extractRelAggregatesGeometry();
+            this.demandAggregatesCursor_ < aggregates.length) {
+            const aggregatesEnd = Math.min(this.demandAggregatesCursor_ + (budget - extracted), aggregates.length);
+            for (; this.demandAggregatesCursor_ < aggregatesEnd; ++this.demandAggregatesCursor_) {
+                this.conwayGeometry_.extractRelAggregateGeometry(aggregates[this.demandAggregatesCursor_]);
+                ++extracted;
+            }
         }
         if (meshCallback !== void 0) {
             this.streamNewMeshes_(meshCallback);
         }
         return {
             extracted,
-            remaining: this.demandProducts_.length - this.demandCursor_,
+            remaining: (this.demandProducts_.length - this.demandCursor_) +
+                (aggregates.length - this.demandAggregatesCursor_),
         };
     }
     /**
@@ -1175,8 +1216,11 @@ export class IfcApiProxyIfc {
                 doubleSided: true,
                 blend: 0,
             };
+            const validatePreviewFrame = this.demandCoordinationFromPreview_ &&
+                this.settings?.COORDINATE_TO_ORIGIN === true;
             let nativePt;
-            if (!this._isCoordinated && this.settings?.COORDINATE_TO_ORIGIN) {
+            if ((!this._isCoordinated || validatePreviewFrame) &&
+                this.settings?.COORDINATE_TO_ORIGIN) {
                 nativePt = geometry.geometry.getPoint(0);
             }
             // normalize() recenters the shared geometry buffer (side effect)
@@ -1195,6 +1239,25 @@ export class IfcApiProxyIfc {
                 this.demandCoordination_ = derived;
                 this._isCoordinated = true;
             }
+            else if (validatePreviewFrame) {
+                // One-shot check of an adopted preview frame against the durable
+                // walk's first geometry: when the composed placement still lands
+                // beyond the large-coordinate budget, the preview anchored in a
+                // different frame than the model body (Share#1634) — re-derive
+                // from this geometry, the classic path's anchor. The throwaway
+                // preview scene may briefly disagree; the durable model must
+                // place like the classic open.
+                this.demandCoordinationFromPreview_ = false;
+                const probe = composeTransformF64(coordinationMatrix, geometryTransform, center);
+                const magnitude = Math.max(Math.abs(probe[TRANSLATION_X]), Math.abs(probe[TRANSLATION_Y]), Math.abs(probe[TRANSLATION_Z]));
+                if (magnitude > LARGE_COORDINATE_BUDGET_M) {
+                    const derived = deriveCoordinationF64(geometryTransform, nativePt, this.NormalizeMat, this.linearScalingFactor);
+                    coordinationMatrix = derived;
+                    this.demandCoordination_ = derived;
+                    Logger.info(`[deferred] preview coordination frame rejected (first durable ` +
+                        `placement at ${Math.round(magnitude)}m); re-derived from the durable anchor`);
+                }
+            }
             const newTransformArr = composeTransformF64(coordinationMatrix, geometryTransform, center);
             geometryMaterialTransformMap.set(expressID, [geometry.geometry, material_, newTransformArr]);
             const color = {
@@ -1317,6 +1380,9 @@ export class IfcApiProxyIfc {
                 const geometryTransform = nativeTransform?.getValues();
                 if (!this._isCoordinated && this.settings?.COORDINATE_TO_ORIGIN) {
                     coordinationMatrix = deriveCoordinationF64(geometryTransform, nativePt, this.NormalizeMat, this.linearScalingFactor);
+                    // Persisted for getAppliedCoordination (Share#1634): report
+                    // the real applied frame, not the classic silent identity.
+                    this.demandCoordination_ = Array.from(coordinationMatrix);
                     this._isCoordinated = true;
                 }
                 const newTransformArr = composeTransformF64(coordinationMatrix, geometryTransform, center);
@@ -1445,6 +1511,8 @@ export class IfcApiProxyIfc {
                 if (!this._isCoordinated && this.settings?.COORDINATE_TO_ORIGIN) {
                     Logger.info("Setting up coordinationMatrix");
                     coordinationMatrix = deriveCoordinationF64(geometryTransform, nativePt, this.NormalizeMat, this.linearScalingFactor);
+                    // Persisted for getAppliedCoordination (Share#1634).
+                    this.demandCoordination_ = Array.from(coordinationMatrix);
                     this._isCoordinated = true;
                 }
                 const newTransformArr = composeTransformF64(coordinationMatrix, geometryTransform, center);
@@ -1559,6 +1627,8 @@ export class IfcApiProxyIfc {
                 if (!this._isCoordinated && this.settings?.COORDINATE_TO_ORIGIN) {
                     Logger.info("Setting up coordinationMatrix");
                     coordinationMatrix = deriveCoordinationF64(geometryTransform, nativePt, this.NormalizeMat, this.linearScalingFactor);
+                    // Persisted for getAppliedCoordination (Share#1634).
+                    this.demandCoordination_ = Array.from(coordinationMatrix);
                     this._isCoordinated = true;
                 }
                 const newTransformArr = composeTransformF64(coordinationMatrix, geometryTransform, center);

package/compiled/src/ifc/ifc_geometry_extraction.d.ts

@@ -5,7 +5,7 @@ import { CanonicalProfile } from "../core/canonical_profile.js";
 import { CountProgressCallback } from "../core/progress.js";
 import { NativeULongVector, NativeUintVector, NativeVectorBound3D, NativeVectorGeometry, NativeVectorGeometryCollection, NativeVectorGlmVec2, NativeVectorGlmVec3, NativeVectorIndexedPolygonalFace, NativeVectorProfile, NativeVectorSegment, WasmModule } from "../core/native_types.js";
 import { ExtractResult } from "../core/shared_constants.js";
-import { IfcAxis2Placement2D, IfcAxis2Placement3D, IfcBooleanResult, IfcCartesianTransformationOperator3D, IfcCircleProfileDef, IfcColourRgb, IfcDirection, IfcExtrudedAreaSolid, IfcIndexedPolyCurve, IfcMappedItem, IfcNormalisedRatioMeasure, IfcObjectPlacement, IfcPolygonalFaceSet, IfcProduct, IfcProfileDef, IfcRepresentationItem, IfcSpecularExponent, IfcSpecularRoughness, IfcStyledItem, IfcSurfaceStyle, IfcBooleanClippingResult, IfcCompositeCurve, IfcPolyline, IfcTrimmedCurve, IfcCartesianPoint, IfcCurve, IfcCircle, IfcHalfSpaceSolid, IfcPlane, IfcShellBasedSurfaceModel, IfcFace, IfcFacetedBrep, IfcMaterialList, IfcMaterialLayerSetUsage, IfcMaterial, IfcRectangleProfileDef, IfcMaterialProfileSet, IfcMaterialConstituentSet, IfcMaterialConstituent, IfcMaterialProfile, IfcSIPrefix, IfcFaceBasedSurfaceModel, IfcConnectedFaceSet, IfcAdvancedBrep, IfcAdvancedFace, IfcBSplineCurve, IfcBSplineSurface, IfcBSplineSurfaceWithKnots, IfcRationalBSplineSurfaceWithKnots, IfcCylindricalSurface, IfcSurfaceOfRevolution, IfcSurfaceOfLinearExtrusion, IfcAxis1Placement, IfcRectangleHollowProfileDef, IfcEllipseProfileDef, IfcCircleHollowProfileDef, IfcIShapeProfileDef, IfcUShapeProfileDef, IfcCartesianTransformationOperator2D, IfcCartesianTransformationOperator2DnonUniform, IfcLShapeProfileDef, IfcCShapeProfileDef, IfcTShapeProfileDef, IfcZShapeProfileDef, IfcPolygonalBoundedHalfSpace, IfcSurface, IfcLine, IfcEllipse, IfcMaterialLayerSet, IfcSweptDiskSolid, IfcBlock, IfcCsgPrimitive3D, IfcSolidModel, IfcTessellatedFaceSet, IfcMaterialProfileSetUsage, IfcRevolvedAreaSolid, IfcFaceSurface } from "./ifc4_gen/index.js";
+import { IfcAxis2Placement2D, IfcAxis2Placement3D, IfcBooleanResult, IfcCartesianTransformationOperator3D, IfcCircleProfileDef, IfcColourRgb, IfcDirection, IfcExtrudedAreaSolid, IfcIndexedPolyCurve, IfcMappedItem, IfcNormalisedRatioMeasure, IfcObjectPlacement, IfcPolygonalFaceSet, IfcProduct, IfcProfileDef, IfcRepresentationItem, IfcSpecularExponent, IfcSpecularRoughness, IfcStyledItem, IfcSurfaceStyle, IfcBooleanClippingResult, IfcCompositeCurve, IfcPolyline, IfcTrimmedCurve, IfcCartesianPoint, IfcCurve, IfcCircle, IfcHalfSpaceSolid, IfcPlane, IfcShellBasedSurfaceModel, IfcFace, IfcFacetedBrep, IfcMaterialList, IfcMaterialLayerSetUsage, IfcMaterial, IfcRectangleProfileDef, IfcMaterialProfileSet, IfcMaterialConstituentSet, IfcMaterialConstituent, IfcMaterialProfile, IfcSIPrefix, IfcFaceBasedSurfaceModel, IfcConnectedFaceSet, IfcAdvancedBrep, IfcAdvancedFace, IfcBSplineCurve, IfcBSplineSurface, IfcBSplineSurfaceWithKnots, IfcRationalBSplineSurfaceWithKnots, IfcCylindricalSurface, IfcSurfaceOfRevolution, IfcSurfaceOfLinearExtrusion, IfcAxis1Placement, IfcRectangleHollowProfileDef, IfcEllipseProfileDef, IfcCircleHollowProfileDef, IfcIShapeProfileDef, IfcUShapeProfileDef, IfcCartesianTransformationOperator2D, IfcCartesianTransformationOperator2DnonUniform, IfcLShapeProfileDef, IfcCShapeProfileDef, IfcTShapeProfileDef, IfcZShapeProfileDef, IfcRelAggregates, IfcPolygonalBoundedHalfSpace, IfcSurface, IfcLine, IfcEllipse, IfcMaterialLayerSet, IfcSweptDiskSolid, IfcBlock, IfcCsgPrimitive3D, IfcSolidModel, IfcTessellatedFaceSet, IfcMaterialProfileSetUsage, IfcRevolvedAreaSolid, IfcFaceSurface } from "./ifc4_gen/index.js";
 import { IfcMaterialCache } from "./ifc_material_cache.js";
 import { IfcSceneBuilder } from "./ifc_scene_builder.js";
 import IfcStepModel from "./ifc_step_model.js";
@@ -929,6 +929,28 @@ export declare class IfcGeometryExtraction {
      */
     dumpGeometry(outputFilePath: string, geometry: GeometryObject): void;
     private extractionMapsPrepared_;
+    private aggregateTargetLocalIDs_?;
+    /**
+     * Local IDs of every IfcProduct that is a RelatedObject of any
+     * IfcRelAggregates — the exact set the rel-aggregates pass
+     * ({@link extractRelAggregateGeometry}) re-extracts with the relating
+     * object's master rel-voids.
+     *
+     * Both product walks SKIP these in their first pass and extract them
+     * only in the aggregates pass, for two invariants consumers rely on:
+     *   1. one scene instance per placement (the first-pass node plus the
+     *      re-extraction node used to coincide exactly — a duplicate draw
+     *      that z-fights), and
+     *   2. a part's canonical mesh content is never REPLACED after its
+     *      instances were already emitted — incremental consumers copy
+     *      content at delivery time, so a first-pass emission served the
+     *      uncut (or empty) content and the later replacement never
+     *      reached the screen (the ILNA missing-facades class).
+     *
+     * @return {Set<number>} product localIDs deferred to the aggregates
+     * pass; empty for models without IfcRelAggregates.
+     */
+    aggregateTargetLocalIDs(): Set<number>;
     /**
      * One-time extraction setup shared by the whole-model walk and the
      * per-product demand path (Phase B2): linear scaling factor and the
@@ -985,11 +1007,13 @@ export declare class IfcGeometryExtraction {
      * Extract one IfcRelAggregates' related products with the relating
      * object's ("master") rel-voids — the shared per-item body of the
      * whole-model walk's rel-aggregates loop and
-     * {@link extractRelAggregatesGeometry}.
+     * {@link extractRelAggregatesGeometry}. Public so the deferred pump
+     * can run the pass incrementally (batch-budgeted) instead of as one
+     * end-of-load stall.
      *
      * @param relAggregate The rel-aggregates relationship to process.
      */
-    private extractRelAggregateGeometry_;
+    extractRelAggregateGeometry(relAggregate: IfcRelAggregates): void;
     /**
      * Extract one product's geometry into the scene: placement, material /
      * style extraction, representation items (including mapped items) and