bruce-cesium 7.4.5 → 7.4.7

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,9 +5809,14 @@
                 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;
+                // Null outside a 3D view.
+                this.horizon = null;
+                this.horizonScratch = new Cesium.Cartesian3();
                 this.TrackPointer = (event) => {
                     var _a, _b;
                     if (event.pointerType && event.pointerType !== "mouse" && event.pointerType !== "pen")
@@ -5979,9 +6004,45 @@
                     }
                 };
             }
+            /*
+             * Whether the globe hides a position; labels skip the depth test, so this is their only occluder.
+             */
+            IsBeyondHorizon(position) {
+                if (!this.horizon) {
+                    return false;
+                }
+                const { ellipsoid, camera, limbSquared } = this.horizon;
+                // Scaled space makes the ellipsoid a unit sphere.
+                const scaled = ellipsoid.transformPositionToScaledSpace(position, this.horizonScratch);
+                const magnitudeSquared = Cesium.Cartesian3.magnitudeSquared(scaled);
+                // Test sub-sea-level points from the surface.
+                if (magnitudeSquared > 0 && magnitudeSquared < 1) {
+                    Cesium.Cartesian3.normalize(scaled, scaled);
+                }
+                const toPoint = Cesium.Cartesian3.subtract(scaled, camera, scaled);
+                const along = -Cesium.Cartesian3.dot(toPoint, camera);
+                return along > limbSquared && along * along / Cesium.Cartesian3.magnitudeSquared(toPoint) > limbSquared;
+            }
+            UpdateHorizon() {
+                var _a, _b, _c;
+                const scene = this.viewer.scene;
+                const position = ((_a = scene === null || scene === void 0 ? void 0 : scene.camera) === null || _a === void 0 ? void 0 : _a.positionWC) || ((_b = scene === null || scene === void 0 ? void 0 : scene.camera) === null || _b === void 0 ? void 0 : _b.position);
+                this.horizon = null;
+                if ((scene === null || scene === void 0 ? void 0 : scene.mode) !== Cesium.SceneMode.SCENE3D || !Number.isFinite(position === null || position === void 0 ? void 0 : position.x)) {
+                    return;
+                }
+                const ellipsoid = ((_c = scene.globe) === null || _c === void 0 ? void 0 : _c.ellipsoid) || Cesium.Ellipsoid.WGS84;
+                const camera = ellipsoid.transformPositionToScaledSpace(position, new Cesium.Cartesian3());
+                const limbSquared = Cesium.Cartesian3.magnitudeSquared(camera) - 1;
+                // No horizon from underground.
+                if (limbSquared > 0) {
+                    this.horizon = { ellipsoid, camera, limbSquared };
+                }
+            }
             Update() {
                 var _a, _b;
                 this.coordinates = this.MeasureCoordinates();
+                this.UpdateHorizon();
                 const rect = (_b = (_a = this.viewer.canvas).getBoundingClientRect) === null || _b === void 0 ? void 0 : _b.call(_a);
                 const pointer = this.pointerClient;
                 this.pointer = pointer && (rect === null || rect === void 0 ? void 0 : rect.width) && (rect === null || rect === void 0 ? void 0 : rect.height) && pointer.x >= rect.left && pointer.x < rect.right && pointer.y >= rect.top && pointer.y < rect.bottom ?
@@ -5989,15 +6050,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 {
@@ -6736,7 +6817,8 @@
                     // 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 && !hoverOnly && distance >= MAX_DISTANCE)) {
+                        distance > ((_d = this.options.far) !== null && _d !== void 0 ? _d : Infinity) || (!this.prePositioned && !hoverOnly && distance >= MAX_DISTANCE) ||
+                        layer.IsBeyondHorizon(this._pos3d)) {
                         return null;
                     }
                     const transforms = Cesium.SceneTransforms;
@@ -9267,6 +9349,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;
@@ -9277,8 +9360,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
@@ -9286,6 +9393,7 @@
      * @returns
      */
     function isAlive$1(viewer, visual) {
+        var _a, _b;
         if (!(viewer === null || viewer === void 0 ? void 0 : viewer.scene) || viewer.isDestroyed()) {
             return false;
         }
@@ -9306,6 +9414,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;
@@ -9764,6 +9876,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();
                 })
@@ -9800,7 +9919,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;
@@ -9810,7 +9931,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);
@@ -12150,7 +12271,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;
@@ -12175,7 +12296,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")) {
@@ -12187,7 +12308,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,
@@ -12209,7 +12330,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,
@@ -12219,10 +12340,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));
                     }
                 };
@@ -14837,12 +14958,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.
@@ -15878,12 +16007,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.
@@ -19563,7 +19700,7 @@
                     });
                     this.tileUnloadRemoval = cTileset.tileUnload.addEventListener((tile) => {
                         try {
-                            this.queueTile(tile, false);
+                            this.unloadTile(tile);
                         }
                         catch (e) {
                             console.error(e);
@@ -19747,7 +19884,7 @@
                 });
                 this.tileUnloadRemoval = this.cTileset.tileUnload.addEventListener((tile) => {
                     try {
-                        this.queueTile(tile, false);
+                        this.unloadTile(tile);
                     }
                     catch (e) {
                         console.error(e);
@@ -19812,6 +19949,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.
@@ -19828,7 +19994,7 @@
                         return;
                     }
                     this.processFeatureQueueBatch();
-                    if (!this.featureQueue) {
+                    if (!this.featureQueue.length) {
                         clearInterval(this.featureQueueInterval);
                         this.featureQueueInterval = null;
                     }
@@ -19860,6 +20026,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) {
@@ -23027,6 +23197,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;
@@ -23035,7 +23206,7 @@
                 this.monitor = monitor;
             }
             Dispose() {
-                var _a;
+                var _a, _b;
                 if (this.disposed) {
                     return;
                 }
@@ -23043,6 +23214,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)) {
@@ -23138,6 +23311,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();
@@ -23174,6 +23355,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;
@@ -23306,6 +23515,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;
                     }
@@ -23397,7 +23610,7 @@
                 return `osm:${sourceId}:${entityTypeId}`;
             }
             PrepareHandoff() {
-                var _a;
+                var _a, _b;
                 if (this.disposed || !this.cTileset || this.cTileset.isDestroyed()) {
                     return null;
                 }
@@ -23405,6 +23618,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,
@@ -23452,6 +23667,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();
@@ -23641,7 +23864,7 @@
                         });
                         this.tileUnloadRemoval = cTileset.tileUnload.addEventListener((tile) => {
                             try {
-                                this.queueTile(tile, false);
+                                this.unloadTile(tile);
                             }
                             catch (e) {
                                 console.error(e);
@@ -23687,6 +23910,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.
@@ -23703,7 +23955,7 @@
                         return;
                     }
                     this.processFeatureQueueBatch();
-                    if (!this.featureQueue) {
+                    if (!this.featureQueue.length) {
                         clearInterval(this.featureQueueInterval);
                         this.featureQueueInterval = null;
                     }
@@ -23721,6 +23973,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) {
@@ -23926,7 +24182,7 @@
                 });
                 this.tileUnloadRemoval = this.cTileset.tileUnload.addEventListener((tile) => {
                     try {
-                        this.queueTile(tile, false);
+                        this.unloadTile(tile);
                     }
                     catch (e) {
                         console.error(e);
@@ -24880,7 +25136,7 @@
                         });
                         this.cTileset.tileUnload.addEventListener((tile) => {
                             try {
-                                this.queueTile(tile, false);
+                                this.unloadTile(tile);
                             }
                             catch (e) {
                                 console.error(e);
@@ -24908,6 +25164,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.
@@ -24924,7 +25209,7 @@
                         return;
                     }
                     this.processFeatureQueueBatch();
-                    if (!this.featureQueue) {
+                    if (!this.featureQueue.length) {
                         clearInterval(this.featureQueueInterval);
                         this.featureQueueInterval = null;
                     }
@@ -24942,6 +25227,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) {
@@ -25558,6 +25847,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;
@@ -25578,6 +25869,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;
                 }
             }
@@ -25596,6 +25891,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;
@@ -25681,6 +25981,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();
@@ -43124,7 +43432,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({
@@ -50434,7 +50743,7 @@ void main() {
         StyleUtils.ApplyTypeStyle = ApplyTypeStyle;
     })(exports.StyleUtils || (exports.StyleUtils = {}));
 
-    const VERSION = "7.4.5";
+    const VERSION = "7.4.7";
     /**
      * 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.