bruce-cesium 7.4.5 → 7.4.7

package/dist/bruce-cesium.es5.js

@@ -1,6 +1,6 @@
 import * as Cesium from 'cesium';
-import { Cartographic, ColorMaterialProperty, Entity, Color, ConstantProperty, CallbackProperty, Primitive, Cesium3DTileFeature, ShaderSource, Cartesian3, Math as Math$1, Ellipsoid, Transforms, Matrix4, Geometry, GeometryAttribute, ComponentDatatype, PrimitiveType, BoundingSphere, GeometryPipeline, Cartesian2, Cartesian4, sampleTerrain, Texture, PixelFormat, Sampler, TextureWrap, TextureMinificationFilter, TextureMagnificationFilter, VertexArray, BufferUsage, ShaderProgram, RenderState, BlendingState, DrawCommand, Pass, JulianDate, Quaternion, HeadingPitchRoll, HeightReference, ConstantPositionProperty, DistanceDisplayCondition, ColorBlendMode, ShadowMode, ClassificationType, Model, HorizontalOrigin, VerticalOrigin, ImageMaterialProperty, PolygonHierarchy, PolylineGraphics, ArcType, CornerType, Rectangle, SceneTransforms, FeatureDetection, NearFarScalar, Matrix3, KmlDataSource, GeoJsonDataSource, SceneMode, Cesium3DTileStyle, HeadingPitchRange, Cesium3DTileColorBlendMode, Ion, IonResource, EllipsoidTerrainProvider, IonImageryProvider, createWorldImagery, createWorldImageryAsync, BingMapsImageryProvider, BingMapsStyle, MapboxImageryProvider, MapboxStyleImageryProvider, ArcGisMapServerImageryProvider, OpenStreetMapImageryProvider, UrlTemplateImageryProvider, GridImageryProvider, GeographicTilingScheme, ImageryLayer, TileMapServiceImageryProvider, CesiumTerrainProvider, Cesium3DTileset, OrthographicFrustum, EasingFunction, Intersect, CustomDataSource, ModelGraphics, PolygonGraphics, CorridorGraphics, PointGraphics, BillboardGraphics, EllipseGraphics, PolylineDashMaterialProperty, EllipsoidGeodesic, sampleTerrainMostDetailed, defined, GeometryInstance, PolygonPipeline, CesiumInspector, ClockRange, DynamicEnvironmentMapManager, ScreenSpaceEventHandler, ScreenSpaceEventType, Fullscreen, CzmlDataSource } from 'cesium';
-import { Cartes, LRUCache, ProjectViewTile, ENVIRONMENT, Calculator, ClientFile, Entity as Entity$1, EntityLod, EntityTag, EntityType, ObjectUtils, Style, Api, Bounds, ClientFileValueMap, Color as Color$1, Geometry as Geometry$1, Carto, MenuItem, ProjectView, ProjectViewBookmark, Tileset, ZoomControl, BruceEvent, EntityCoords, DataLab, DelayQueue, AccountConcept, RecordChangeFeed, BruceApi, EntityRelation, EntitySource, ProgramKey, ProjectViewLegacyTile, Camera, Account, AccountLimits, Session, UrlUtils, EntityAttachment, EntityAttachmentType, EntityAttribute, MathUtils, ProjectViewBookmarkGroup, EntityRelationType, EntityHistoricData } from 'bruce-models';
+import { Cartographic, ColorMaterialProperty, Entity, Color, ConstantProperty, CallbackProperty, Primitive, Cesium3DTileFeature, ShaderSource, Cartesian3, Math as Math$1, Ellipsoid, Transforms, Matrix4, Geometry, GeometryAttribute, ComponentDatatype, PrimitiveType, BoundingSphere, GeometryPipeline, Cartesian2, Cartesian4, sampleTerrain, Texture, PixelFormat, Sampler, TextureWrap, TextureMinificationFilter, TextureMagnificationFilter, VertexArray, BufferUsage, ShaderProgram, RenderState, BlendingState, DrawCommand, Pass, HeightReference, ColorBlendMode, HeadingPitchRoll, ShadowMode, ClassificationType, Model, HorizontalOrigin, VerticalOrigin, ConstantPositionProperty, ArcType, CornerType, JulianDate, Quaternion, ImageMaterialProperty, DistanceDisplayCondition, PolygonHierarchy, PolylineGraphics, Rectangle, SceneTransforms, NearFarScalar, Matrix3, KmlDataSource, FeatureDetection, SceneMode, GeoJsonDataSource, Ion, IonResource, Cesium3DTileStyle, HeadingPitchRange, Cesium3DTileset, OrthographicFrustum, EasingFunction, EllipsoidTerrainProvider, IonImageryProvider, createWorldImagery, createWorldImageryAsync, BingMapsImageryProvider, BingMapsStyle, MapboxImageryProvider, MapboxStyleImageryProvider, ArcGisMapServerImageryProvider, OpenStreetMapImageryProvider, UrlTemplateImageryProvider, GridImageryProvider, GeographicTilingScheme, ImageryLayer, TileMapServiceImageryProvider, CesiumTerrainProvider, Cesium3DTileColorBlendMode, Intersect, PolygonPipeline, ModelGraphics, PolygonGraphics, CorridorGraphics, PointGraphics, BillboardGraphics, EllipseGraphics, PolylineDashMaterialProperty, EllipsoidGeodesic, sampleTerrainMostDetailed, defined, CesiumInspector, ClockRange, DynamicEnvironmentMapManager, ScreenSpaceEventHandler, ScreenSpaceEventType, GeometryInstance, Fullscreen, CustomDataSource, CzmlDataSource } from 'cesium';
+import { Cartes, LRUCache, ProjectViewTile, ENVIRONMENT, Calculator, ClientFile, Entity as Entity$1, EntityLod, EntityTag, EntityType, ObjectUtils, Style, Api, Carto, Geometry as Geometry$1, ClientFileValueMap, Color as Color$1, MenuItem, ProjectView, ProjectViewBookmark, Tileset, ZoomControl, BruceEvent, EntityCoords, Bounds, DataLab, DelayQueue, AccountConcept, EntityRelation, BruceApi, RecordChangeFeed, EntitySource, Camera, ProgramKey, ProjectViewLegacyTile, Account, AccountLimits, Session, UrlUtils, EntityAttachment, EntityAttachmentType, EntityAttribute, MathUtils, ProjectViewBookmarkGroup, EntityRelationType, EntityHistoricData } from 'bruce-models';
 
 /**
  * Ensures a number is returned from a given value.
@@ -1517,6 +1517,7 @@ function getPosition(viewer, obj) {
  * @returns
  */
 function isFeatureAlive(viewer, feature) {
+    var _a, _b;
     if (!(viewer === null || viewer === void 0 ? void 0 : viewer.scene) || viewer.isDestroyed()) {
         return false;
     }
@@ -1527,6 +1528,10 @@ function isFeatureAlive(viewer, feature) {
     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;
@@ -1717,7 +1722,17 @@ var CesiumAnimatedProperty;
                 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();
@@ -2936,6 +2951,7 @@ var CesiumAnimatedProperty;
  * @returns
  */
 function isAlive(viewer, visual) {
+    var _a, _b;
     if (!(viewer === null || viewer === void 0 ? void 0 : viewer.scene) || viewer.isDestroyed()) {
         return false;
     }
@@ -2953,6 +2969,10 @@ function isAlive(viewer, visual) {
         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;
@@ -5805,9 +5825,14 @@ var EntityLabel;
             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 Cartesian3();
             this.TrackPointer = (event) => {
                 var _a, _b;
                 if (event.pointerType && event.pointerType !== "mouse" && event.pointerType !== "pen")
@@ -5995,9 +6020,45 @@ var EntityLabel;
                 }
             };
         }
+        /*
+         * 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 = Cartesian3.magnitudeSquared(scaled);
+            // Test sub-sea-level points from the surface.
+            if (magnitudeSquared > 0 && magnitudeSquared < 1) {
+                Cartesian3.normalize(scaled, scaled);
+            }
+            const toPoint = Cartesian3.subtract(scaled, camera, scaled);
+            const along = -Cartesian3.dot(toPoint, camera);
+            return along > limbSquared && along * along / 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) !== 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) || Ellipsoid.WGS84;
+            const camera = ellipsoid.transformPositionToScaledSpace(position, new Cartesian3());
+            const limbSquared = 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 ?
@@ -6005,15 +6066,35 @@ var EntityLabel;
                     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 {
@@ -6752,7 +6833,8 @@ var EntityLabel;
                 // 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 = SceneTransforms;
@@ -9285,6 +9367,7 @@ var VisualRegisterCuller;
 })(VisualRegisterCuller || (VisualRegisterCuller = {}));
 
 function isTilesetFeatureAlive(visual) {
+    var _a, _b;
     const cTileset = visual === null || visual === void 0 ? void 0 : visual.tileset;
     if (!cTileset) {
         return false;
@@ -9295,8 +9378,32 @@ function isTilesetFeatureAlive(visual) {
     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 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
@@ -9304,6 +9411,7 @@ function isTilesetFeatureAlive(visual) {
  * @returns
  */
 function isAlive$1(viewer, visual) {
+    var _a, _b;
     if (!(viewer === null || viewer === void 0 ? void 0 : viewer.scene) || viewer.isDestroyed()) {
         return false;
     }
@@ -9324,6 +9432,10 @@ function isAlive$1(viewer, visual) {
         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;
@@ -9786,6 +9898,13 @@ var VisualsRegister;
             // 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();
             })
@@ -9822,7 +9941,9 @@ var VisualsRegister;
             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;
@@ -9832,7 +9953,7 @@ var VisualsRegister;
             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);
@@ -12172,7 +12293,7 @@ var VisualsRegister;
             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;
@@ -12197,7 +12318,7 @@ var VisualsRegister;
             }
             const existing = rego && 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")) {
@@ -12209,7 +12330,7 @@ var VisualsRegister;
                 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,
@@ -12231,7 +12352,7 @@ var VisualsRegister;
                 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,
@@ -12241,10 +12362,10 @@ var VisualsRegister;
                     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));
                 }
             };
@@ -14864,12 +14985,20 @@ var EntitiesRenderManager;
                 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.
@@ -15911,12 +16040,20 @@ var EntitiesLoadedRenderManager;
                 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.
@@ -19611,7 +19748,7 @@ var TilesetCadRenderManager;
                 });
                 this.tileUnloadRemoval = cTileset.tileUnload.addEventListener((tile) => {
                     try {
-                        this.queueTile(tile, false);
+                        this.unloadTile(tile);
                     }
                     catch (e) {
                         console.error(e);
@@ -19795,7 +19932,7 @@ var TilesetCadRenderManager;
             });
             this.tileUnloadRemoval = this.cTileset.tileUnload.addEventListener((tile) => {
                 try {
-                    this.queueTile(tile, false);
+                    this.unloadTile(tile);
                 }
                 catch (e) {
                     console.error(e);
@@ -19860,6 +19997,35 @@ var TilesetCadRenderManager;
             }
             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.
@@ -19876,7 +20042,7 @@ var TilesetCadRenderManager;
                     return;
                 }
                 this.processFeatureQueueBatch();
-                if (!this.featureQueue) {
+                if (!this.featureQueue.length) {
                     clearInterval(this.featureQueueInterval);
                     this.featureQueueInterval = null;
                 }
@@ -19908,6 +20074,10 @@ var TilesetCadRenderManager;
             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) {
@@ -23080,6 +23250,7 @@ var TilesetOsmRenderManager;
             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;
@@ -23088,7 +23259,7 @@ var TilesetOsmRenderManager;
             this.monitor = monitor;
         }
         Dispose() {
-            var _a;
+            var _a, _b;
             if (this.disposed) {
                 return;
             }
@@ -23096,6 +23267,8 @@ var TilesetOsmRenderManager;
             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)) {
@@ -23191,6 +23364,14 @@ var TilesetOsmRenderManager;
                                 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();
@@ -23227,6 +23408,34 @@ var TilesetOsmRenderManager;
                 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;
@@ -23359,6 +23568,10 @@ var TilesetOsmRenderManager;
                     bruceId = 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;
                 }
@@ -23450,7 +23663,7 @@ var TilesetOsmRenderManager;
             return `osm:${sourceId}:${entityTypeId}`;
         }
         PrepareHandoff() {
-            var _a;
+            var _a, _b;
             if (this.disposed || !this.cTileset || this.cTileset.isDestroyed()) {
                 return null;
             }
@@ -23458,6 +23671,8 @@ var TilesetOsmRenderManager;
             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,
@@ -23505,6 +23720,14 @@ var TilesetOsmRenderManager;
                         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();
@@ -23695,7 +23918,7 @@ var TilesetEntitiesRenderManager;
                     });
                     this.tileUnloadRemoval = cTileset.tileUnload.addEventListener((tile) => {
                         try {
-                            this.queueTile(tile, false);
+                            this.unloadTile(tile);
                         }
                         catch (e) {
                             console.error(e);
@@ -23741,6 +23964,35 @@ var TilesetEntitiesRenderManager;
             }
             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.
@@ -23757,7 +24009,7 @@ var TilesetEntitiesRenderManager;
                     return;
                 }
                 this.processFeatureQueueBatch();
-                if (!this.featureQueue) {
+                if (!this.featureQueue.length) {
                     clearInterval(this.featureQueueInterval);
                     this.featureQueueInterval = null;
                 }
@@ -23775,6 +24027,10 @@ var TilesetEntitiesRenderManager;
             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) {
@@ -23980,7 +24236,7 @@ var TilesetEntitiesRenderManager;
             });
             this.tileUnloadRemoval = this.cTileset.tileUnload.addEventListener((tile) => {
                 try {
-                    this.queueTile(tile, false);
+                    this.unloadTile(tile);
                 }
                 catch (e) {
                     console.error(e);
@@ -24941,7 +25197,7 @@ var TilesetArbRenderManager;
                     });
                     this.cTileset.tileUnload.addEventListener((tile) => {
                         try {
-                            this.queueTile(tile, false);
+                            this.unloadTile(tile);
                         }
                         catch (e) {
                             console.error(e);
@@ -24969,6 +25225,35 @@ var TilesetArbRenderManager;
             }
             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.
@@ -24985,7 +25270,7 @@ var TilesetArbRenderManager;
                     return;
                 }
                 this.processFeatureQueueBatch();
-                if (!this.featureQueue) {
+                if (!this.featureQueue.length) {
                     clearInterval(this.featureQueueInterval);
                     this.featureQueueInterval = null;
                 }
@@ -25003,6 +25288,10 @@ var TilesetArbRenderManager;
             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) {
@@ -25621,6 +25910,8 @@ var TilesetGooglePhotosRenderManager;
         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;
@@ -25641,6 +25932,10 @@ var TilesetGooglePhotosRenderManager;
                     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;
             }
         }
@@ -25659,6 +25954,11 @@ var TilesetGooglePhotosRenderManager;
                     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;
@@ -25744,6 +26044,14 @@ var TilesetGooglePhotosRenderManager;
                     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();
@@ -43234,7 +43542,8 @@ var EntityRenderEngineModel3d;
                 const hpr = new HeadingPitchRoll(Math$1.toRadians(heading), Math$1.toRadians(pitch), Math$1.toRadians(roll));
                 getOrient = new CallbackProperty(() => {
                     const currentPos = position ? GetCValue(params.viewer, position) : pos3d;
-                    return Transforms.headingPitchRollQuaternion(currentPos, hpr);
+                    // A live position can read as null mid-update, and throwing here would stop Cesium's frame.
+                    return Transforms.headingPitchRollQuaternion(currentPos || pos3d, hpr);
                 }, false);
             }
             cEntity = new Entity({
@@ -50574,7 +50883,7 @@ var StyleUtils;
     StyleUtils.ApplyTypeStyle = ApplyTypeStyle;
 })(StyleUtils || (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.