bruce-cesium 7.4.4 → 7.4.6

package/dist/bruce-cesium.umd.js

@@ -1516,6 +1516,7 @@
      * @returns
      */
     function isFeatureAlive(viewer, feature) {
+        var _a, _b;
         if (!(viewer === null || viewer === void 0 ? void 0 : viewer.scene) || viewer.isDestroyed()) {
             return false;
         }
@@ -1526,6 +1527,10 @@
         if (cTileset.isDestroyed() || !viewer.scene.primitives.contains(cTileset)) {
             return false;
         }
+        // A tile unloads its content while the tileset lives on, and the feature's colour is then unreadable.
+        if (feature._bruceUnloaded || ((_b = (_a = feature.content) === null || _a === void 0 ? void 0 : _a.isDestroyed) === null || _b === void 0 ? void 0 : _b.call(_a))) {
+            return false;
+        }
         return true;
     }
     let _lastMark = 0;
@@ -1715,7 +1720,17 @@
                     removal = null;
                     return;
                 }
-                if (!assertColorMark(mark, feature.color)) {
+                // A throw here is inside Cesium's frame and stops rendering, so an unreadable feature ends the animation.
+                let current;
+                try {
+                    current = feature.color;
+                }
+                catch (e) {
+                    removal === null || removal === void 0 ? void 0 : removal();
+                    removal = null;
+                    return;
+                }
+                if (!assertColorMark(mark, current)) {
                     removal === null || removal === void 0 ? void 0 : removal();
                     removal = null;
                     onDone === null || onDone === void 0 ? void 0 : onDone();
@@ -2934,6 +2949,7 @@
      * @returns
      */
     function isAlive(viewer, visual) {
+        var _a, _b;
         if (!(viewer === null || viewer === void 0 ? void 0 : viewer.scene) || viewer.isDestroyed()) {
             return false;
         }
@@ -2951,6 +2967,10 @@
             if (cTileset.isDestroyed() || !viewer.scene.primitives.contains(cTileset)) {
                 return false;
             }
+            // Its tile unloaded, so reading or writing the feature's colour throws.
+            if (visual._bruceUnloaded || ((_b = (_a = visual.content) === null || _a === void 0 ? void 0 : _a.isDestroyed) === null || _b === void 0 ? void 0 : _b.call(_a))) {
+                return false;
+            }
             return true;
         }
         return false;
@@ -5789,6 +5809,8 @@
                 this.element = document.createElement("div");
                 this.coordinates = { x: 0, y: 0, scaleX: 1, scaleY: 1 };
                 this.participants = new Set();
+                // Participants whose failure has been logged, so a label that throws every frame logs once.
+                this.failed = new WeakSet();
                 this.placementMemory = new PlacementMemory();
                 this.forwardingWheel = false;
                 this.pendingDrag = null;
@@ -5989,15 +6011,35 @@
                         x: (pointer.x - rect.left) * this.viewer.canvas.clientWidth / rect.width,
                         y: (pointer.y - rect.top) * this.viewer.canvas.clientHeight / rect.height
                     } : undefined;
+                // This runs inside Cesium's frame, where one throwing label would stop rendering for the whole scene.
                 const projected = new Map();
                 for (const participant of this.participants) {
-                    projected.set(participant, participant.project());
+                    let frame = null;
+                    try {
+                        frame = participant.project();
+                    }
+                    catch (e) {
+                        this.logFailure(participant, e);
+                    }
+                    projected.set(participant, frame);
                 }
                 const placements = new Map(Layout(Array.from(projected.values()).filter(Boolean), this.placementMemory).map(item => [item.frame.id, item]));
                 for (const [participant, frame] of projected) {
-                    participant.apply(frame ? placements.get(frame.id) : undefined);
+                    try {
+                        participant.apply(frame ? placements.get(frame.id) : undefined);
+                    }
+                    catch (e) {
+                        this.logFailure(participant, e);
+                    }
                 }
             }
+            logFailure(participant, error) {
+                if (this.failed.has(participant)) {
+                    return;
+                }
+                this.failed.add(participant);
+                console.error("EntityLabel: a label failed to update and is skipped this frame.", error);
+            }
         }
         let nextLabelId = 0;
         class Label {
@@ -6733,8 +6775,10 @@
                     const relative = Cesium.Cartesian3.subtract(this._pos3d, cameraPosition, new Cesium.Cartesian3());
                     const depth = Cesium.Cartesian3.dot(relative, camera.directionWC || camera.direction);
                     const distance = Cesium.Cartesian3.magnitude(relative);
+                    // If we're labelling from a temp label (mouse hover) don't drive opacity by cam distance.
+                    const hoverOnly = this.Transient && !this.Persistent;
                     if (!Number.isFinite(distance) || depth <= 0 || distance < ((_c = this.options.near) !== null && _c !== void 0 ? _c : 0) ||
-                        distance > ((_d = this.options.far) !== null && _d !== void 0 ? _d : Infinity) || (!this.prePositioned && distance >= MAX_DISTANCE)) {
+                        distance > ((_d = this.options.far) !== null && _d !== void 0 ? _d : Infinity) || (!this.prePositioned && !hoverOnly && distance >= MAX_DISTANCE)) {
                         return null;
                     }
                     const transforms = Cesium.SceneTransforms;
@@ -6863,7 +6907,7 @@
                         return null;
                     }
                     const state = (_p = this.visualRegister) === null || _p === void 0 ? void 0 : _p.GetState({ entityId: (_q = this.rego) === null || _q === void 0 ? void 0 : _q.entityId, menuItemId: (_r = this.rego) === null || _r === void 0 ? void 0 : _r.menuItemId });
-                    const opacity = this.prePositioned || MAX_DISTANCE === Infinity ? 1 : 1 - distance / MAX_DISTANCE;
+                    const opacity = this.prePositioned || hoverOnly || MAX_DISTANCE === Infinity ? 1 : 1 - distance / MAX_DISTANCE;
                     return {
                         canFlip: leader && presentation !== "icon", hasLeader: leader,
                         textWrapped: ((sourceNaturalText === null || sourceNaturalText === void 0 ? void 0 : sourceNaturalText.offsetWidth) || 0) > TEXT_MAX_WIDTH,
@@ -9265,6 +9309,7 @@
     })(exports.VisualRegisterCuller || (exports.VisualRegisterCuller = {}));
 
     function isTilesetFeatureAlive(visual) {
+        var _a, _b;
         const cTileset = visual === null || visual === void 0 ? void 0 : visual.tileset;
         if (!cTileset) {
             return false;
@@ -9275,8 +9320,32 @@
         else if (visual.primitive && visual.primitive.isDestroyed()) {
             return false;
         }
+        // A tile unloads its content while the tileset lives on, and every read through the feature then throws.
+        else if (visual._bruceUnloaded || ((_b = (_a = visual.content) === null || _a === void 0 ? void 0 : _a.isDestroyed) === null || _b === void 0 ? void 0 : _b.call(_a))) {
+            return false;
+        }
         return true;
     }
+    /*
+     * Returns if a visual is currently shown, reading a tileset feature only while its tile is loaded.
+     */
+    function isVisualShown(visual) {
+        if (!visual) {
+            return true;
+        }
+        if (visual instanceof Cesium.Cesium3DTileFeature) {
+            if (!isTilesetFeatureAlive(visual)) {
+                return false;
+            }
+            try {
+                return visual.show !== false;
+            }
+            catch (e) {
+                return false;
+            }
+        }
+        return visual.show !== false;
+    }
     /**
      * Returns if a given visual is alive and in the scene.
      * @param viewer
@@ -9284,6 +9353,7 @@
      * @returns
      */
     function isAlive$1(viewer, visual) {
+        var _a, _b;
         if (!(viewer === null || viewer === void 0 ? void 0 : viewer.scene) || viewer.isDestroyed()) {
             return false;
         }
@@ -9304,6 +9374,10 @@
             else if (visual.primitive && visual.primitive.isDestroyed()) {
                 return false;
             }
+            // Its tile unloaded, so every read through the feature throws.
+            else if (visual._bruceUnloaded || ((_b = (_a = visual.content) === null || _a === void 0 ? void 0 : _a.isDestroyed) === null || _b === void 0 ? void 0 : _b.call(_a))) {
+                return false;
+            }
             return true;
         }
         return false;
@@ -9762,6 +9836,13 @@
                 // Adding is asynchronous, so ordering has to wait until it is actually in the collection.
                 Promise.resolve(this.viewer.dataSources.add(source))
                     .then(() => {
+                    // Released or disposed before the add landed, when the remove found nothing to take out.
+                    if (this.menuItemSources.get(menuItemId) !== record) {
+                        if (!this.viewer.isDestroyed() && this.viewer.dataSources.contains(source)) {
+                            this.viewer.dataSources.remove(source, true);
+                        }
+                        return;
+                    }
                     record.added = true;
                     this.applySourceOrder();
                 })
@@ -9798,7 +9879,9 @@
                 if (this.disposed || !this.sourceOrderDirty || !((_a = this.viewer) === null || _a === void 0 ? void 0 : _a.dataSources)) {
                     return;
                 }
-                const records = Array.from(this.menuItemSources.values()).filter(x => x.added);
+                // raiseToTop throws for a source the collection does not hold.
+                const dataSources = this.viewer.dataSources;
+                const records = Array.from(this.menuItemSources.values()).filter(x => x.added && dataSources.contains(x.source));
                 if (records.length < 2) {
                     // Nothing to order against yet, so leave the flag set for when there is.
                     return;
@@ -9808,7 +9891,7 @@
                 records.sort((a, b) => a.maxZIndex - b.maxZIndex);
                 for (const record of records) {
                     try {
-                        this.viewer.dataSources.raiseToTop(record.source);
+                        dataSources.raiseToTop(record.source);
                     }
                     catch (e) {
                         console.error(e);
@@ -12148,7 +12231,7 @@
                 return (hover === null || hover === void 0 ? void 0 : hover.entityId) === entityId && (hover.menuItemId == null || hover.menuItemId === menuItemId) ? hover.position : undefined;
             }
             SyncLabelHover() {
-                var _a, _b, _c, _d;
+                var _a, _b, _c;
                 const hover = this.labelHover;
                 if (!hover || this.disposed) {
                     return;
@@ -12173,7 +12256,7 @@
                 }
                 const existing = rego && exports.EntityLabel.GetLabel({ rego });
                 const state = this.GetState(hover);
-                if ((!rego && !group) || state.hidden || ((_b = rego === null || rego === void 0 ? void 0 : rego.visual) === null || _b === void 0 ? void 0 : _b.show) === false ||
+                if ((!rego && !group) || state.hidden || ((rego === null || rego === void 0 ? void 0 : rego.visual) && !isVisualShown(rego.visual)) ||
                     (this.GetIsIsolatedAny() && !state.isolated && this.GetIsolationOpacity() == null) ||
                     (existing && existing !== this.hoverLabel && existing.HasText) ||
                     (group && group.options.presentation !== "icon")) {
@@ -12185,7 +12268,7 @@
                     return;
                 }
                 // Query-only icon groups have coordinates but no registered scene visual to attach to.
-                if (!rego && group && [group.item.longitude, group.item.latitude, (_c = group.item.altitude) !== null && _c !== void 0 ? _c : 0].every(Number.isFinite)) {
+                if (!rego && group && [group.item.longitude, group.item.latitude, (_b = group.item.altitude) !== null && _b !== void 0 ? _b : 0].every(Number.isFinite)) {
                     rego = {
                         entityId: hover.entityId,
                         menuItemId: hover.menuItemId,
@@ -12207,7 +12290,7 @@
                     rego,
                     viewer: this.viewer,
                     visualRegister: this,
-                    api: (_d = this.ApiGetters) === null || _d === void 0 ? void 0 : _d.GetBruceApi(),
+                    api: (_c = this.ApiGetters) === null || _c === void 0 ? void 0 : _c.GetBruceApi(),
                     persistent: false,
                     transient: true,
                     hoverRingState: this.hoverRingState,
@@ -12217,10 +12300,10 @@
                         selectOnClick: false
                     },
                     visible: () => {
-                        var _a, _b;
+                        var _a;
                         const current = this.GetState(hover);
-                        return (!this.disposed && !current.hidden && ((_a = rego.visual) === null || _a === void 0 ? void 0 : _a.show) !== false &&
-                            Boolean(this.GetRego(hover) || ((_b = this.labelGroups) === null || _b === void 0 ? void 0 : _b.Has(hover.entityId, hover.menuItemId))) &&
+                        return (!this.disposed && !current.hidden && isVisualShown(rego.visual) &&
+                            Boolean(this.GetRego(hover) || ((_a = this.labelGroups) === null || _a === void 0 ? void 0 : _a.Has(hover.entityId, hover.menuItemId))) &&
                             (!this.GetIsIsolatedAny() || current.isolated || this.GetIsolationOpacity() != null));
                     }
                 };
@@ -14835,12 +14918,20 @@
                     strokeWidth: lineWidthPx,
                     clampToGround: lineWidthPx <= 0 && polygonsClamped
                 });
-                this.viewer.dataSources.add(source);
-                this.sources.push(source);
-                if (this.disposed) {
-                    this.doDispose();
+                // Dispose already cleared what was added before this, and this one has not been added.
+                if (this.disposed || this.viewer.isDestroyed()) {
                     return;
                 }
+                const viewer = this.viewer;
+                this.sources.push(source);
+                // The add lands asynchronously, so a dispose in between removes nothing and would orphan the source.
+                Promise.resolve(viewer.dataSources.add(source)).then(() => {
+                    if (this.disposed && !viewer.isDestroyed() && viewer.dataSources.contains(source)) {
+                        viewer.dataSources.remove(source);
+                    }
+                }).catch((e) => {
+                    console.error(e);
+                });
                 const groups = [];
                 /**
                  * Applies individual styling to a rendered entity.
@@ -15876,12 +15967,20 @@
                     strokeWidth: lineWidthPx,
                     clampToGround: lineWidthPx <= 0 && polygonsClamped
                 });
-                this.viewer.dataSources.add(source);
-                this.sources.push(source);
-                if (this.disposed) {
-                    this.doDispose();
+                // Dispose already cleared what was added before this, and this one has not been added.
+                if (this.disposed || this.viewer.isDestroyed()) {
                     return;
                 }
+                const viewer = this.viewer;
+                this.sources.push(source);
+                // The add lands asynchronously, so a dispose in between removes nothing and would orphan the source.
+                Promise.resolve(viewer.dataSources.add(source)).then(() => {
+                    if (this.disposed && !viewer.isDestroyed() && viewer.dataSources.contains(source)) {
+                        viewer.dataSources.remove(source);
+                    }
+                }).catch((e) => {
+                    console.error(e);
+                });
                 const groups = [];
                 /**
                  * Applies individual styling to a rendered entity.
@@ -19561,7 +19660,7 @@
                     });
                     this.tileUnloadRemoval = cTileset.tileUnload.addEventListener((tile) => {
                         try {
-                            this.queueTile(tile, false);
+                            this.unloadTile(tile);
                         }
                         catch (e) {
                             console.error(e);
@@ -19745,7 +19844,7 @@
                 });
                 this.tileUnloadRemoval = this.cTileset.tileUnload.addEventListener((tile) => {
                     try {
-                        this.queueTile(tile, false);
+                        this.unloadTile(tile);
                     }
                     catch (e) {
                         console.error(e);
@@ -19810,6 +19909,35 @@
                 }
                 this.pingFeatureQueue();
             }
+            /*
+             * Removes a tile's regos and marks its features dead, while the tile's content can still be read.
+             */
+            unloadTile(tile) {
+                const content = tile === null || tile === void 0 ? void 0 : tile.content;
+                if (!content) {
+                    return;
+                }
+                const features = [];
+                for (let i = 0; i < content.featuresLength; i++) {
+                    const feature = content.getFeature(i);
+                    // Drops a load still queued for it, the batch skips anything marked.
+                    this.featureQueueStates.delete(feature);
+                    feature._bruceUnloaded = true;
+                    features.push(feature);
+                }
+                if (!features.length) {
+                    return;
+                }
+                const { removedEntityIds } = this.visualsManager.RemoveRegosByVisuals({
+                    visuals: features,
+                    requestRender: false,
+                    menuItemId: this.item.id,
+                    doRemove: false
+                });
+                for (const entityId of removedEntityIds) {
+                    delete this.loadedCesiumEntities[entityId];
+                }
+            }
             /**
              * Pings the feature queue to process any queued features.
              * Does nothing if we're already processing.
@@ -19826,7 +19954,7 @@
                         return;
                     }
                     this.processFeatureQueueBatch();
-                    if (!this.featureQueue) {
+                    if (!this.featureQueue.length) {
                         clearInterval(this.featureQueueInterval);
                         this.featureQueueInterval = null;
                     }
@@ -19858,6 +19986,10 @@
                 const regosToStyle = new Map();
                 const featuresToRemove = [];
                 for (const feature of batch) {
+                    // Its tile unloaded while it waited, unloadTile already removed whatever it registered.
+                    if (feature._bruceUnloaded) {
+                        continue;
+                    }
                     const load = this.featureQueueStates.get(feature);
                     this.featureQueueStates.delete(feature);
                     if (!load) {
@@ -23025,6 +23157,7 @@
                 this.processingQueue = 0;
                 this._osmIdToBruceId = {};
                 this.tileLoadRemoval = null;
+                this.tileUnloadRemoval = null;
                 const { viewer, register: visualsManager, getters: apiGetter, monitor, item } = params;
                 this.viewer = viewer;
                 this.getters = apiGetter;
@@ -23033,7 +23166,7 @@
                 this.monitor = monitor;
             }
             Dispose() {
-                var _a;
+                var _a, _b;
                 if (this.disposed) {
                     return;
                 }
@@ -23041,6 +23174,8 @@
                 clearInterval(this.queueCheckInterval);
                 (_a = this.tileLoadRemoval) === null || _a === void 0 ? void 0 : _a.call(this);
                 this.tileLoadRemoval = null;
+                (_b = this.tileUnloadRemoval) === null || _b === void 0 ? void 0 : _b.call(this);
+                this.tileUnloadRemoval = null;
                 if (this.cTileset) {
                     const viewer = this.viewer;
                     if (!(viewer === null || viewer === void 0 ? void 0 : viewer.isDestroyed()) && this.viewer.scene.primitives.contains(this.cTileset)) {
@@ -23136,6 +23271,14 @@
                                     console.error(e);
                                 }
                             });
+                            this.tileUnloadRemoval = this.cTileset.tileUnload.addEventListener((tile) => {
+                                try {
+                                    this.unloadTile(tile);
+                                }
+                                catch (e) {
+                                    console.error(e);
+                                }
+                            });
                             this.queueCheckInterval = setInterval(() => {
                                 if (this.featureQueue.length > 0) {
                                     this.processQueue();
@@ -23172,6 +23315,34 @@
                     this.processQueue();
                 }
             }
+            /*
+             * Removes a tile's regos and marks its features dead, while the tile's content can still be read.
+             */
+            unloadTile(tile) {
+                const content = tile === null || tile === void 0 ? void 0 : tile.content;
+                if (!content) {
+                    return;
+                }
+                const features = [];
+                for (let i = 0; i < content.featuresLength; i++) {
+                    const feature = content.getFeature(i);
+                    feature._bruceUnloaded = true;
+                    features.push(feature);
+                }
+                if (!features.length) {
+                    return;
+                }
+                this.featureQueue = this.featureQueue.filter(x => !x._bruceUnloaded);
+                const { removedEntityIds } = this.visualsManager.RemoveRegosByVisuals({
+                    visuals: features,
+                    requestRender: false,
+                    menuItemId: this.item.id,
+                    doRemove: false
+                });
+                for (const entityId of removedEntityIds) {
+                    delete this._loadedCesiumEntities[entityId];
+                }
+            }
             async processQueue() {
                 if (this.processingQueue >= MAX_BATCHES) {
                     return;
@@ -23304,6 +23475,10 @@
                         bruceId = BModels.ObjectUtils.UId();
                     }
                     const feature = featureMap[i];
+                    // Its tile unloaded while the ID lookup was in flight.
+                    if (feature._bruceUnloaded) {
+                        continue;
+                    }
                     if (this.item.ghostLoading == true) {
                         feature.color = feature._orgColor;
                     }
@@ -23395,7 +23570,7 @@
                 return `osm:${sourceId}:${entityTypeId}`;
             }
             PrepareHandoff() {
-                var _a;
+                var _a, _b;
                 if (this.disposed || !this.cTileset || this.cTileset.isDestroyed()) {
                     return null;
                 }
@@ -23403,6 +23578,8 @@
                 this.queueCheckInterval = null;
                 (_a = this.tileLoadRemoval) === null || _a === void 0 ? void 0 : _a.call(this);
                 this.tileLoadRemoval = null;
+                (_b = this.tileUnloadRemoval) === null || _b === void 0 ? void 0 : _b.call(this);
+                this.tileUnloadRemoval = null;
                 const payload = {
                     cTileset: this.cTileset,
                     loadedCesiumEntities: this._loadedCesiumEntities,
@@ -23450,6 +23627,14 @@
                             console.error(e);
                         }
                     });
+                    this.tileUnloadRemoval = this.cTileset.tileUnload.addEventListener((tile) => {
+                        try {
+                            this.unloadTile(tile);
+                        }
+                        catch (e) {
+                            console.error(e);
+                        }
+                    });
                     this.queueCheckInterval = setInterval(() => {
                         if (this.featureQueue.length > 0) {
                             this.processQueue();
@@ -23639,7 +23824,7 @@
                         });
                         this.tileUnloadRemoval = cTileset.tileUnload.addEventListener((tile) => {
                             try {
-                                this.queueTile(tile, false);
+                                this.unloadTile(tile);
                             }
                             catch (e) {
                                 console.error(e);
@@ -23685,6 +23870,35 @@
                 }
                 this.pingFeatureQueue();
             }
+            /*
+             * Removes a tile's regos and marks its features dead, while the tile's content can still be read.
+             */
+            unloadTile(tile) {
+                const content = tile === null || tile === void 0 ? void 0 : tile.content;
+                if (!content) {
+                    return;
+                }
+                const features = [];
+                for (let i = 0; i < content.featuresLength; i++) {
+                    const feature = content.getFeature(i);
+                    // Drops a load still queued for it, the batch skips anything marked.
+                    this.featureQueueStates.delete(feature);
+                    feature._bruceUnloaded = true;
+                    features.push(feature);
+                }
+                if (!features.length) {
+                    return;
+                }
+                const { removedEntityIds } = this.visualsManager.RemoveRegosByVisuals({
+                    visuals: features,
+                    requestRender: false,
+                    menuItemId: this.item.id,
+                    doRemove: false
+                });
+                for (const entityId of removedEntityIds) {
+                    delete this.loadedCesiumEntities[entityId];
+                }
+            }
             /**
              * Pings the feature queue to process any queued features.
              * Does nothing if we're already processing.
@@ -23701,7 +23915,7 @@
                         return;
                     }
                     this.processFeatureQueueBatch();
-                    if (!this.featureQueue) {
+                    if (!this.featureQueue.length) {
                         clearInterval(this.featureQueueInterval);
                         this.featureQueueInterval = null;
                     }
@@ -23719,6 +23933,10 @@
                 const regosToStyle = new Map();
                 const featuresToRemove = [];
                 for (const feature of batch) {
+                    // Its tile unloaded while it waited, unloadTile already removed whatever it registered.
+                    if (feature._bruceUnloaded) {
+                        continue;
+                    }
                     const load = this.featureQueueStates.get(feature);
                     this.featureQueueStates.delete(feature);
                     if (!load) {
@@ -23924,7 +24142,7 @@
                 });
                 this.tileUnloadRemoval = this.cTileset.tileUnload.addEventListener((tile) => {
                     try {
-                        this.queueTile(tile, false);
+                        this.unloadTile(tile);
                     }
                     catch (e) {
                         console.error(e);
@@ -24878,7 +25096,7 @@
                         });
                         this.cTileset.tileUnload.addEventListener((tile) => {
                             try {
-                                this.queueTile(tile, false);
+                                this.unloadTile(tile);
                             }
                             catch (e) {
                                 console.error(e);
@@ -24906,6 +25124,35 @@
                 }
                 this.pingFeatureQueue();
             }
+            /*
+             * Removes a tile's regos and marks its features dead, while the tile's content can still be read.
+             */
+            unloadTile(tile) {
+                const content = tile === null || tile === void 0 ? void 0 : tile.content;
+                if (!content) {
+                    return;
+                }
+                const features = [];
+                for (let i = 0; i < content.featuresLength; i++) {
+                    const feature = content.getFeature(i);
+                    // Drops a load still queued for it, the batch skips anything marked.
+                    this.featureQueueStates.delete(feature);
+                    feature._bruceUnloaded = true;
+                    features.push(feature);
+                }
+                if (!features.length) {
+                    return;
+                }
+                const { removedEntityIds } = this.visualsManager.RemoveRegosByVisuals({
+                    visuals: features,
+                    requestRender: false,
+                    menuItemId: this.item.id,
+                    doRemove: false
+                });
+                for (const entityId of removedEntityIds) {
+                    delete this.loadedCesiumEntities[entityId];
+                }
+            }
             /**
              * Pings the feature queue to process any queued features.
              * Does nothing if we're already processing.
@@ -24922,7 +25169,7 @@
                         return;
                     }
                     this.processFeatureQueueBatch();
-                    if (!this.featureQueue) {
+                    if (!this.featureQueue.length) {
                         clearInterval(this.featureQueueInterval);
                         this.featureQueueInterval = null;
                     }
@@ -24940,6 +25187,10 @@
                 const regosToStyle = new Map();
                 const featuresToRemove = [];
                 for (const feature of batch) {
+                    // Its tile unloaded while it waited, unloadTile already removed whatever it registered.
+                    if (feature._bruceUnloaded) {
+                        continue;
+                    }
                     const load = this.featureQueueStates.get(feature);
                     this.featureQueueStates.delete(feature);
                     if (!load) {
@@ -25556,6 +25807,8 @@
             constructor(params) {
                 this.disposed = false;
                 this.cTileset = null;
+                // Set while a tileset is being created, so a second Init in the meantime cannot add another.
+                this.initializing = false;
                 const { viewer, item, getters } = params;
                 this.viewer = viewer;
                 this.item = item;
@@ -25576,6 +25829,10 @@
                         this.viewer.scene.primitives.remove(this.cTileset);
                         this.viewer.scene.requestRender();
                     }
+                    // Disposed before it was added, so nothing else will ever destroy it.
+                    else if (!this.cTileset.isDestroyed()) {
+                        this.cTileset.destroy();
+                    }
                     this.cTileset = null;
                 }
             }
@@ -25594,6 +25851,11 @@
                         this.viewer.scene.requestRender();
                         return;
                     }
+                    // The creation in flight applies the latest item's colour mask when it lands.
+                    if (this.initializing) {
+                        return;
+                    }
+                    this.initializing = true;
                     try {
                         const api = this.getters.GetBruceApi();
                         await api.Loading;
@@ -25679,6 +25941,14 @@
                         console.error("Failed to load Google Photorealistic 3D tileset:", e);
                         return;
                     }
+                    finally {
+                        this.initializing = false;
+                    }
+                    // Creation can come back empty, and the viewer can go while it loads.
+                    if (this.disposed || !this.cTileset || this.cTileset.isDestroyed() || !this.viewer || this.viewer.isDestroyed()) {
+                        this.doDispose();
+                        return;
+                    }
                     this.viewer.scene.primitives.add(this.cTileset);
                     this.applyColorMask();
                     this.viewer.scene.requestRender();
@@ -43122,7 +43392,8 @@
                     const hpr = new Cesium.HeadingPitchRoll(Cesium.Math.toRadians(heading), Cesium.Math.toRadians(pitch), Cesium.Math.toRadians(roll));
                     getOrient = new Cesium.CallbackProperty(() => {
                         const currentPos = position ? GetCValue(params.viewer, position) : pos3d;
-                        return Cesium.Transforms.headingPitchRollQuaternion(currentPos, hpr);
+                        // A live position can read as null mid-update, and throwing here would stop Cesium's frame.
+                        return Cesium.Transforms.headingPitchRollQuaternion(currentPos || pos3d, hpr);
                     }, false);
                 }
                 cEntity = new Cesium.Entity({
@@ -50432,7 +50703,7 @@ void main() {
         StyleUtils.ApplyTypeStyle = ApplyTypeStyle;
     })(exports.StyleUtils || (exports.StyleUtils = {}));
 
-    const VERSION = "7.4.4";
+    const VERSION = "7.4.6";
     /**
      * Updates the environment instance used by bruce-cesium to one specified.
      * This can be used to ensure that the instance a parent is referencing is shared between bruce-cesium, bruce-models, and the parent app.