@ifc-lite/geometry 7.2.0 → 7.3.0

package/dist/rtc-rebase.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Moving already-loaded models onto the federation's RTC anchor (#4897).
+ *
+ * A model with small coordinates gets no `wasmRtcOffset` at load and is meshed
+ * raw. When a model that needs a real RTC anchor joins the federation, that
+ * anchor becomes the shared frame (`chooseSharedRtcOffset`, `world-frame.ts`),
+ * so every model meshed before it — and any model that finished loading in
+ * parallel against a different frame — has to move onto it, or it renders in a
+ * frame nothing else shares.
+ *
+ * This is a plain axis-aligned translation, not a CRS reprojection: both
+ * anchors are metres in the same IFC axes, so there is no rotation or unit
+ * conversion to apply.
+ *
+ * PRECISION. The translation goes into each mesh's f64 `origin`, never into its
+ * f32 `positions`. The delta is the anchor itself when a raw model moves, i.e.
+ * map-coordinate magnitude (Swiss LV95 ~2.6e6 m, UTM northings ~5e6 m), where
+ * one f32 ULP is 0.25-0.5 m: baking it into the vertices collapses millimetre
+ * detail to zero. Moving the origin keeps `positions` bit-identical and leaves
+ * the mesh in exactly the shape the wasm mesher produces when the anchor was
+ * already known at load (f64 origin = element centre minus the RTC, small f32
+ * local detail), so both load orders render from the same kind of data.
+ */
+import type { CoordinateInfo, Vec3 } from './coordinate-types.js';
+type Origin = [number, number, number];
+/**
+ * The render-frame (Y-up) translation that turns a mesh produced against
+ * `fromOffset` (IFC Z-up; absent means the raw frame) into one produced
+ * against `toOffset`. Render-frame coordinates are `world - offset`, so the
+ * mesh moves by `-delta`.
+ */
+export declare function rtcRebaseDeltaYup(fromOffset: Readonly<Vec3> | null | undefined, toOffset: Readonly<Vec3>): Vec3;
+/**
+ * A mesh origin moved by `-delta`, as a NEW array (origins may be shared
+ * between pieces, so never write through the old one). An absent origin means
+ * the positions are absolute render-frame values, which is origin `[0,0,0]`.
+ */
+export declare function rebaseOriginByRtcDelta(origin: Readonly<Origin> | null | undefined, delta: Readonly<Vec3>): Origin;
+/** {@link rtcRebaseDeltaYup} from the frame `info` records to `anchor`. */
+export declare function rtcRebaseDeltaFor(info: CoordinateInfo, anchor: Readonly<Vec3>): Vec3;
+/** Whether `info` is already drawn against `anchor` (same IFC offset, exactly). */
+export declare function isOnRtcAnchor(info: CoordinateInfo, anchor: Readonly<Vec3>): boolean;
+/**
+ * `info` re-expressed against `anchor`: both render-frame boxes move with the
+ * geometry, `wasmRtcOffset` records the new anchor, and `wasmRtcFrame` is
+ * replaced by the frame the geometry is now actually in. Keeping the old
+ * `wasmRtcFrame` would leave `needsShift: false` beside a set `wasmRtcOffset`,
+ * which the cache serialiser rejects and auxiliary parsers would trust.
+ *
+ * `originShift` is copied through: every render-frame value here is relative
+ * to `originShift + ifcToViewerAxes(wasmRtcOffset)` and only the second term
+ * changes, so the change in the total is exactly the RTC delta.
+ *
+ * Absolute-world fields are NOT in `CoordinateInfo` and are not touched by
+ * the caller either: `MeshData.geometryAabb` has the RTC folded back in and
+ * `MeshData.localToWorld` is the pre-RTC placement chain, both RTC-invariant.
+ */
+export declare function rebaseCoordinateInfoOntoRtcAnchor(info: CoordinateInfo, anchor: Readonly<Vec3>): CoordinateInfo;
+/** What {@link convergeGeometryOntoRtcAnchor} reads and rewrites per model. */
+export interface RtcRebaseGeometry {
+    coordinateInfo: CoordinateInfo;
+    meshes: ReadonlyArray<{
+        origin?: Origin;
+        geometryClass?: number;
+    }>;
+    /** Present on a `GeometryResult`; read only by {@link carriesGpuInstancedGeometry}. */
+    instancedGeometryAabbs?: ReadonlyMap<number, unknown> | null;
+    /** Streamed point clouds: GPU-resident, never meshed against an RTC anchor. */
+    pointClouds?: ReadonlyArray<unknown> | null;
+}
+/**
+ * Whether a model carries GPU-instanced geometry, which this module cannot
+ * move: instanced occurrences are a class-2 template plus per-occurrence
+ * transforms decoded straight into renderer-owned instance buffers, and the
+ * content-version rebuild keeps the templates of a model that is still
+ * present. Moving the flat meshes anyway would split one model across two
+ * frames. Two signals, because `instancedGeometryAabbs` is absent when
+ * hashing is off and a class-2 template can be absent when hashing is on.
+ */
+export declare function carriesGpuInstancedGeometry(geometry: RtcRebaseGeometry): boolean;
+export interface RtcConvergeResult<T> {
+    /** Geometries moved onto the anchor (need a GPU rebuild and a spatial reindex). */
+    moved: T[];
+    /** Geometries NOT on the anchor that could not be moved (GPU-instanced). */
+    refused: T[];
+}
+/**
+ * Move every geometry that is not yet drawn against `anchor` onto it, in
+ * place: each mesh's `origin` and the `CoordinateInfo` frame fields change,
+ * `positions` never do. Geometries already on the anchor and point clouds are
+ * left alone; GPU-instanced geometries are reported in `refused` and left
+ * untouched, so the caller can tell the user which models stay split.
+ *
+ * Idempotent: a second call with the same anchor moves nothing.
+ */
+export declare function convergeGeometryOntoRtcAnchor<T extends RtcRebaseGeometry>(geometries: readonly T[], anchor: Readonly<Vec3>, 
+/** Extra instancing evidence the caller holds outside the geometry (e.g.
+ *  shards already handed to the renderer); `true` refuses the geometry. */
+hasOtherInstancedGeometry?: (geometry: T) => boolean): RtcConvergeResult<T>;
+export {};
+//# sourceMappingURL=rtc-rebase.d.ts.map

package/dist/rtc-rebase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtc-rebase.d.ts","sourceRoot":"","sources":["../src/rtc-rebase.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAQ,cAAc,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAMxE,KAAK,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAEvC;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,SAAS,EAC7C,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,GACvB,IAAI,CAQN;AAMD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,CAGjH;AAaD,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAEpF;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,OAAO,CAEnF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iCAAiC,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,cAAc,CAS9G;AAED,+EAA+E;AAC/E,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,cAAc,CAAC;IAC/B,MAAM,EAAE,aAAa,CAAC;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnE,uFAAuF;IACvF,sBAAsB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7D,+EAA+E;IAC/E,WAAW,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;CAC7C;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAGhF;AAWD,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,mFAAmF;IACnF,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,4EAA4E;IAC5E,OAAO,EAAE,CAAC,EAAE,CAAC;CACd;AAED;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAAC,CAAC,SAAS,iBAAiB,EACvE,UAAU,EAAE,SAAS,CAAC,EAAE,EACxB,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC;AACtB;2EAC2E;AAC3E,yBAAyB,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,OAAO,GACnD,iBAAiB,CAAC,CAAC,CAAC,CAqBtB"}

package/dist/rtc-rebase.js

@@ -0,0 +1,135 @@
+/* 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/. */
+import { GEOM_CLASS_INSTANCED_TYPE, geometryClassOf } from './geometry-class.js';
+import { ifcToViewerAxes } from './world-frame.js';
+const ZERO = { x: 0, y: 0, z: 0 };
+/**
+ * The render-frame (Y-up) translation that turns a mesh produced against
+ * `fromOffset` (IFC Z-up; absent means the raw frame) into one produced
+ * against `toOffset`. Render-frame coordinates are `world - offset`, so the
+ * mesh moves by `-delta`.
+ */
+export function rtcRebaseDeltaYup(fromOffset, toOffset) {
+    const fromYup = ifcToViewerAxes(fromOffset ?? ZERO);
+    const toYup = ifcToViewerAxes(toOffset);
+    return {
+        x: toYup.x - fromYup.x,
+        y: toYup.y - fromYup.y,
+        z: toYup.z - fromYup.z,
+    };
+}
+function isZero(delta) {
+    return delta.x === 0 && delta.y === 0 && delta.z === 0;
+}
+/**
+ * A mesh origin moved by `-delta`, as a NEW array (origins may be shared
+ * between pieces, so never write through the old one). An absent origin means
+ * the positions are absolute render-frame values, which is origin `[0,0,0]`.
+ */
+export function rebaseOriginByRtcDelta(origin, delta) {
+    const base = origin ?? [0, 0, 0];
+    return [base[0] - delta.x, base[1] - delta.y, base[2] - delta.z];
+}
+/**
+ * Shifting the two corners is sound only because this is a pure translation:
+ * every corner moves by the same vector, so the minimum corner stays minimum.
+ */
+function shiftBounds(bounds, delta) {
+    return {
+        min: { x: bounds.min.x - delta.x, y: bounds.min.y - delta.y, z: bounds.min.z - delta.z },
+        max: { x: bounds.max.x - delta.x, y: bounds.max.y - delta.y, z: bounds.max.z - delta.z },
+    };
+}
+/** {@link rtcRebaseDeltaYup} from the frame `info` records to `anchor`. */
+export function rtcRebaseDeltaFor(info, anchor) {
+    return rtcRebaseDeltaYup(info.wasmRtcOffset, anchor);
+}
+/** Whether `info` is already drawn against `anchor` (same IFC offset, exactly). */
+export function isOnRtcAnchor(info, anchor) {
+    return isZero(rtcRebaseDeltaFor(info, anchor));
+}
+/**
+ * `info` re-expressed against `anchor`: both render-frame boxes move with the
+ * geometry, `wasmRtcOffset` records the new anchor, and `wasmRtcFrame` is
+ * replaced by the frame the geometry is now actually in. Keeping the old
+ * `wasmRtcFrame` would leave `needsShift: false` beside a set `wasmRtcOffset`,
+ * which the cache serialiser rejects and auxiliary parsers would trust.
+ *
+ * `originShift` is copied through: every render-frame value here is relative
+ * to `originShift + ifcToViewerAxes(wasmRtcOffset)` and only the second term
+ * changes, so the change in the total is exactly the RTC delta.
+ *
+ * Absolute-world fields are NOT in `CoordinateInfo` and are not touched by
+ * the caller either: `MeshData.geometryAabb` has the RTC folded back in and
+ * `MeshData.localToWorld` is the pre-RTC placement chain, both RTC-invariant.
+ */
+export function rebaseCoordinateInfoOntoRtcAnchor(info, anchor) {
+    const delta = rtcRebaseDeltaFor(info, anchor);
+    return {
+        ...info,
+        originalBounds: shiftBounds(info.originalBounds, delta),
+        shiftedBounds: shiftBounds(info.shiftedBounds, delta),
+        wasmRtcOffset: { ...anchor },
+        wasmRtcFrame: { x: anchor.x, y: anchor.y, z: anchor.z, needsShift: true },
+    };
+}
+/**
+ * Whether a model carries GPU-instanced geometry, which this module cannot
+ * move: instanced occurrences are a class-2 template plus per-occurrence
+ * transforms decoded straight into renderer-owned instance buffers, and the
+ * content-version rebuild keeps the templates of a model that is still
+ * present. Moving the flat meshes anyway would split one model across two
+ * frames. Two signals, because `instancedGeometryAabbs` is absent when
+ * hashing is off and a class-2 template can be absent when hashing is on.
+ */
+export function carriesGpuInstancedGeometry(geometry) {
+    if (geometry.instancedGeometryAabbs != null && geometry.instancedGeometryAabbs.size > 0)
+        return true;
+    return geometry.meshes.some((mesh) => geometryClassOf(mesh) === GEOM_CLASS_INSTANCED_TYPE);
+}
+/**
+ * Point clouds never take part in the RTC frame: the ingest registers them
+ * raw in every load order (the georeference alignment is their only frame
+ * move), so they are neither moved nor refused.
+ */
+function isPointCloudOnly(geometry) {
+    return (geometry.pointClouds?.length ?? 0) > 0 && geometry.meshes.length === 0;
+}
+/**
+ * Move every geometry that is not yet drawn against `anchor` onto it, in
+ * place: each mesh's `origin` and the `CoordinateInfo` frame fields change,
+ * `positions` never do. Geometries already on the anchor and point clouds are
+ * left alone; GPU-instanced geometries are reported in `refused` and left
+ * untouched, so the caller can tell the user which models stay split.
+ *
+ * Idempotent: a second call with the same anchor moves nothing.
+ */
+export function convergeGeometryOntoRtcAnchor(geometries, anchor, 
+/** Extra instancing evidence the caller holds outside the geometry (e.g.
+ *  shards already handed to the renderer); `true` refuses the geometry. */
+hasOtherInstancedGeometry) {
+    const moved = [];
+    const refused = [];
+    const seenMeshes = new Set();
+    for (const geometry of new Set(geometries)) {
+        if (isPointCloudOnly(geometry) || isOnRtcAnchor(geometry.coordinateInfo, anchor))
+            continue;
+        if (carriesGpuInstancedGeometry(geometry) || hasOtherInstancedGeometry?.(geometry) === true) {
+            refused.push(geometry);
+            continue;
+        }
+        const delta = rtcRebaseDeltaFor(geometry.coordinateInfo, anchor);
+        for (const mesh of geometry.meshes) {
+            // A MeshData object shared between two results must move once.
+            if (seenMeshes.has(mesh))
+                continue;
+            seenMeshes.add(mesh);
+            mesh.origin = rebaseOriginByRtcDelta(mesh.origin, delta);
+        }
+        geometry.coordinateInfo = rebaseCoordinateInfoOntoRtcAnchor(geometry.coordinateInfo, anchor);
+        moved.push(geometry);
+    }
+    return { moved, refused };
+}
+//# sourceMappingURL=rtc-rebase.js.map

package/dist/rtc-rebase.js.map

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

package/dist/types.d.ts

@@ -174,9 +174,12 @@ export interface MeshData {
         max: [number, number, number];
     };
     /** The resolved `IfcLocalPlacement` chain applied to this mesh (issue
-     *  #1474): row-major 4x4, 16 numbers, WebGL Y-up metres (same frame as
-     *  `positions`). Absent when not captured. All of one entity's `MeshData`
-     *  pieces share the same value (one placement per element). */
+     *  #1474): row-major 4x4, 16 numbers, WebGL Y-up axis convention — but its
+     *  translation is the placement's PRE-RTC absolute origin, not the frame
+     *  `positions` render in (`mesh_world.rs` assigns this before subtracting
+     *  the model's RTC offset). Do NOT shift it when RTC changes. Absent when
+     *  not captured. All of one entity's `MeshData` pieces share the same
+     *  value (one placement per element). */
     localToWorld?: number[];
 }
 /**

package/dist/types.d.ts.map

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

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAwW/D,8EAA8E;AAC9E,gCAAgC;AAChC,2EAA2E;AAC3E,8EAA8E;AAE9E,kFAAkF;AAClF,6EAA6E;AAC7E,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AA2W/D,8EAA8E;AAC9E,gCAAgC;AAChC,2EAA2E;AAC3E,8EAA8E;AAE9E,kFAAkF;AAClF,6EAA6E;AAC7E,cAAc,qBAAqB,CAAC"}

package/dist/world-frame.d.ts

@@ -42,8 +42,10 @@ export declare function totalYupOffset(info?: RenderFrameInfo | null): Vec3;
 export declare function renderFrameWorldOffset(info?: RenderFrameInfo | null): Vec3;
 /** A loaded model as far as the federation frame rule is concerned. */
 export interface FrameCandidate {
-    /** Load order; the earliest-loaded model owns the shared frame. */
+    /** Load order; the earliest-loaded anchored model owns the shared frame. */
     loadedAt: number;
+    /** A model still loading, or failed, has not been converged onto, so it cannot define the frame. */
+    loadState?: string;
     geometryResult?: {
         coordinateInfo?: CoordinateInfo | null;
     } | null;
@@ -51,12 +53,49 @@ export interface FrameCandidate {
 /**
  * The `CoordinateInfo` whose frame a set of loaded models is drawn in.
  *
- * A federation is aligned to the earliest-loaded model's RTC frame at load,
- * so that model's offsets ARE the scene's offsets; reading a later model's
- * would describe a frame nothing is drawn in. `fallback` covers a single
- * model loaded without a federation entry. Null when nothing has geometry.
+ * The rule is the anchor rule (#4897): the earliest-loaded model that HAS a
+ * `wasmRtcOffset` defines the frame; only when no model has one does the
+ * earliest-loaded model with any `coordinateInfo` answer (every model is then
+ * raw). The federation loader converges every other meshed model onto that
+ * same anchor after each load (`rtc-rebase.ts`, via the viewer's
+ * `federationRtcRebase.ts`), so in either load order this returns the frame the
+ * geometry is actually in. The earlier "earliest model with any
+ * `coordinateInfo`" rule reported a near-origin model's raw frame whenever it
+ * was loaded first, including for a raw point cloud, which never joins the
+ * RTC frame.
+ *
+ * Models whose `loadState` is `pending`, `streaming-geometry` or `error` are
+ * only considered when no settled model has a frame. The same set the
+ * convergence treats as settled: until such a load settles the other models
+ * have not been converged onto its anchor, so the settled frame stays the
+ * reported one.
+ *
+ * `fallback` covers a single model loaded without a federation entry. Null
+ * when nothing has geometry. The one case where the geometry does NOT all
+ * match is a GPU-instanced model the loader could not move; the viewer
+ * reports that to the user instead of leaving it silent.
  */
 export declare function federationFrameInfo(models: Iterable<FrameCandidate>, fallback?: {
     coordinateInfo?: CoordinateInfo | null;
 } | null): CoordinateInfo | null;
+/**
+ * The real `wasmRtcOffset` a single model carries, or `null` if it has none
+ * (still meshed raw). The single-candidate counterpart to
+ * {@link chooseSharedRtcOffset}: callers that need one specific model's own
+ * anchor — e.g. to decide whether it just introduced the federation's
+ * first real anchor — read it through here rather than destructuring
+ * `geometryResult.coordinateInfo.wasmRtcOffset` themselves.
+ */
+export declare function realRtcAnchorOf(candidate?: FrameCandidate | null): Readonly<Vec3> | null;
+/**
+ * The `sharedRtcOffset` a newly-loading model should be given: the earliest
+ * already-loaded model's `wasmRtcOffset`, or `undefined` when no
+ * already-loaded model has one yet (including when there is no earlier
+ * model at all) — the loading model is then free to detect its own.
+ *
+ * The same rule picks the anchor every already-loaded model is converged onto
+ * after a load (`rtc-rebase.ts`), so a model loaded before the first anchored
+ * one is moved onto it rather than left in the raw frame it was meshed in.
+ */
+export declare function chooseSharedRtcOffset(existingModels: Iterable<FrameCandidate>): Vec3 | undefined;
 //# sourceMappingURL=world-frame.d.ts.map

package/dist/world-frame.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"world-frame.d.ts","sourceRoot":"","sources":["../src/world-frame.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAIlE,gFAAgF;AAChF,MAAM,MAAM,eAAe,GAAG;IAC5B,WAAW,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACpC,aAAa,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACvC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAE3D;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAE3D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,CAAC,EAAE,eAAe,GAAG,IAAI,GAAG,IAAI,CAQlE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,CAAC,EAAE,eAAe,GAAG,IAAI,GAAG,IAAI,CAG1E;AAED,uEAAuE;AACvE,MAAM,WAAW,cAAc;IAC7B,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,cAAc,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;CACpE;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,EAChC,QAAQ,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,cAAc,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,GAC3D,cAAc,GAAG,IAAI,CAWvB"}
+{"version":3,"file":"world-frame.d.ts","sourceRoot":"","sources":["../src/world-frame.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAIlE,gFAAgF;AAChF,MAAM,MAAM,eAAe,GAAG;IAC5B,WAAW,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACpC,aAAa,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACvC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAE3D;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAE3D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,CAAC,EAAE,eAAe,GAAG,IAAI,GAAG,IAAI,CAQlE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,CAAC,EAAE,eAAe,GAAG,IAAI,GAAG,IAAI,CAG1E;AAED,uEAAuE;AACvE,MAAM,WAAW,cAAc;IAC7B,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAC;IACjB,oGAAoG;IACpG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,cAAc,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;CACpE;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,QAAQ,CAAC,cAAc,CAAC,EAChC,QAAQ,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,cAAc,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,GAC3D,cAAc,GAAG,IAAI,CAIvB;AAuBD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,SAAS,CAAC,EAAE,cAAc,GAAG,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAExF;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,cAAc,EAAE,QAAQ,CAAC,cAAc,CAAC,GAAG,IAAI,GAAG,SAAS,CAWhG"}

package/dist/world-frame.js

@@ -39,21 +39,85 @@ export function renderFrameWorldOffset(info) {
 /**
  * The `CoordinateInfo` whose frame a set of loaded models is drawn in.
  *
- * A federation is aligned to the earliest-loaded model's RTC frame at load,
- * so that model's offsets ARE the scene's offsets; reading a later model's
- * would describe a frame nothing is drawn in. `fallback` covers a single
- * model loaded without a federation entry. Null when nothing has geometry.
+ * The rule is the anchor rule (#4897): the earliest-loaded model that HAS a
+ * `wasmRtcOffset` defines the frame; only when no model has one does the
+ * earliest-loaded model with any `coordinateInfo` answer (every model is then
+ * raw). The federation loader converges every other meshed model onto that
+ * same anchor after each load (`rtc-rebase.ts`, via the viewer's
+ * `federationRtcRebase.ts`), so in either load order this returns the frame the
+ * geometry is actually in. The earlier "earliest model with any
+ * `coordinateInfo`" rule reported a near-origin model's raw frame whenever it
+ * was loaded first, including for a raw point cloud, which never joins the
+ * RTC frame.
+ *
+ * Models whose `loadState` is `pending`, `streaming-geometry` or `error` are
+ * only considered when no settled model has a frame. The same set the
+ * convergence treats as settled: until such a load settles the other models
+ * have not been converged onto its anchor, so the settled frame stays the
+ * reported one.
+ *
+ * `fallback` covers a single model loaded without a federation entry. Null
+ * when nothing has geometry. The one case where the geometry does NOT all
+ * match is a GPU-instanced model the loader could not move; the viewer
+ * reports that to the user instead of leaving it silent.
  */
 export function federationFrameInfo(models, fallback) {
+    const all = [...models];
+    const settled = all.filter((model) => model.loadState !== 'pending' && model.loadState !== 'streaming-geometry' && model.loadState !== 'error');
+    return frameOf(settled) ?? frameOf(all) ?? fallback?.coordinateInfo ?? null;
+}
+/** The anchor rule over one candidate set: earliest anchored, else earliest with a frame. */
+function frameOf(models) {
     let earliest = Infinity;
+    let earliestAnchored = Infinity;
     let info = null;
+    let anchoredInfo = null;
     for (const model of models) {
         const candidate = model.geometryResult?.coordinateInfo;
-        if (candidate && model.loadedAt < earliest) {
+        if (!candidate)
+            continue;
+        if (model.loadedAt < earliest) {
             earliest = model.loadedAt;
             info = candidate;
         }
+        if (candidate.wasmRtcOffset != null && model.loadedAt < earliestAnchored) {
+            earliestAnchored = model.loadedAt;
+            anchoredInfo = candidate;
+        }
+    }
+    return anchoredInfo ?? info;
+}
+/**
+ * The real `wasmRtcOffset` a single model carries, or `null` if it has none
+ * (still meshed raw). The single-candidate counterpart to
+ * {@link chooseSharedRtcOffset}: callers that need one specific model's own
+ * anchor — e.g. to decide whether it just introduced the federation's
+ * first real anchor — read it through here rather than destructuring
+ * `geometryResult.coordinateInfo.wasmRtcOffset` themselves.
+ */
+export function realRtcAnchorOf(candidate) {
+    return candidate?.geometryResult?.coordinateInfo?.wasmRtcOffset ?? null;
+}
+/**
+ * The `sharedRtcOffset` a newly-loading model should be given: the earliest
+ * already-loaded model's `wasmRtcOffset`, or `undefined` when no
+ * already-loaded model has one yet (including when there is no earlier
+ * model at all) — the loading model is then free to detect its own.
+ *
+ * The same rule picks the anchor every already-loaded model is converged onto
+ * after a load (`rtc-rebase.ts`), so a model loaded before the first anchored
+ * one is moved onto it rather than left in the raw frame it was meshed in.
+ */
+export function chooseSharedRtcOffset(existingModels) {
+    let earliestOffsetAt = Infinity;
+    let earliestOffset = null;
+    for (const model of existingModels) {
+        const offset = model.geometryResult?.coordinateInfo?.wasmRtcOffset;
+        if (offset != null && model.loadedAt < earliestOffsetAt) {
+            earliestOffsetAt = model.loadedAt;
+            earliestOffset = offset;
+        }
     }
-    return info ?? fallback?.coordinateInfo ?? null;
+    return earliestOffset ? { ...earliestOffset } : undefined;
 }
 //# sourceMappingURL=world-frame.js.map

package/dist/world-frame.js.map

@@ -1 +1 @@
-{"version":3,"file":"world-frame.js","sourceRoot":"","sources":["../src/world-frame.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAsB/D,MAAM,IAAI,GAAS,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;AAQxC;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAqB;IACnD,OAAO,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;AACpD,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,eAAe,CAAC,KAAqB;IACnD,OAAO,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;AACpD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAA6B;IAC1D,MAAM,KAAK,GAAG,IAAI,EAAE,WAAW,IAAI,IAAI,CAAC;IACxC,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,EAAE,aAAa,IAAI,IAAI,CAAC,CAAC;IAC5D,OAAO;QACL,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC;QACrB,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC;QACrB,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC;KACtB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAA6B;IAClE,MAAM,MAAM,GAAG,eAAe,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;IACrD,OAAO,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;AAC/D,CAAC;AASD;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAgC,EAChC,QAA4D;IAE5D,IAAI,QAAQ,GAAG,QAAQ,CAAC;IACxB,IAAI,IAAI,GAA0B,IAAI,CAAC;IACvC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,KAAK,CAAC,cAAc,EAAE,cAAc,CAAC;QACvD,IAAI,SAAS,IAAI,KAAK,CAAC,QAAQ,GAAG,QAAQ,EAAE,CAAC;YAC3C,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;YAC1B,IAAI,GAAG,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,IAAI,QAAQ,EAAE,cAAc,IAAI,IAAI,CAAC;AAClD,CAAC"}
+{"version":3,"file":"world-frame.js","sourceRoot":"","sources":["../src/world-frame.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ifc-lite/geometry",
-  "version": "7.2.0",
+  "version": "7.3.0",
   "description": "Geometry processing bridge for IFC-Lite - exact-arithmetic CSG, streamed across workers",
   "type": "module",
   "main": "./dist/index.js",
@@ -20,10 +20,15 @@
       "types": "./dist/world-frame.d.ts",
       "import": "./dist/world-frame.js",
       "default": "./dist/world-frame.js"
+    },
+    "./rtc-rebase": {
+      "types": "./dist/rtc-rebase.d.ts",
+      "import": "./dist/rtc-rebase.js",
+      "default": "./dist/rtc-rebase.js"
     }
   },
   "dependencies": {
-    "@ifc-lite/data": "^4.4.0",
+    "@ifc-lite/data": "^4.5.0",
     "@ifc-lite/wasm": "^9.1.0",
     "@ifc-lite/wasm-lifecycle": "^0.2.0"
   },