bruce-cesium 7.4.2 → 7.4.4

package/dist/bruce-cesium.es5.js

@@ -1,6 +1,6 @@
 import * as Cesium from 'cesium';
-import { Cartographic, ColorMaterialProperty, Entity, Color, ConstantProperty, CallbackProperty, Primitive, Cesium3DTileFeature, HeightReference, ColorBlendMode, HeadingPitchRoll, Math as Math$1, Transforms, ShadowMode, Cartesian3, ClassificationType, Model, ShaderSource, Ellipsoid, 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, DistanceDisplayCondition, ArcType, CornerType, ConstantPositionProperty, HorizontalOrigin, VerticalOrigin, ImageMaterialProperty, SceneTransforms, PolygonHierarchy, PolylineGraphics, Rectangle, FeatureDetection, KmlDataSource, NearFarScalar, GeoJsonDataSource, Matrix3, SceneMode, Ion, IonResource, Cesium3DTileStyle, HeadingPitchRange, Cesium3DTileColorBlendMode, Cesium3DTileset, Intersect, OrthographicFrustum, EasingFunction, ModelGraphics, PolygonGraphics, CorridorGraphics, PointGraphics, BillboardGraphics, EllipseGraphics, PolylineDashMaterialProperty, EllipsoidGeodesic, EllipsoidTerrainProvider, sampleTerrainMostDetailed, defined, PolygonPipeline, IonImageryProvider, createWorldImagery, createWorldImageryAsync, BingMapsImageryProvider, BingMapsStyle, MapboxImageryProvider, MapboxStyleImageryProvider, ArcGisMapServerImageryProvider, OpenStreetMapImageryProvider, UrlTemplateImageryProvider, GridImageryProvider, GeographicTilingScheme, ImageryLayer, TileMapServiceImageryProvider, CesiumTerrainProvider, GeometryInstance, ScreenSpaceEventHandler, ScreenSpaceEventType, CesiumInspector, ClockRange, DynamicEnvironmentMapManager, CustomDataSource, Fullscreen, CzmlDataSource } from 'cesium';
-import { Cartes, LRUCache, ProjectViewTile, ENVIRONMENT, Calculator, ClientFile, Entity as Entity$1, EntityLod, EntityTag, EntityType, ObjectUtils, Style, Carto, Geometry as Geometry$1, Api, ClientFileValueMap, Color as Color$1, BruceEvent, EntityCoords, MenuItem, Tileset, ProjectView, ProjectViewBookmark, ZoomControl, Bounds, DataLab, DelayQueue, AccountConcept, BruceApi, EntityRelation, RecordChangeFeed, EntitySource, Camera, ProgramKey, ProjectViewLegacyTile, Account, AccountLimits, Session, UrlUtils, EntityAttachment, EntityAttachmentType, EntityAttribute, MathUtils, ProjectViewBookmarkGroup, EntityRelationType, EntityHistoricData } from 'bruce-models';
+import { Cartographic, ColorMaterialProperty, Entity, Color, ConstantProperty, CallbackProperty, Primitive, Cesium3DTileFeature, Math as Math$1, Cartesian3, JulianDate, Quaternion, Transforms, HeadingPitchRoll, HeightReference, Matrix4, ColorBlendMode, ShadowMode, ClassificationType, Model, HorizontalOrigin, VerticalOrigin, ConstantPositionProperty, ArcType, CornerType, DistanceDisplayCondition, ShaderSource, Ellipsoid, Geometry, GeometryAttribute, ComponentDatatype, PrimitiveType, BoundingSphere, GeometryPipeline, Cartesian2, Cartesian4, sampleTerrain, Texture, PixelFormat, Sampler, TextureWrap, TextureMinificationFilter, TextureMagnificationFilter, VertexArray, BufferUsage, ShaderProgram, RenderState, BlendingState, DrawCommand, Pass, ImageMaterialProperty, PolygonHierarchy, PolylineGraphics, Rectangle, SceneTransforms, FeatureDetection, NearFarScalar, Matrix3, KmlDataSource, GeoJsonDataSource, SceneMode, Cesium3DTileStyle, Cesium3DTileColorBlendMode, HeadingPitchRange, Ion, IonResource, Cesium3DTileset, EllipsoidTerrainProvider, IonImageryProvider, createWorldImagery, createWorldImageryAsync, BingMapsImageryProvider, BingMapsStyle, MapboxImageryProvider, MapboxStyleImageryProvider, ArcGisMapServerImageryProvider, OpenStreetMapImageryProvider, UrlTemplateImageryProvider, GridImageryProvider, GeographicTilingScheme, ImageryLayer, TileMapServiceImageryProvider, CesiumTerrainProvider, OrthographicFrustum, EasingFunction, CustomDataSource, PolygonPipeline, EllipsoidGeodesic, sampleTerrainMostDetailed, defined, ModelGraphics, PolygonGraphics, CorridorGraphics, PointGraphics, BillboardGraphics, EllipseGraphics, PolylineDashMaterialProperty, Intersect, GeometryInstance, 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, Carto, Geometry as Geometry$1, ClientFileValueMap, Color as Color$1, Bounds, 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';
 
 /**
  * Ensures a number is returned from a given value.
@@ -5403,8 +5403,16 @@ var EntityLabel;
     // so a row of labels reads as one size rather than a set of differently shaped pills.
     const ICON_BACKGROUND_UNIFORM_TOLERANCE = 0.3;
     const TEXT_MAX_WIDTH = 200;
+    // Distinct icons a cluster shows, the representative's included.
+    const ICON_STACK_LIMIT = 3;
+    // Size of every icon in a cluster's arrangement, relative to the representative's own.
+    const ICON_STACK_SCALE = 0.6;
     // How far an angled leader runs sideways before the label starts.
     const ANGLED_LEADER_RUN = 28;
+    // Clearance between a point or billboard glyph and the ring drawn around it.
+    const ICON_RING_PADDING = 4;
+    // Small points still get a ring as large as the default near ring.
+    const ICON_RING_MIN = 10;
     // One per tinted icon, since an SVG mask is addressed by id across the whole document.
     let tintCounter = 0;
     // Key where the label instance is stored within the cesium entity.
@@ -5586,6 +5594,28 @@ var EntityLabel;
      * Prefer declared semantics; only infers from recognisable glyphs and filename tokens, never image pixels.
      */
     EntityLabel.IconPriority = GetClusterIconPriority;
+    function iconLook(options) {
+        return {
+            icon: options.icon || undefined,
+            iconUrl: options.iconUrl || undefined,
+            iconClass: typeof options.iconClass === "string" && options.iconClass ? options.iconClass : undefined,
+            iconColor: typeof options.iconColor === "string" && options.iconColor ? options.iconColor : undefined,
+            iconBackground: options.iconBackground || undefined
+        };
+    }
+    /*
+     * Everything that makes two labels look alike, so labels from different groups only merge when they would read the same.
+     */
+    function clusterLook(options) {
+        var _a;
+        const presentation = options.presentation || "text";
+        return JSON.stringify([
+            presentation,
+            (_a = options.leader) !== null && _a !== void 0 ? _a : null,
+            options.leaderStyle || "default", options.leaderColor || "",
+            presentation === "text" ? null : iconLook(options)
+        ]);
+    }
     /*
      * Resolves clustering and stable text placement before depth fading; highlighted labels receive priority.
      */
@@ -5607,7 +5637,8 @@ var EntityLabel;
             if (!((_b = (_a = frame.options) === null || _a === void 0 ? void 0 : _a.cluster) === null || _b === void 0 ? void 0 : _b.enabled) || frame.priority > 0) {
                 continue;
             }
-            const key = JSON.stringify([frame.group || "", frame.options.presentation || "text"]);
+            // Groups meet inside a presentation; which of them may merge is decided pairwise below.
+            const key = frame.options.presentation || "text";
             if (!groups.has(key)) {
                 groups.set(key, []);
             }
@@ -5619,32 +5650,54 @@ var EntityLabel;
                 frame.options.cluster.pixelRange == null ? { ...frame, x: frame.anchorX, y: frame.anchorY, width: 1, height: 1 } :
                 frame.clusterBounds ? { ...frame, ...frame.clusterBounds } : frame);
             const index = new ScreenIndex();
-            for (const frame of candidates) {
+            const rank = new Map();
+            const looks = new Map();
+            candidates.forEach((frame, i) => {
                 index.Add(frame);
-            }
+                rank.set(frame.id, i);
+                looks.set(frame.id, clusterLook(frame.options));
+            });
             const clusters = ClusterItems({
                 items: candidates,
                 id: frame => frame.id,
                 minSize: group[0].options.cluster.minSize,
                 neighbours: frame => {
                     var _a;
-                    return (index.Query(frame, (_a = frame.options.cluster.pixelRange) !== null && _a !== void 0 ? _a : (frame.options.presentation === "icon" ? 24 : 8)));
+                    const nearby = index.Query(frame, (_a = frame.options.cluster.pixelRange) !== null && _a !== void 0 ? _a : (frame.options.presentation === "icon" ? 24 : 8)).sort((a, b) => rank.get(a.id) - rank.get(b.id));
+                    return compatibleMembers(frame, nearby, other => other.group || "", other => looks.get(other.id));
                 }
             });
             for (const cluster of clusters) {
                 let chosen = cluster.representative;
-                if ((chosen.options.presentation || "text") !== "text" && chosen.options.cluster.representative !== "nearest") {
-                    let priority = EntityLabel.IconPriority(chosen.options);
-                    for (const member of cluster.members) {
-                        const candidate = EntityLabel.IconPriority(member.options);
-                        if (candidate > priority) {
-                            chosen = member;
-                            priority = candidate;
-                        }
-                    }
+                const iconic = (chosen.options.presentation || "text") !== "text";
+                // Members in the order they would win representation; the seed is the nearest.
+                let ordered = [chosen, ...cluster.members.filter(member => member !== chosen)];
+                if (iconic && chosen.options.cluster.representative !== "nearest") {
+                    ordered = ordered.map((member, i) => ({ member, i, priority: EntityLabel.IconPriority(member.options) }))
+                        .sort((a, b) => b.priority - a.priority || a.i - b.i).map(entry => entry.member);
+                    chosen = ordered[0];
                 }
                 const representative = result.get(chosen.id);
                 representative.members = cluster.members.map(frame => frame.id);
+                if (iconic && chosen.options.iconScale !== 0) {
+                    const seen = new Set();
+                    const icons = [];
+                    for (const member of ordered) {
+                        const look = iconLook(member.options);
+                        const key = JSON.stringify(look);
+                        if (seen.has(key)) {
+                            continue;
+                        }
+                        seen.add(key);
+                        if (member !== ordered[0])
+                            icons.push(look);
+                        if (seen.size >= ICON_STACK_LIMIT) {
+                            break;
+                        }
+                    }
+                    if (icons.length)
+                        representative.icons = icons;
+                }
                 representative.entityIds = Array.from(new Set(cluster.members.map(frame => frame.entityId).filter(Boolean)));
                 if (chosen.options.presentation !== "icon") {
                     const values = new Set();
@@ -5697,6 +5750,34 @@ var EntityLabel;
         return Array.from(result.values());
     }
     EntityLabel.Layout = Layout;
+    /*
+     * The seed plus every neighbour, in order, that shares a group or a look with each member accepted so far.
+     *
+     * Checking against the whole accepted set stops a group with mixed icons bridging two groups that look different.
+     */
+    function compatibleMembers(seed, nearby, group, look) {
+        const accepted = [seed];
+        const byGroup = new Map([[group(seed), 1]]);
+        const byLook = new Map([[look(seed), 1]]);
+        const byBoth = new Map([[JSON.stringify([group(seed), look(seed)]), 1]]);
+        for (const item of nearby) {
+            if (item === seed) {
+                continue;
+            }
+            const itemGroup = group(item), itemLook = look(item), both = JSON.stringify([itemGroup, itemLook]);
+            // Accepted members in another group with another look are the ones this item may not sit beside.
+            const conflicting = accepted.length - (byGroup.get(itemGroup) || 0) - (byLook.get(itemLook) || 0) + (byBoth.get(both) || 0);
+            if (conflicting > 0) {
+                continue;
+            }
+            accepted.push(item);
+            byGroup.set(itemGroup, (byGroup.get(itemGroup) || 0) + 1);
+            byLook.set(itemLook, (byLook.get(itemLook) || 0) + 1);
+            byBoth.set(both, (byBoth.get(both) || 0) + 1);
+        }
+        return accepted;
+    }
+    EntityLabel.compatibleMembers = compatibleMembers;
     const layers = new WeakMap();
     const containers = new WeakMap();
     /*
@@ -6094,7 +6175,7 @@ var EntityLabel;
          * @param starterPos3d optional position to create label at. Ignored for billboard labels.
          */
         async createLabel(starterPos3d) {
-            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r;
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o;
             this.removeLabel();
             let pos3d = starterPos3d ? starterPos3d.clone() : null;
             const counter = ++this.counter;
@@ -6416,125 +6497,28 @@ var EntityLabel;
             let iconElement;
             let iconContainer;
             let fitIconBackground;
+            let iconStack;
+            let stackedFits = [];
+            let displayedStack = "[]";
             content.className = "entity-label-content";
             content.style.cssText = "display:flex;align-items:center;gap:6px;";
             if (presentation === "icon-text-above") {
                 content.style.flexDirection = "column-reverse";
             }
             if (presentation !== "text") {
-                const icon = document.createElement("span");
-                iconElement = icon;
-                icon.className = "entity-label-icon";
-                icon.style.cssText = `font-size:${(this.options.iconSize || 24) * ((_m = this.options.iconScale) !== null && _m !== void 0 ? _m : 1)}px;line-height:1;`;
-                icon.style.textShadow = "0 1px 2px rgba(0, 0, 0, 0.25)";
-                const iconColor = typeof this.options.iconColor === "string" ? this.options.iconColor : undefined;
-                const iconBackground = this.options.iconBackground && this.options.iconScale !== 0;
-                if (iconColor) {
-                    icon.style.color = iconColor;
-                }
-                if (this.options.iconUrl) {
-                    const image = document.createElement("img");
-                    image.draggable = false;
-                    image.alt = this.options.icon || "";
-                    const scale = (_o = this.options.iconScale) !== null && _o !== void 0 ? _o : 1;
-                    const size = this.options.iconSize;
-                    const svgNs = "http://www.w3.org/2000/svg";
-                    const tint = iconColor ? document.createElementNS(svgNs, "svg") : null;
-                    const painted = tint ? document.createElementNS(svgNs, "image") : null;
-                    const inked = tint ? document.createElementNS(svgNs, "rect") : null;
-                    if (tint) {
-                        const maskId = `entity-label-tint-${++tintCounter}`;
-                        const mask = document.createElementNS(svgNs, "mask");
-                        mask.setAttribute("id", maskId);
-                        mask.setAttribute("maskUnits", "userSpaceOnUse");
-                        painted.setAttribute("href", this.options.iconUrl);
-                        painted.setAttribute("preserveAspectRatio", "xMidYMid meet");
-                        mask.appendChild(painted);
-                        inked.setAttribute("fill", iconColor);
-                        inked.setAttribute("mask", `url(#${maskId})`);
-                        tint.append(mask, inked);
-                        tint.style.display = "block";
-                        icon.style.display = "inline-flex";
-                        icon.appendChild(tint);
-                    }
-                    const resize = () => {
-                        if (this.disposed || this.counter !== counter) {
-                            return;
-                        }
-                        const intrinsic = this.options.iconScale != null && size == null;
-                        const width = (intrinsic ? image.naturalWidth || 24 : size || 24) * scale;
-                        const height = (intrinsic ? image.naturalHeight || 24 : size || 24) * scale;
-                        if (tint) {
-                            tint.setAttribute("viewBox", `0 0 ${width} ${height}`);
-                            for (const node of [tint, painted, inked]) {
-                                node.setAttribute("width", String(width));
-                                node.setAttribute("height", String(height));
-                            }
-                        }
-                        else {
-                            image.style.width = `${width}px`;
-                            image.style.height = `${height}px`;
-                        }
-                        this.viewer.scene.requestRender();
-                    };
-                    image.onload = resize;
-                    resize();
-                    image.src = this.options.iconUrl;
-                    if (!tint) {
-                        icon.appendChild(image);
-                    }
-                }
-                else if (typeof this.options.iconClass === "string" && this.options.iconClass) {
-                    icon.className = `entity-label-icon ${this.options.iconClass}`;
-                }
-                else {
-                    icon.textContent = this.options.icon || "●";
-                }
-                if (iconBackground) {
-                    const color = Color.fromCssColorString(iconColor || "white") || Color.WHITE;
-                    const luminance = 0.2126 * color.red + 0.7152 * color.green + 0.0722 * color.blue;
-                    const background = (luminance > 0.5 ? color.darken(ICON_BACKGROUND_BLEND, new Color()) :
-                        color.brighten(ICON_BACKGROUND_BLEND, new Color()));
-                    const size = (this.options.iconSize || 24) * ((_p = this.options.iconScale) !== null && _p !== void 0 ? _p : 1);
-                    icon.style.backgroundColor = background.withAlpha(ICON_BACKGROUND_ALPHA).toCssColorString();
-                    icon.style.borderRadius = "50%";
-                    icon.style.padding = `${size / 3}px`;
-                    icon.style.display = "inline-flex";
-                    icon.style.alignItems = "center";
-                    icon.style.justifyContent = "center";
-                    icon.style.minWidth = `${size}px`;
-                    icon.style.minHeight = `${size}px`;
-                    icon.style.boxSizing = "content-box";
-                    let fitted = false;
-                    fitIconBackground = () => {
-                        if (fitted) {
-                            return;
-                        }
-                        const padding = size / 3;
-                        const width = icon.offsetWidth - padding * 2;
-                        const height = icon.offsetHeight - padding * 2;
-                        if (width <= 0 || height <= 0) {
-                            return;
-                        }
-                        fitted = true;
-                        const longest = Math.max(width, height);
-                        const difference = (longest - Math.min(width, height)) / longest;
-                        if (difference > ICON_BACKGROUND_UNIFORM_TOLERANCE) {
-                            return;
-                        }
-                        icon.style.minWidth = `${longest}px`;
-                        icon.style.minHeight = `${longest}px`;
-                        this.viewer.scene.requestRender();
-                    };
-                }
-                if (this.options.iconScale === 0) {
-                    icon.style.display = "none";
-                }
+                const built = this.buildIcon(this.options, counter);
+                const icon = iconElement = built.icon;
+                fitIconBackground = built.fit;
                 makeClickable(icon);
                 // Keep badges outside the glyph so font classes and image masks cannot affect them.
                 iconContainer = document.createElement("span");
-                iconContainer.style.cssText = "position:relative;display:inline-flex;flex:none;";
-                iconContainer.appendChild(icon);
+                iconContainer.style.cssText = "position:relative;display:inline-flex;flex:none;align-items:center;";
+                icon.style.position = "relative";
+                iconStack = document.createElement("span");
+                iconStack.className = "entity-label-icon-stack";
+                iconStack.style.cssText = "display:none;gap:2px;align-items:center;justify-items:center;flex:none;";
+                makeClickable(iconStack);
+                iconContainer.append(iconStack, icon);
                 content.appendChild(iconContainer);
             }
             if (presentation !== "icon") {
@@ -6546,7 +6530,7 @@ var EntityLabel;
                 if (presentation === "text")
                     makeClickable(textElement);
                 content.appendChild(textElement);
-                if ((_q = this.options.cluster) === null || _q === void 0 ? void 0 : _q.enabled) {
+                if ((_m = this.options.cluster) === null || _m === void 0 ? void 0 : _m.enabled) {
                     sourceText = document.createElement("span");
                     sourceText.className = "entity-label-source-text";
                     sourceText.setAttribute("aria-hidden", "true");
@@ -6587,7 +6571,7 @@ var EntityLabel;
                     ele.appendChild(countElement);
                 }
                 ele.className = "entity-label";
-                ele.dataset.entityId = ((_r = this.rego) === null || _r === void 0 ? void 0 : _r.entityId) || "";
+                ele.dataset.entityId = ((_o = this.rego) === null || _o === void 0 ? void 0 : _o.entityId) || "";
                 ele.dataset.presentation = presentation;
                 if (this.groupId) {
                     ele.dataset.groupId = this.groupId;
@@ -6703,6 +6687,41 @@ var EntityLabel;
                     run, side: (rightwards ? "right" : "left")
                 };
             };
+            /*
+             * The on-screen centre and half-size of a point or billboard glyph, relative to its projected position.
+             * Read every frame, since styling and selection can rescale a billboard in place.
+             */
+            const measureIcon = () => {
+                var _a;
+                if (!normalLeader || !(visual instanceof Entity)) {
+                    return null;
+                }
+                if (visual.point) {
+                    const size = EnsureNumber(getValue(this.viewer, visual.point.pixelSize), 1) +
+                        EnsureNumber(getValue(this.viewer, visual.point.outlineWidth), 0) * 2;
+                    return size > 0 ? { x: 0, y: 0, radius: size / 2 } : null;
+                }
+                if (!visual.billboard) {
+                    return null;
+                }
+                const billboard = visual.billboard;
+                const scale = EnsureNumber(getValue(this.viewer, billboard.scale), 1);
+                // Icon billboards only record their image height; generated circles set both sides.
+                const height = EnsureNumber((_a = getValue(this.viewer, billboard.height)) !== null && _a !== void 0 ? _a : billboard._billboardSize, 0) * scale;
+                const width = EnsureNumber(getValue(this.viewer, billboard.width), height / scale) * scale;
+                if (!(height > 0) || !(width > 0)) {
+                    return null;
+                }
+                const vertical = getValue(this.viewer, billboard.verticalOrigin);
+                const horizontal = getValue(this.viewer, billboard.horizontalOrigin);
+                const offset = getValue(this.viewer, billboard.pixelOffset);
+                return {
+                    x: ((offset === null || offset === void 0 ? void 0 : offset.x) || 0) + (horizontal === HorizontalOrigin.LEFT ? width / 2 : horizontal === HorizontalOrigin.RIGHT ? -width / 2 : 0),
+                    y: ((offset === null || offset === void 0 ? void 0 : offset.y) || 0) + (vertical === VerticalOrigin.BOTTOM || vertical === VerticalOrigin.BASELINE ? -height / 2 :
+                        vertical === VerticalOrigin.TOP ? height / 2 : 0),
+                    radius: Math.max(width, height) / 2
+                };
+            };
             let cursorMotion = this.cursorMotion;
             const project = () => {
                 var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t;
@@ -6769,9 +6788,13 @@ var EntityLabel;
                 this.cursorMotion = cursorMotion;
                 const cursorAmount = cursorMotion.amount;
                 leader = normalLeader || cursorAmount > 0;
-                let x = ((_l = transientPivot === null || transientPivot === void 0 ? void 0 : transientPivot.x) !== null && _l !== void 0 ? _l : anchor.x) + pixelOffset.x;
-                let y = ((_m = transientPivot === null || transientPivot === void 0 ? void 0 : transientPivot.y) !== null && _m !== void 0 ? _m : anchor.y) + pixelOffset.y;
-                if (cursorAmount > 0) {
+                // An icon keeps its callout centred on the glyph rather than following the cursor across it.
+                const icon = measureIcon();
+                const iconRing = icon ? Math.max(ICON_RING_MIN, icon.radius + ICON_RING_PADDING) : 0;
+                const pivot = icon ? undefined : transientPivot;
+                let x = ((_l = pivot === null || pivot === void 0 ? void 0 : pivot.x) !== null && _l !== void 0 ? _l : anchor.x) + (icon || pixelOffset).x;
+                let y = ((_m = pivot === null || pivot === void 0 ? void 0 : pivot.y) !== null && _m !== void 0 ? _m : anchor.y) + (icon || pixelOffset).y;
+                if (cursorAmount > 0 && !icon) {
                     // A leader-less label starts centred on its anchor; preserve that box as it lifts away.
                     if (!normalLeader) {
                         x -= ele.offsetWidth / layer.coordinates.scaleX / 2;
@@ -6809,9 +6832,11 @@ var EntityLabel;
                     if (cursorAmount > 0) {
                         leaderLength += (96 - leaderLength) * cursorAmount;
                     }
+                    // Measured from the ring, so the visible stem is the same length whatever the glyph's size.
+                    leaderLength += iconRing;
                     y = anchorY - leaderLength;
                 }
-                else if (hover && !reused) {
+                else if (hover && !reused && !icon) {
                     x = hover.x + pixelOffset.x;
                     y = hover.y + pixelOffset.y - 24;
                 }
@@ -6863,6 +6888,7 @@ var EntityLabel;
                     viewportWidth: this.viewer.canvas.clientWidth,
                     id: this.id, entityKey: ((_s = this.rego) === null || _s === void 0 ? void 0 : _s.entityId) ? JSON.stringify([this.rego.entityId, this.rego.menuItemId || "", this.Transient && !this.Persistent ? "hover" : ""]) : undefined,
                     entityId: (_t = this.rego) === null || _t === void 0 ? void 0 : _t.entityId, group: this.groupId, x, y, width, height, anchorX, anchorY, depth, leaderLength, leaderRun, leaderSide, distance,
+                    iconRadius: icon === null || icon === void 0 ? void 0 : icon.radius,
                     // Priority shows the hovered member individually without dragging its cluster along.
                     opacity, priority: hover || cursorAmount > 0 || (state === null || state === void 0 ? void 0 : state.highlighted) ? 1 : 0, options: this.options, text: originalText, clusterBounds
                 };
@@ -6870,7 +6896,7 @@ var EntityLabel;
             let displacement = { x: 0, y: 0 };
             let nudge = { x: 0, y: 0, fromX: 0, fromY: 0, targetX: 0, targetY: 0, start: 0 };
             const apply = (placement) => {
-                var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0;
+                var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2;
                 const show = (placement === null || placement === void 0 ? void 0 : placement.visible) && placement.opacity > 0;
                 clickEntityIds = show ? placement.entityIds : [];
                 ele.style.visibility = show ? "visible" : "hidden";
@@ -6907,6 +6933,29 @@ var EntityLabel;
                     this.viewer.scene.requestRender();
                 }
                 fitIconBackground === null || fitIconBackground === void 0 ? void 0 : fitIconBackground();
+                const stack = JSON.stringify(placement.icons || []);
+                if (iconStack && stack !== displayedStack) {
+                    displayedStack = stack;
+                    const looks = ((_b = placement.icons) === null || _b === void 0 ? void 0 : _b.length) ? [iconLook(this.options), ...placement.icons] : [];
+                    // One small size for all, so no icon in the arrangement reads as more important than another.
+                    const size = (this.options.iconSize || 24) * ((_c = this.options.iconScale) !== null && _c !== void 0 ? _c : 1) * ICON_STACK_SCALE;
+                    const built = looks.map(look => this.buildIcon({ ...look, iconSize: size }, counter));
+                    // Two sit side by side; three make a triangle with the representative on top.
+                    iconStack.style.gridTemplateColumns = built.length === 3 ? "auto auto" : `repeat(${built.length}, auto)`;
+                    if (built.length === 3) {
+                        built[0].icon.style.gridColumn = "1 / span 2";
+                    }
+                    iconStack.replaceChildren(...built.map(({ icon }) => icon));
+                    iconStack.style.display = built.length ? "inline-grid" : "none";
+                    // The glyph stays measurable, since cluster membership is taken from its footprint.
+                    iconElement.style.visibility = built.length ? "hidden" : "";
+                    iconElement.style.position = built.length ? "absolute" : "relative";
+                    stackedFits = built.map(({ fit }) => fit).filter(Boolean);
+                    // The stack widens the label, which the next frame has to measure.
+                    this.viewer.scene.requestRender();
+                }
+                for (const fit of stackedFits)
+                    fit();
                 if (iconContainer) {
                     const badgeWidth = countElement.offsetWidth;
                     const iconWidth = iconElement.offsetWidth;
@@ -6922,36 +6971,43 @@ var EntityLabel;
                 // Summary and badge changes must fit on their first visible frame, including after resize.
                 const ring = this.options.anchorRing;
                 const pointer = (layer.pointer || (cursorMotion.target ? cursorMotion.position : undefined) || (this.Transient && !this.Persistent ?
-                    (this.hoverFade.to === 0 ? this.retainedHoverPosition : (_b = this.visualRegister) === null || _b === void 0 ? void 0 : _b.GetLabelHoverPosition((_c = this.rego) === null || _c === void 0 ? void 0 : _c.entityId, (_d = this.rego) === null || _d === void 0 ? void 0 : _d.menuItemId)) : undefined));
-                const hovered = pointer && Math.hypot(pointer.x - frame.anchorX, pointer.y - frame.anchorY) <= ((_e = ring === null || ring === void 0 ? void 0 : ring.hoverDistance) !== null && _e !== void 0 ? _e : 24);
-                const normalRadius = (!leader || (ring === null || ring === void 0 ? void 0 : ring.enabled) === false ? 0 : Math.max(frame.distance <= ((_f = ring === null || ring === void 0 ? void 0 : ring.nearDistance) !== null && _f !== void 0 ? _f : 100) ? ((_g = ring === null || ring === void 0 ? void 0 : ring.nearRadius) !== null && _g !== void 0 ? _g : 10) : 0, hovered ? ((_h = ring === null || ring === void 0 ? void 0 : ring.hoverRadius) !== null && _h !== void 0 ? _h : (this.Transient && !this.Persistent ? 15.4 : 22)) : 0));
+                    (this.hoverFade.to === 0 ? this.retainedHoverPosition : (_d = this.visualRegister) === null || _d === void 0 ? void 0 : _d.GetLabelHoverPosition((_e = this.rego) === null || _e === void 0 ? void 0 : _e.entityId, (_f = this.rego) === null || _f === void 0 ? void 0 : _f.menuItemId)) : undefined));
+                const iconRing = frame.iconRadius ? Math.max(ICON_RING_MIN, frame.iconRadius + ICON_RING_PADDING) : 0;
+                const hovered = pointer && Math.hypot(pointer.x - frame.anchorX, pointer.y - frame.anchorY) <= Math.max((_g = ring === null || ring === void 0 ? void 0 : ring.hoverDistance) !== null && _g !== void 0 ? _g : 24, iconRing);
+                const normalRadius = (!leader || (ring === null || ring === void 0 ? void 0 : ring.enabled) === false ? 0 : Math.max(frame.distance <= ((_h = ring === null || ring === void 0 ? void 0 : ring.nearDistance) !== null && _h !== void 0 ? _h : 100) ? ((_j = ring === null || ring === void 0 ? void 0 : ring.nearRadius) !== null && _j !== void 0 ? _j : 10) : 0, hovered ? ((_k = ring === null || ring === void 0 ? void 0 : ring.hoverRadius) !== null && _k !== void 0 ? _k : (this.Transient && !this.Persistent ? 15.4 : 22)) : 0));
                 const targetRadius = normalRadius + (15.4 - normalRadius) * cursorMotion.amount;
+                // Around a glyph the ring keeps the glyph's size and only fades its stroke in, so it never covers the icon.
+                const targetOuter = iconRing || targetRadius || 2.5;
+                const targetInner = iconRing ? (targetRadius > 0 ? iconRing - 2 : iconRing) : Math.max(0, targetRadius - 2);
                 const now = Date.now();
-                const duration = (_j = ring === null || ring === void 0 ? void 0 : ring.transitionDuration) !== null && _j !== void 0 ? _j : 200;
+                const duration = (_l = ring === null || ring === void 0 ? void 0 : ring.transitionDuration) !== null && _l !== void 0 ? _l : 200;
                 const sharedRing = this.Transient && !this.Persistent && this.hoverFade.to === 1 ? this.hoverRingState : undefined;
                 let ringAnimation = sharedRing ? sharedRing.animation : this.ringAnimation;
                 if (!ringAnimation) {
-                    ringAnimation = { target: 0, start: now, outer: 2.5, inner: 0, fromOuter: 2.5, fromInner: 0 };
+                    const outer = iconRing || 2.5;
+                    const inner = iconRing;
+                    ringAnimation = { target: outer, targetInner: inner, start: now, outer, inner, fromOuter: outer, fromInner: inner };
                 }
                 const animateRing = () => {
                     const progress = duration > 0 ? Math.min(1, Math.max(0, (now - ringAnimation.start) / duration)) : 1;
                     const eased = progress * progress * (3 - 2 * progress);
-                    ringAnimation.outer = ringAnimation.fromOuter + ((ringAnimation.target || 2.5) - ringAnimation.fromOuter) * eased;
-                    ringAnimation.inner = ringAnimation.fromInner + (Math.max(0, ringAnimation.target - 2) - ringAnimation.fromInner) * eased;
+                    ringAnimation.outer = ringAnimation.fromOuter + (ringAnimation.target - ringAnimation.fromOuter) * eased;
+                    ringAnimation.inner = ringAnimation.fromInner + (ringAnimation.targetInner - ringAnimation.fromInner) * eased;
                     return progress;
                 };
                 animateRing();
-                if (ringAnimation.target !== targetRadius) {
+                if (ringAnimation.target !== targetOuter || ringAnimation.targetInner !== targetInner) {
                     ringAnimation = {
                         ...ringAnimation,
-                        target: targetRadius,
+                        target: targetOuter,
+                        targetInner,
                         start: now,
                         fromOuter: ringAnimation.outer,
                         fromInner: ringAnimation.inner
                     };
                 }
                 // Animate the hole and stem together; no CSS transition may lag behind a moving world anchor.
-                if (animateRing() < 1 && (ringAnimation.fromOuter !== (targetRadius || 2.5) || ringAnimation.fromInner !== Math.max(0, targetRadius - 2))) {
+                if (animateRing() < 1 && (ringAnimation.fromOuter !== targetOuter || ringAnimation.fromInner !== targetInner)) {
                     this.viewer.scene.requestRender();
                 }
                 this.ringAnimation = ringAnimation;
@@ -6966,19 +7022,19 @@ var EntityLabel;
                 if (leader && angled) {
                     // The declutter owns the side; the fit only says which one had the room to begin with.
                     const run = Math.max(ANGLED_LEADER_RUN, radius + 4);
-                    const side = (_l = (_k = placement.textSide) !== null && _k !== void 0 ? _k : frame.leaderSide) !== null && _l !== void 0 ? _l : "right";
+                    const side = (_o = (_m = placement.textSide) !== null && _m !== void 0 ? _m : frame.leaderSide) !== null && _o !== void 0 ? _o : "right";
                     const beside = side === "left" ? frame.anchorX - run - width : frame.anchorX + run;
                     position.x = Math.max(0, Math.min(beside, this.viewer.canvas.clientWidth - width));
                 }
                 else if (leader && placement.textSide === "left") {
                     position.x = Math.max(0, Math.min(frame.anchorX - width, this.viewer.canvas.clientWidth - width));
                 }
-                const gap = (_o = (_m = this.options.pointerAvoidance) === null || _m === void 0 ? void 0 : _m.gap) !== null && _o !== void 0 ? _o : 12;
+                const gap = (_q = (_p = this.options.pointerAvoidance) === null || _p === void 0 ? void 0 : _p.gap) !== null && _q !== void 0 ? _q : 12;
                 const containsPointer = (x, y, margin) => {
                     return pointer && pointer.x >= x - margin && pointer.x <= x + width + margin && pointer.y >= y - margin && pointer.y <= y + height + margin;
                 };
                 const passive = !selectOnClick || !this.visualRegister;
-                if (passive && ((_p = this.options.pointerAvoidance) === null || _p === void 0 ? void 0 : _p.enabled) !== false && pointer &&
+                if (passive && ((_r = this.options.pointerAvoidance) === null || _r === void 0 ? void 0 : _r.enabled) !== false && pointer &&
                     (containsPointer(position.x, position.y, gap) || containsPointer(position.x + displacement.x, position.y + displacement.y, gap))) {
                     if (containsPointer(position.x + displacement.x, position.y + displacement.y, 0)) {
                         // Choose against the original box and retain the offset until the pointer leaves both boxes.
@@ -6996,7 +7052,7 @@ var EntityLabel;
                 else {
                     displacement = { x: 0, y: 0 };
                 }
-                const nudgeDuration = (_r = (_q = this.options.pointerAvoidance) === null || _q === void 0 ? void 0 : _q.transitionDuration) !== null && _r !== void 0 ? _r : 200;
+                const nudgeDuration = (_t = (_s = this.options.pointerAvoidance) === null || _s === void 0 ? void 0 : _s.transitionDuration) !== null && _t !== void 0 ? _t : 200;
                 const animateNudge = () => {
                     const progress = now < nudge.start ? 0 : nudgeDuration > 0 ? Math.min(1, (now - nudge.start) / nudgeDuration) : 1;
                     const eased = progress * progress * (3 - 2 * progress);
@@ -7012,7 +7068,7 @@ var EntityLabel;
                         fromY: nudge.y,
                         targetX: displacement.x,
                         targetY: displacement.y,
-                        start: now + ((_t = (_s = this.options.pointerAvoidance) === null || _s === void 0 ? void 0 : _s.delay) !== null && _t !== void 0 ? _t : 180)
+                        start: now + ((_v = (_u = this.options.pointerAvoidance) === null || _u === void 0 ? void 0 : _u.delay) !== null && _v !== void 0 ? _v : 180)
                     };
                 }
                 if (animateNudge() < 1 && (nudge.fromX !== nudge.targetX || nudge.fromY !== nudge.targetY)) {
@@ -7022,9 +7078,8 @@ var EntityLabel;
                 position.y += nudge.y;
                 ele.style.left = `${coordinates.x + position.x * coordinates.scaleX}px`;
                 ele.style.top = `${coordinates.y + position.y * coordinates.scaleY}px`;
-                const clickTarget = content.querySelector('[role="button"]');
-                if (clickTarget) {
-                    clickTarget.setAttribute("aria-label", placement.members.length ? `Select ${placement.entityIds.length} entities` : `Select ${(_v = (_u = this.options.text) !== null && _u !== void 0 ? _u : text) !== null && _v !== void 0 ? _v : (_w = this.rego) === null || _w === void 0 ? void 0 : _w.entityId}`);
+                for (const clickTarget of Array.from(content.querySelectorAll('[role="button"]'))) {
+                    clickTarget.setAttribute("aria-label", placement.members.length ? `Select ${placement.entityIds.length} entities` : `Select ${(_x = (_w = this.options.text) !== null && _w !== void 0 ? _w : text) !== null && _x !== void 0 ? _x : (_y = this.rego) === null || _y === void 0 ? void 0 : _y.entityId}`);
                 }
                 if (leader) {
                     const nodeRadius = ringAnimation.outer;
@@ -7064,13 +7119,13 @@ var EntityLabel;
                     // Keep the stem inside the 126-degree arc, away from antialiased endpoints.
                     const arcFraction = 0.35;
                     const rotationLimit = Math.PI * arcFraction - Math.PI / 30;
-                    const targetOffset = hovered ? Math.max(-rotationLimit, Math.min(rotationLimit, wrappedAngle)) : ((_x = ringAnimation.arcOffset) !== null && _x !== void 0 ? _x : 0);
+                    const targetOffset = hovered ? Math.max(-rotationLimit, Math.min(rotationLimit, wrappedAngle)) : ((_z = ringAnimation.arcOffset) !== null && _z !== void 0 ? _z : 0);
                     const targetOpen = cursorMotion.target || (hovered && (ring === null || ring === void 0 ? void 0 : ring.enabled) !== false && targetRadius > 0) ? 1 : 0;
-                    const elapsed = Math.min(32, Math.max(0, now - ((_y = ringAnimation.arcTime) !== null && _y !== void 0 ? _y : now)));
+                    const elapsed = Math.min(32, Math.max(0, now - ((_0 = ringAnimation.arcTime) !== null && _0 !== void 0 ? _0 : now)));
                     const blend = duration > 0 ? 1 - Math.exp(-elapsed / (duration / 3)) : 1;
                     const approach = (value, target) => Math.abs(value - target) < 0.001 ? target : value + (target - value) * blend;
-                    ringAnimation.arcOffset = approach((_z = ringAnimation.arcOffset) !== null && _z !== void 0 ? _z : 0, targetOffset);
-                    ringAnimation.arcOpen = approach((_0 = ringAnimation.arcOpen) !== null && _0 !== void 0 ? _0 : 0, targetOpen);
+                    ringAnimation.arcOffset = approach((_1 = ringAnimation.arcOffset) !== null && _1 !== void 0 ? _1 : 0, targetOffset);
+                    ringAnimation.arcOpen = approach((_2 = ringAnimation.arcOpen) !== null && _2 !== void 0 ? _2 : 0, targetOpen);
                     ringAnimation.arcTime = now;
                     if (ringAnimation.arcOffset !== targetOffset || ringAnimation.arcOpen !== targetOpen) {
                         this.viewer.scene.requestRender();
@@ -7123,6 +7178,123 @@ var EntityLabel;
                 }, 2500);
             });
         }
+        /*
+         * Builds one icon glyph from label options, with its background chip when asked for.
+         *
+         * The returned fit squares the chip off once the glyph has a measurable size.
+         */
+        buildIcon(options, counter) {
+            var _a, _b, _c;
+            let fit;
+            const icon = document.createElement("span");
+            icon.className = "entity-label-icon";
+            icon.style.cssText = `font-size:${(options.iconSize || 24) * ((_a = options.iconScale) !== null && _a !== void 0 ? _a : 1)}px;line-height:1;`;
+            icon.style.textShadow = "0 1px 2px rgba(0, 0, 0, 0.25)";
+            const iconColor = typeof options.iconColor === "string" ? options.iconColor : undefined;
+            const iconBackground = options.iconBackground && options.iconScale !== 0;
+            if (iconColor) {
+                icon.style.color = iconColor;
+            }
+            if (options.iconUrl) {
+                const image = document.createElement("img");
+                image.draggable = false;
+                image.alt = options.icon || "";
+                const scale = (_b = options.iconScale) !== null && _b !== void 0 ? _b : 1;
+                const size = options.iconSize;
+                const svgNs = "http://www.w3.org/2000/svg";
+                const tint = iconColor ? document.createElementNS(svgNs, "svg") : null;
+                const painted = tint ? document.createElementNS(svgNs, "image") : null;
+                const inked = tint ? document.createElementNS(svgNs, "rect") : null;
+                if (tint) {
+                    const maskId = `entity-label-tint-${++tintCounter}`;
+                    const mask = document.createElementNS(svgNs, "mask");
+                    mask.setAttribute("id", maskId);
+                    mask.setAttribute("maskUnits", "userSpaceOnUse");
+                    painted.setAttribute("href", options.iconUrl);
+                    painted.setAttribute("preserveAspectRatio", "xMidYMid meet");
+                    mask.appendChild(painted);
+                    inked.setAttribute("fill", iconColor);
+                    inked.setAttribute("mask", `url(#${maskId})`);
+                    tint.append(mask, inked);
+                    tint.style.display = "block";
+                    icon.style.display = "inline-flex";
+                    icon.appendChild(tint);
+                }
+                const resize = () => {
+                    if (this.disposed || this.counter !== counter) {
+                        return;
+                    }
+                    const intrinsic = options.iconScale != null && size == null;
+                    const width = (intrinsic ? image.naturalWidth || 24 : size || 24) * scale;
+                    const height = (intrinsic ? image.naturalHeight || 24 : size || 24) * scale;
+                    if (tint) {
+                        tint.setAttribute("viewBox", `0 0 ${width} ${height}`);
+                        for (const node of [tint, painted, inked]) {
+                            node.setAttribute("width", String(width));
+                            node.setAttribute("height", String(height));
+                        }
+                    }
+                    else {
+                        image.style.width = `${width}px`;
+                        image.style.height = `${height}px`;
+                    }
+                    this.viewer.scene.requestRender();
+                };
+                image.onload = resize;
+                resize();
+                image.src = options.iconUrl;
+                if (!tint) {
+                    icon.appendChild(image);
+                }
+            }
+            else if (typeof options.iconClass === "string" && options.iconClass) {
+                icon.className = `entity-label-icon ${options.iconClass}`;
+            }
+            else {
+                icon.textContent = options.icon || "●";
+            }
+            if (iconBackground) {
+                const color = Color.fromCssColorString(iconColor || "white") || Color.WHITE;
+                const luminance = 0.2126 * color.red + 0.7152 * color.green + 0.0722 * color.blue;
+                const background = (luminance > 0.5 ? color.darken(ICON_BACKGROUND_BLEND, new Color()) :
+                    color.brighten(ICON_BACKGROUND_BLEND, new Color()));
+                const size = (options.iconSize || 24) * ((_c = options.iconScale) !== null && _c !== void 0 ? _c : 1);
+                icon.style.backgroundColor = background.withAlpha(ICON_BACKGROUND_ALPHA).toCssColorString();
+                icon.style.borderRadius = "50%";
+                icon.style.padding = `${size / 3}px`;
+                icon.style.display = "inline-flex";
+                icon.style.alignItems = "center";
+                icon.style.justifyContent = "center";
+                icon.style.minWidth = `${size}px`;
+                icon.style.minHeight = `${size}px`;
+                icon.style.boxSizing = "content-box";
+                let fitted = false;
+                fit = () => {
+                    if (fitted) {
+                        return;
+                    }
+                    const padding = size / 3;
+                    const width = icon.offsetWidth - padding * 2;
+                    const height = icon.offsetHeight - padding * 2;
+                    if (width <= 0 || height <= 0) {
+                        return;
+                    }
+                    fitted = true;
+                    const longest = Math.max(width, height);
+                    const difference = (longest - Math.min(width, height)) / longest;
+                    if (difference > ICON_BACKGROUND_UNIFORM_TOLERANCE) {
+                        return;
+                    }
+                    icon.style.minWidth = `${longest}px`;
+                    icon.style.minHeight = `${longest}px`;
+                    this.viewer.scene.requestRender();
+                };
+            }
+            if (options.iconScale === 0) {
+                icon.style.display = "none";
+            }
+            return { icon, fit };
+        }
         /**
          * Removes label from the viewer and unsubscribes from events.
          */
@@ -16796,9 +16968,6 @@ class EntityGatherer {
         // Last date-time range taken from the clock.
         this.lastDateTimeMin = null;
         this.lastDateTimeMax = null;
-        // Entity ID -> last resolved date time.
-        // Helps determine if a slow resolved request can still be applied while we wait for the next one.
-        this.lastFoundDateTimes = new Map();
         // ID of Entity IDs that need to be requested.
         this.eIdQueue = [];
         // Membership mirror of eIdQueue for quick checks.
@@ -16830,8 +16999,12 @@ class EntityGatherer {
         // Unsubscribes the view monitor listener that queues what the camera has moved onto.
         this.monitorRemoval = null;
         // Indicates a tick is active.
-        // When true, we won't bother calling onTick again.
+        // When true, a new tick is not started; it is noted in pendingTick and run once this one ends.
         this.runningTick = false;
+        // A tick was asked for while one was running, so another is owed once it finishes.
+        this.pendingTick = false;
+        // The debounce every clock change goes through, kept so a tick owed after a running one does too.
+        this.tickDelay = null;
         // Entity ID -> Entity blob.
         // This is a tool that lets developers set their own JSON blobs instead of requesting data from API.
         this.entityDataOverrides = new Map();
@@ -16895,11 +17068,13 @@ class EntityGatherer {
             let tickDelay = new DelayQueue(() => {
                 this.onTick(false);
             }, 250, true);
+            this.tickDelay = tickDelay;
             this.hDisposals.push(() => {
                 if (tickDelay) {
                     tickDelay.Dispose();
                 }
                 tickDelay = null;
+                this.tickDelay = null;
             });
             // React to clock changes and request new Entities.
             let prevTime = null;
@@ -16939,7 +17114,6 @@ class EntityGatherer {
         this.priorityCount = 0;
         this.lastOrderFocus = null;
         this.allEIds.clear();
-        this.lastFoundDateTimes.clear();
         this.everFound.clear();
         this.clearIndex();
         this.lastDateTime = null;
@@ -17301,7 +17475,6 @@ class EntityGatherer {
         this.eIdQueued.clear();
         this.priorityCount = 0;
         this.allEIds.clear();
-        this.lastFoundDateTimes.clear();
         this.everFound.clear();
         this.clearIndex();
         this.entityDataOverrides.clear();
@@ -17317,7 +17490,13 @@ class EntityGatherer {
         }
     }
     onTick(force) {
-        if (this.runningTick || this.disposed) {
+        if (this.disposed) {
+            return;
+        }
+        if (this.runningTick) {
+            if (this.historic) {
+                this.pendingTick = true;
+            }
             return;
         }
         const rTime = this.viewer.clock.currentTime.toString();
@@ -17325,10 +17504,16 @@ class EntityGatherer {
             return;
         }
         this.lastDateTime = rTime;
+        // Whether the clock has left the moment this tick is reading.
+        const movedOn = () => this.historic && this.viewer.clock.currentTime.toString() !== rTime;
         (async () => {
             this.runningTick = true;
+            this.pendingTick = false;
             this.placeStragglers();
             let rerun = false;
+            let interrupted = false;
+            // Batch's answer is applied while the next batch is being read.
+            const applying = [];
             try {
                 const handleResponse = async (requestedBatch, entities) => {
                     var _a, _b, _c, _d;
@@ -17392,45 +17577,7 @@ class EntityGatherer {
                             api: this.api
                         })).tags;
                     }
-                    // 0 = rTime is still the current time.
-                    // 1 = rTime is in the future.
-                    // -1 = rTime is in the past.
-                    let changeDir = 0;
-                    if (this.lastDateTime !== this.viewer.clock.currentTime.toString()) {
-                        changeDir = this.lastDateTime < this.viewer.clock.currentTime.toString() ? 1 : -1;
-                    }
-                    let toEmit;
-                    if (this.historic) {
-                        // We can emit Entities if the last resolved time (per Entity) isn't newer than rTime.
-                        // We compare using the changeDir to determine if we should emit or not.
-                        toEmit = resolvedEntities.filter((e) => {
-                            var _a;
-                            const entityId = ((_a = e === null || e === void 0 ? void 0 : e.Bruce) === null || _a === void 0 ? void 0 : _a.ID) || (e === null || e === void 0 ? void 0 : e.id);
-                            const lastFoundDateTime = this.lastFoundDateTimes.get(entityId);
-                            if (lastFoundDateTime) {
-                                if (changeDir === 1) {
-                                    return lastFoundDateTime <= rTime;
-                                }
-                                else if (changeDir === -1) {
-                                    return lastFoundDateTime >= rTime;
-                                }
-                            }
-                            return true;
-                        });
-                        // Update the last found date times for the filtered Entities.
-                        toEmit.forEach((e) => {
-                            var _a;
-                            const entityId = ((_a = e === null || e === void 0 ? void 0 : e.Bruce) === null || _a === void 0 ? void 0 : _a.ID) || (e === null || e === void 0 ? void 0 : e.id);
-                            if (entityId) {
-                                this.lastFoundDateTimes.set(entityId, rTime);
-                            }
-                        });
-                    }
-                    else {
-                        // If we're not historic, we can just emit everything.
-                        toEmit = resolvedEntities;
-                    }
-                    this.emitEntities(toEmit, tags);
+                    this.emitEntities(resolvedEntities, tags);
                 };
                 const QUEUE_BATCH_SIZE = 500;
                 const requestedIds = new Set();
@@ -17439,7 +17586,8 @@ class EntityGatherer {
                     const total = this.eIdQueue.length;
                     let done = 0;
                     while (this.eIdQueue.length && !this.disposed) {
-                        if (this.historic && this.lastDateTime !== rTime) {
+                        if (movedOn()) {
+                            interrupted = true;
                             break;
                         }
                         this.orderQueueByCamera();
@@ -17455,7 +17603,7 @@ class EntityGatherer {
                             api: this.api,
                             maxSearchTimeSec: 60 * 2
                         });
-                        handleResponse(batch, entities);
+                        applying.push(handleResponse(batch, entities));
                         for (let i = 0; i < batch.length; i++) {
                             requestedIds.add(batch[i]);
                         }
@@ -17487,7 +17635,8 @@ class EntityGatherer {
                     // The near ones are resolved first out of whatever the view still reaches.
                     allEIds = this.bandIds(allEIds);
                     while (allEIds.length && !this.disposed && !this.eIdQueue.length) {
-                        if (this.historic && this.lastDateTime !== rTime) {
+                        if (movedOn()) {
+                            interrupted = true;
                             break;
                         }
                         const batch = allEIds.splice(0, QUEUE_BATCH_SIZE);
@@ -17498,7 +17647,7 @@ class EntityGatherer {
                             api: this.api,
                             maxSearchTimeSec: 60 * 2
                         });
-                        handleResponse(batch, entities);
+                        applying.push(handleResponse(batch, entities));
                         for (let i = 0; i < batch.length; i++) {
                             requestedIds.add(batch[i]);
                         }
@@ -17513,10 +17662,32 @@ class EntityGatherer {
                 console.error(e);
             }
             finally {
+                // Only a historic answer can be overtaken by a newer moment, so nothing else waits.
+                if (this.historic && applying.length) {
+                    await Promise.all(applying.map((pending) => pending.catch((e) => console.error(e))));
+                }
                 this.runningTick = false;
             }
-            if (rerun) {
+            // A moment read only in part is forgotten, so coming back to it reads it again in full.
+            if (interrupted && this.lastDateTime === rTime) {
+                this.lastDateTime = null;
+            }
+            if (this.disposed) {
+                return;
+            }
+            // Leftovers at the same moment carry straight on, as they always have.
+            if (rerun && !interrupted) {
                 this.onTick(true);
+                return;
+            }
+            if (interrupted || this.pendingTick || movedOn()) {
+                this.pendingTick = false;
+                if (this.tickDelay) {
+                    this.tickDelay.Call();
+                }
+                else {
+                    this.onTick(false);
+                }
             }
         })();
     }
@@ -49206,7 +49377,7 @@ var EntityRenderEngine;
     }
     EntityRenderEngine.GetGraphicShapeId = GetGraphicShapeId;
     async function Render(params) {
-        var _a, _b, _c;
+        var _a, _b, _c, _d, _e;
         const groupRenderParams = {
             apiGetter: params.apiGetter,
             viewer: params.viewer,
@@ -49383,10 +49554,20 @@ var EntityRenderEngine;
                     polygons.push(entity);
                     continue;
                 }
+                // Present when the gate above chose to reuse this entity's graphic.
+                const existingRoot = cEntities.get(entity.Bruce.ID);
+                const existingParts = new Map();
+                (_d = existingRoot === null || existingRoot === void 0 ? void 0 : existingRoot._siblingGraphics) === null || _d === void 0 ? void 0 : _d.forEach((part) => {
+                    if (part._multiPartIndex != null) {
+                        existingParts.set(part._multiPartIndex, part);
+                    }
+                });
+                const partRendered = new Map();
+                const partIndexes = new Map();
                 const pParams = {
                     ...groupRenderParams,
                     entities: [],
-                    rendered: cEntities
+                    rendered: partRendered
                 };
                 pParams.entitiesHistoric = params.entitiesHistoric;
                 const zoomItem = pParams.zoomItems[entity.Bruce.ID];
@@ -49402,39 +49583,59 @@ var EntityRenderEngine;
                     };
                     pParams.zoomItems[subEntity.Bruce.ID] = zoomItem;
                     pParams.entities.push(subEntity);
-                }
-                const cPoly = await Polygon.RenderGroup(pParams);
-                Array.from(cPoly.keys()).forEach((key) => {
-                    if (cPoly.get(key)) {
-                        pParams.entities = pParams.entities.filter((e) => e.Bruce.ID != key);
-                    }
-                });
-                let rendered = Array.from(cPoly.values());
-                const cLines = await Polyline.RenderGroup(pParams);
-                Array.from(cLines.keys()).forEach((key) => {
-                    if (cLines.get(key)) {
+                    partIndexes.set(subEntity.Bruce.ID, j);
+                    const existingPart = existingParts.get(j);
+                    if (existingPart) {
+                        // An engine preparing a reused graphic gathers everything connected to it, so a part still
+                        // attached to its root would have every other part evicted from the scene.
+                        existingPart._parentEntity = null;
+                        partRendered.set(subEntity.Bruce.ID, existingPart);
+                    }
+                }
+                const rendered = [];
+                const collect = (results) => {
+                    results.forEach((cEntity, key) => {
+                        if (!cEntity) {
+                            return;
+                        }
+                        cEntity._multiPartIndex = partIndexes.get(key);
+                        rendered.push(cEntity);
                         pParams.entities = pParams.entities.filter((e) => e.Bruce.ID != key);
-                    }
-                });
-                rendered = rendered.concat(Array.from(cLines.values()));
+                    });
+                };
+                collect(await Polygon.RenderGroup(pParams));
+                collect(await Polyline.RenderGroup(pParams));
                 // We'll only render points when there's no other geometry.
                 // Generally speaking when polygons/polylines are drawn, points are only drawn because of invalid data.
                 if (!rendered.length) {
-                    const cPoints = await Point.RenderGroup(pParams);
-                    rendered = rendered.concat(Array.from(cPoints.values()));
+                    collect(await Point.RenderGroup(pParams));
                 }
-                rendered = rendered.filter(x => x != null);
                 if (rendered.length) {
-                    const rootEntity = new Entity({
-                        id: ObjectUtils.UId(15)
-                    });
-                    rootEntity._siblingGraphics = [];
+                    const sameParts = ((_e = existingRoot === null || existingRoot === void 0 ? void 0 : existingRoot._siblingGraphics) === null || _e === void 0 ? void 0 : _e.length) == rendered.length &&
+                        rendered.every((part) => existingRoot._siblingGraphics.includes(part));
+                    let rootEntity;
+                    if (sameParts) {
+                        rootEntity = existingRoot;
+                    }
+                    else {
+                        if (existingRoot === null || existingRoot === void 0 ? void 0 : existingRoot._siblingGraphics) {
+                            // Retiring the old root removes its parts, and the ones carried over belong to the new root now.
+                            existingRoot._siblingGraphics = existingRoot._siblingGraphics.filter((part) => !rendered.includes(part));
+                        }
+                        rootEntity = new Entity({
+                            id: ObjectUtils.UId(15)
+                        });
+                    }
+                    rootEntity._siblingGraphics = rendered;
                     rootEntity._renderGroup = GetRenderGroupId(zoomItem);
-                    rootEntity._siblingGraphics = rootEntity._siblingGraphics.concat(rendered);
+                    // The skip gate compares the rego's style against the zoom item's, and the rego takes it from here.
+                    rootEntity.styleId = (zoomItem === null || zoomItem === void 0 ? void 0 : zoomItem.StyleID) == -1 ? -1 : (+(zoomItem === null || zoomItem === void 0 ? void 0 : zoomItem.StyleID) || null);
+                    rootEntity.styleEffective = rendered[0].styleEffective;
                     cEntities.set(entity.Bruce.ID, rootEntity);
-                    const firstEntity = rendered[0];
-                    if (firstEntity) {
-                        rootEntity.position = GetCValue(params.viewer, firstEntity.position);
+                    const newPosition = GetCValue(params.viewer, rendered[0].position);
+                    const oldPosition = GetCValue(params.viewer, rootEntity.position);
+                    if (newPosition && (!oldPosition || !Cartes.IsEqualCartes3(oldPosition, newPosition))) {
+                        rootEntity.position = new ConstantPositionProperty(newPosition);
                     }
                     rendered.forEach((child) => {
                         child._parentEntity = rootEntity;
@@ -50371,7 +50572,7 @@ var StyleUtils;
     StyleUtils.ApplyTypeStyle = ApplyTypeStyle;
 })(StyleUtils || (StyleUtils = {}));
 
-const VERSION = "7.4.2";
+const VERSION = "7.4.4";
 /**
  * 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.