@ifc-lite/renderer 1.37.0 → 1.38.1

package/dist/visibility-epoch.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Content-based change tracking for the per-frame hide/isolate sets.
+ *
+ * The renderer caches per-batch visibility keyed by the version this tracker
+ * produces, so correctness demands the version bumps EXACTLY when the
+ * effective filter changes:
+ * - Callers may mutate the SAME Set object in place between frames (the
+ *   per-mesh filters read the live set every frame, so a reference-compare
+ *   epoch would silently diverge from them) — content comparison against a
+ *   snapshot catches this.
+ * - Callers may pass a FRESH Set with identical content every frame (zustand
+ *   slices rebuild the Set on every action) — content comparison avoids a
+ *   needless cache rebuild that a reference compare would force.
+ */
+export declare class VisibilityEpochTracker {
+    private version;
+    private hiddenSnapshot;
+    private isolatedSnapshot;
+    /**
+     * Feed the sets passed to render(); returns the current version, bumped when
+     * the content changed since the previous call. An EMPTY hidden set is
+     * equivalent to no hidden filter; an EMPTY isolated set is NOT equivalent to
+     * null (it isolates nothing, i.e. hides everything). Cost is
+     * O(|hidden| + |isolated|) membership checks per call — strictly below the
+     * O(scene elements) per-batch scan this version key lets the renderer skip.
+     */
+    update(hiddenIds: ReadonlySet<number> | null | undefined, isolatedIds: ReadonlySet<number> | null | undefined): number;
+    getVersion(): number;
+}
+//# sourceMappingURL=visibility-epoch.d.ts.map

package/dist/visibility-epoch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visibility-epoch.d.ts","sourceRoot":"","sources":["../src/visibility-epoch.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;GAaG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,OAAO,CAAK;IAIpB,OAAO,CAAC,cAAc,CAAoC;IAC1D,OAAO,CAAC,gBAAgB,CAAoC;IAE5D;;;;;;;OAOG;IACH,MAAM,CACJ,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,EACjD,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,GAClD,MAAM;IAaT,UAAU,IAAI,MAAM;CAGrB"}

package/dist/visibility-epoch.js

@@ -0,0 +1,64 @@
+/* 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/. */
+/**
+ * Content-based change tracking for the per-frame hide/isolate sets.
+ *
+ * The renderer caches per-batch visibility keyed by the version this tracker
+ * produces, so correctness demands the version bumps EXACTLY when the
+ * effective filter changes:
+ * - Callers may mutate the SAME Set object in place between frames (the
+ *   per-mesh filters read the live set every frame, so a reference-compare
+ *   epoch would silently diverge from them) — content comparison against a
+ *   snapshot catches this.
+ * - Callers may pass a FRESH Set with identical content every frame (zustand
+ *   slices rebuild the Set on every action) — content comparison avoids a
+ *   needless cache rebuild that a reference compare would force.
+ */
+export class VisibilityEpochTracker {
+    version = 0;
+    // Snapshots (copies) of the last-seen effective sets. Copies, not the
+    // caller's references — an in-place mutation of the caller's Set must
+    // compare against what we saw LAST frame, not against itself.
+    hiddenSnapshot = null;
+    isolatedSnapshot = null;
+    /**
+     * Feed the sets passed to render(); returns the current version, bumped when
+     * the content changed since the previous call. An EMPTY hidden set is
+     * equivalent to no hidden filter; an EMPTY isolated set is NOT equivalent to
+     * null (it isolates nothing, i.e. hides everything). Cost is
+     * O(|hidden| + |isolated|) membership checks per call — strictly below the
+     * O(scene elements) per-batch scan this version key lets the renderer skip.
+     */
+    update(hiddenIds, isolatedIds) {
+        const hidden = hiddenIds && hiddenIds.size > 0 ? hiddenIds : null;
+        const isolated = isolatedIds ?? null;
+        const hiddenChanged = !contentEquals(hidden, this.hiddenSnapshot);
+        const isolatedChanged = !contentEquals(isolated, this.isolatedSnapshot);
+        if (hiddenChanged || isolatedChanged) {
+            this.version++;
+            if (hiddenChanged)
+                this.hiddenSnapshot = hidden ? new Set(hidden) : null;
+            if (isolatedChanged)
+                this.isolatedSnapshot = isolated ? new Set(isolated) : null;
+        }
+        return this.version;
+    }
+    getVersion() {
+        return this.version;
+    }
+}
+function contentEquals(live, snapshot) {
+    if (live === snapshot)
+        return true; // covers null === null
+    if (live === null || snapshot === null)
+        return false;
+    if (live.size !== snapshot.size)
+        return false;
+    for (const id of live) {
+        if (!snapshot.has(id))
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=visibility-epoch.js.map

package/dist/visibility-epoch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visibility-epoch.js","sourceRoot":"","sources":["../src/visibility-epoch.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,sBAAsB;IACzB,OAAO,GAAG,CAAC,CAAC;IACpB,sEAAsE;IACtE,sEAAsE;IACtE,8DAA8D;IACtD,cAAc,GAA+B,IAAI,CAAC;IAClD,gBAAgB,GAA+B,IAAI,CAAC;IAE5D;;;;;;;OAOG;IACH,MAAM,CACJ,SAAiD,EACjD,WAAmD;QAEnD,MAAM,MAAM,GAAG,SAAS,IAAI,SAAS,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;QAClE,MAAM,QAAQ,GAAG,WAAW,IAAI,IAAI,CAAC;QACrC,MAAM,aAAa,GAAG,CAAC,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;QAClE,MAAM,eAAe,GAAG,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACxE,IAAI,aAAa,IAAI,eAAe,EAAE,CAAC;YACrC,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,IAAI,aAAa;gBAAE,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACzE,IAAI,eAAe;gBAAE,IAAI,CAAC,gBAAgB,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACnF,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CACF;AAED,SAAS,aAAa,CACpB,IAAgC,EAChC,QAAoC;IAEpC,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,CAAC,uBAAuB;IAC3D,IAAI,IAAI,KAAK,IAAI,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IACrD,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9C,KAAK,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC;QACtB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,OAAO,KAAK,CAAC;IACtC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ifc-lite/renderer",
-  "version": "1.37.0",
+  "version": "1.38.1",
   "description": "WebGPU renderer for IFC-Lite",
   "type": "module",
   "main": "./dist/index.js",
@@ -13,12 +13,12 @@
     }
   },
   "dependencies": {
-    "@ifc-lite/spatial": "^1.14.12",
-    "@ifc-lite/geometry": "^3.2.0"
+    "@ifc-lite/geometry": "^3.2.1",
+    "@ifc-lite/spatial": "^1.14.12"
   },
   "devDependencies": {
     "@webgpu/types": "^0.1.71",
-    "tsx": "^4.23.0",
+    "tsx": "^4.23.1",
     "typescript": "^6.0.3"
   },
   "license": "MPL-2.0",