bruce-cesium 6.8.0 → 6.8.2

package/dist/lib/rendering/visuals-register.js

@@ -380,6 +380,7 @@ var VisualsRegister;
             // skipped by the applier so a live user action always wins.
             this.lazyOverrideExclusions = new Set();
             this.lazyOverrideInterval = null;
+            this.activeChunkedIntervals = new Set();
             this.onUpdate = null;
             // Entity ID -> Menu Item ID -> State.
             // When no Menu Item ID is set, then the second key is a blank string.
@@ -976,6 +977,31 @@ var VisualsRegister;
             }
             this.viewer.scene.requestRender();
         }
+        runChunked(items, perItem, onComplete) {
+            const BATCH_SIZE = 5000;
+            let index = 0;
+            const interval = setInterval(() => {
+                if (this.Disposed) {
+                    clearInterval(interval);
+                    this.activeChunkedIntervals.delete(interval);
+                    return;
+                }
+                const end = Math.min(index + BATCH_SIZE, items.length);
+                for (; index < end; index++) {
+                    perItem(items[index]);
+                }
+                this.viewer.scene.requestRender();
+                if (index >= items.length) {
+                    clearInterval(interval);
+                    this.activeChunkedIntervals.delete(interval);
+                    onComplete === null || onComplete === void 0 ? void 0 : onComplete();
+                }
+            }, 10);
+            this.activeChunkedIntervals.add(interval);
+        }
+        startLazyRemoval(entityIds, removeOne, onComplete) {
+            this.runChunked(entityIds, removeOne, onComplete);
+        }
         /**
          * Cancels any in-flight lazy OverrideStates() apply.
          */
@@ -1048,9 +1074,7 @@ var VisualsRegister;
             }, 10);
         }
         /**
-         * Returns all states with the first detected Menu Item ID settings included.
-         * This is a utility function for returning settings for apps that don't support the newer state settings.
-         * @deprecated Use GetStates() or GetState().
+         * Returns all states keyed by entity id, without regard to menu item id.
          * @returns
          */
         GetStatesLegacy() {
@@ -1076,7 +1100,7 @@ var VisualsRegister;
                 const entityId = entityIds[i];
                 const state = this.GetState({
                     entityId: entityId,
-                    // First known Menu Item.
+                    // Most-recently-set Menu Item for this entity, if any.
                     menuItemId: entityIdsMenuItem[entityId]
                 });
                 states[entityId] = state;
@@ -1132,6 +1156,10 @@ var VisualsRegister;
             clearInterval(this.lazyOverrideInterval);
             this.lazyOverrideInterval = null;
             this.lazyOverrideActive = false;
+            for (const interval of this.activeChunkedIntervals) {
+                clearInterval(interval);
+            }
+            this.activeChunkedIntervals.clear();
             this.disposed = true;
         }
         ForceUpdate(params) {
@@ -1224,8 +1252,7 @@ var VisualsRegister;
             }
         }
         /**
-         * Returns all labelled entity ids.
-         * @deprecated Use GetStates() or GetState().
+         * Returns all labelled entity ids, without regard to menu item id.
          */
         GetLabelled() {
             const labelledIds = [];
@@ -1376,7 +1403,7 @@ var VisualsRegister;
             }
         }
         /**
-         * @deprecated Use GetStates() or GetState().
+         * Returns all selected entity ids, without regard to menu item id.
          * @returns
          */
         GetSelected() {
@@ -1511,7 +1538,7 @@ var VisualsRegister;
             }
         }
         /**
-         * @deprecated Use GetStates() or GetState().
+         * Returns all highlighted entity ids, without regard to menu item id.
          * @returns
          */
         GetHighlighted() {
@@ -1572,7 +1599,7 @@ var VisualsRegister;
             return this.isolatedAnyCache;
         }
         /**
-         * @deprecated Use GetStates() or GetState().
+         * Returns all isolated entity ids, without regard to menu item id.
          * @returns
          */
         GetIsolated() {
@@ -1630,7 +1657,7 @@ var VisualsRegister;
             return state.hidden === true;
         }
         /**
-         * @deprecated Use GetStates() or GetState().
+         * Returns all hidden entity ids, without regard to menu item id.
          * @returns
          */
         GetHidden() {
@@ -1717,8 +1744,8 @@ var VisualsRegister;
          * Re-parents every rego registered under one menu item id to a different menu item id.
          */
         ReassignMenuItem(params) {
-            var _a, _b;
-            const { fromMenuItemId, toMenuItemId, toMenuItemType, toPriority, requestRender, source } = params;
+            var _a;
+            const { fromMenuItemId, toMenuItemId, toMenuItemType, toPriority, requestRender, source, lazy, onBatch, onComplete } = params;
             if (!fromMenuItemId || !toMenuItemId || fromMenuItemId === toMenuItemId) {
                 return;
             }
@@ -1726,37 +1753,44 @@ var VisualsRegister;
             if (!entityIds) {
                 return;
             }
-            // Snapshot: unindexMenuItemEntityIfAbsent() below mutates this same set.
-            for (const entityId of Array.from(entityIds)) {
+            const idsSnapshot = Array.from(entityIds);
+            const regoSnapshot = new Map();
+            for (const entityId of idsSnapshot) {
+                const snapRego = (_a = this.rego[entityId]) === null || _a === void 0 ? void 0 : _a.find(r => r.menuItemId === fromMenuItemId);
+                if (snapRego) {
+                    regoSnapshot.set(entityId, snapRego);
+                }
+            }
+            const reassignOne = (entityId) => {
+                var _a, _b;
                 const regos = this.rego[entityId];
                 if (!regos) {
-                    continue;
+                    return null;
                 }
-                for (const rego of regos) {
-                    if (rego.menuItemId !== fromMenuItemId) {
-                        continue;
-                    }
-                    if (source !== EUpdateSource.TREE_CASCADE) {
-                        (_a = this.onUpdate) === null || _a === void 0 ? void 0 : _a.Trigger({
-                            type: EVisualUpdateType.Remove,
-                            entityId,
-                            rego: { ...rego, menuItemId: fromMenuItemId },
-                            source
-                        });
-                    }
-                    rego.menuItemId = toMenuItemId;
-                    rego.menuItemType = toMenuItemType;
-                    if (toPriority != null) {
-                        rego.priority = toPriority;
-                    }
-                    if (source !== EUpdateSource.TREE_CASCADE) {
-                        (_b = this.onUpdate) === null || _b === void 0 ? void 0 : _b.Trigger({
-                            type: EVisualUpdateType.Add,
-                            entityId,
-                            rego,
-                            source
-                        });
-                    }
+                const rego = regos.find(r => r.menuItemId === fromMenuItemId);
+                if (!rego || rego !== regoSnapshot.get(entityId)) {
+                    return null;
+                }
+                if (source !== EUpdateSource.TREE_CASCADE) {
+                    (_a = this.onUpdate) === null || _a === void 0 ? void 0 : _a.Trigger({
+                        type: EVisualUpdateType.Remove,
+                        entityId,
+                        rego: { ...rego, menuItemId: fromMenuItemId },
+                        source
+                    });
+                }
+                rego.menuItemId = toMenuItemId;
+                rego.menuItemType = toMenuItemType;
+                if (toPriority != null) {
+                    rego.priority = toPriority;
+                }
+                if (source !== EUpdateSource.TREE_CASCADE) {
+                    (_b = this.onUpdate) === null || _b === void 0 ? void 0 : _b.Trigger({
+                        type: EVisualUpdateType.Add,
+                        entityId,
+                        rego,
+                        source
+                    });
                 }
                 const eStates = this.states[entityId];
                 const movingState = eStates === null || eStates === void 0 ? void 0 : eStates[fromMenuItemId];
@@ -1776,11 +1810,50 @@ var VisualsRegister;
                     entityId,
                     refresh: true
                 });
+                return rego;
+            };
+            if (lazy) {
+                this.startLazyReassign(idsSnapshot, reassignOne, requestRender, onBatch, onComplete);
+                return;
+            }
+            for (const entityId of idsSnapshot) {
+                reassignOne(entityId);
             }
             if (requestRender != false) {
                 this.viewer.scene.requestRender();
             }
         }
+        startLazyReassign(entityIds, reassignOne, requestRender, onBatch, onComplete) {
+            const BATCH_SIZE = 5000;
+            let index = 0;
+            const interval = setInterval(() => {
+                if (this.Disposed) {
+                    clearInterval(interval);
+                    this.activeChunkedIntervals.delete(interval);
+                    return;
+                }
+                const end = Math.min(index + BATCH_SIZE, entityIds.length);
+                const batch = [];
+                for (; index < end; index++) {
+                    const rego = reassignOne(entityIds[index]);
+                    if (rego) {
+                        batch.push(rego);
+                    }
+                }
+                if (batch.length) {
+                    onBatch === null || onBatch === void 0 ? void 0 : onBatch(batch);
+                }
+                if (requestRender != false) {
+                    this.viewer.scene.requestRender();
+                }
+                if (index >= entityIds.length) {
+                    clearInterval(interval);
+                    this.activeChunkedIntervals.delete(interval);
+                    onComplete === null || onComplete === void 0 ? void 0 : onComplete();
+                }
+            }, 10);
+            this.activeChunkedIntervals.add(interval);
+        }
         /**
          * Locates a visual corresponding to a given entity id.
          * If no menu item id is provided, then it will pick the "best" one.
@@ -1823,6 +1896,7 @@ var VisualsRegister;
         GetRegos(params) {
             // TODO: refactor.
             // Currently this was made by merging two functions.
+            var _a;
             const { entityId, menuItemId, styleId, styleEffectiveFilter } = params;
             const matchesStyleFilters = (rego) => {
                 if (styleId != null && rego.styleId !== styleId) {
@@ -1846,10 +1920,10 @@ var VisualsRegister;
             }
             else if (menuItemId) {
                 const visuals = [];
-                for (const eId in this.rego) {
-                    const entityRegos = this.rego[eId];
-                    if (entityRegos) {
-                        const rego = entityRegos.find(r => r.menuItemId === menuItemId);
+                const eIds = this.entityIdsByMenuItem[menuItemId];
+                if (eIds) {
+                    for (const eId of eIds) {
+                        const rego = (_a = this.rego[eId]) === null || _a === void 0 ? void 0 : _a.find(r => r.menuItemId === menuItemId);
                         if (rego && matchesStyleFilters(rego)) {
                             visuals.push(rego);
                         }
@@ -1881,7 +1955,7 @@ var VisualsRegister;
          */
         RemoveRegos(params) {
             var _a, _b, _c;
-            let { entityId, menuItemId, doUpdate, relation, retainTagIds, requestRender, doRemove, source } = params;
+            let { entityId, menuItemId, doUpdate, relation, retainTagIds, requestRender, doRemove, source, lazy, onComplete } = params;
             if (doUpdate == null || doUpdate === undefined) {
                 doUpdate = true;
             }
@@ -1892,50 +1966,65 @@ var VisualsRegister;
             // Currently this was made by merging two functions.
             if (menuItemId && !entityId) {
                 // Entities registered under this menu item, keyed via entityIdsByMenuItem.
-                // Snapshot to an array since removals below mutate the backing set.
                 const entityIds = this.entityIdsByMenuItem[menuItemId] ? Array.from(this.entityIdsByMenuItem[menuItemId]) : [];
-                for (const entityId of entityIds) {
+                const regoSnapshot = new Map();
+                for (const snapEntityId of entityIds) {
+                    const snapRego = (_a = this.rego[snapEntityId]) === null || _a === void 0 ? void 0 : _a.find(r => r.menuItemId === menuItemId);
+                    if (snapRego) {
+                        regoSnapshot.set(snapEntityId, snapRego);
+                    }
+                }
+                const removeOne = (entityId) => {
+                    var _a;
                     const entityRegos = this.rego[entityId];
-                    if (entityRegos) {
-                        const rego = entityRegos.find(r => r.menuItemId === menuItemId);
-                        if (!rego) {
-                            continue;
-                        }
-                        const regoTagIds = rego.tagIds ? rego.tagIds : [];
-                        const shouldRetain = regoTagIds.some(tagId => retainTagIds.includes(tagId));
-                        if (shouldRetain) {
-                            continue;
-                        }
-                        entity_label_1.EntityLabel.Detatch({
-                            rego
+                    if (!entityRegos) {
+                        return;
+                    }
+                    const rego = entityRegos.find(r => r.menuItemId === menuItemId);
+                    if (!rego || rego !== regoSnapshot.get(entityId)) {
+                        return;
+                    }
+                    const regoTagIds = rego.tagIds ? rego.tagIds : [];
+                    const shouldRetain = regoTagIds.some(tagId => retainTagIds.includes(tagId));
+                    if (shouldRetain) {
+                        return;
+                    }
+                    entity_label_1.EntityLabel.Detatch({
+                        rego
+                    });
+                    if (doRemove != false) {
+                        removeEntity(this.viewer, rego.visual);
+                    }
+                    rego.visual = null;
+                    const doesInclude = this.rego[entityId].find(r => r.menuItemId === menuItemId);
+                    if (doesInclude) {
+                        this.rego[entityId] = entityRegos.filter(r => r.menuItemId !== menuItemId);
+                        this.unindexMenuItemEntityIfAbsent(menuItemId, entityId);
+                    }
+                    const update = {
+                        type: EVisualUpdateType.Remove,
+                        entityId: rego.entityId,
+                        rego: rego
+                    };
+                    if (source) {
+                        update.source = source;
+                    }
+                    if (source !== EUpdateSource.TREE_CASCADE) {
+                        (_a = this.onUpdate) === null || _a === void 0 ? void 0 : _a.Trigger(update);
+                    }
+                    if (doesInclude) {
+                        this.queueUpdate({
+                            entityId: entityId,
+                            refresh: false
                         });
-                        if (doRemove != false) {
-                            removeEntity(this.viewer, rego.visual);
-                        }
-                        rego.visual = null;
-                        const doesInclude = this.rego[entityId].find(r => r.menuItemId === menuItemId);
-                        if (doesInclude) {
-                            this.rego[entityId] = entityRegos.filter(r => r.menuItemId !== menuItemId);
-                            this.unindexMenuItemEntityIfAbsent(menuItemId, entityId);
-                        }
-                        const update = {
-                            type: EVisualUpdateType.Remove,
-                            entityId: rego.entityId,
-                            rego: rego
-                        };
-                        if (source) {
-                            update.source = source;
-                        }
-                        if (source !== EUpdateSource.TREE_CASCADE) {
-                            (_a = this.onUpdate) === null || _a === void 0 ? void 0 : _a.Trigger(update);
-                        }
-                        if (doesInclude) {
-                            this.queueUpdate({
-                                entityId: entityId,
-                                refresh: false
-                            });
-                        }
                     }
+                };
+                if (lazy) {
+                    this.startLazyRemoval(entityIds, removeOne, onComplete);
+                    return;
+                }
+                for (const entityId of entityIds) {
+                    removeOne(entityId);
                 }
             }
             else if (entityId) {
@@ -2258,10 +2347,9 @@ var VisualsRegister;
             });
         }
         /**
-         * Returns a dictionary containing entityId -> opacity values.
-         * Opacity 1 = 100%.
+         * Returns a dictionary containing entityId -> opacity values, without regard to
+         * menu item id. Opacity 1 = 100%.
          * @returns
-         * @deprecated Use GetStates() or GetState().
          */
         GetOpacityMap() {
             const map = {};