bruce-cesium 7.6.2 → 7.6.3

package/dist/types/bruce-cesium.d.ts

@@ -11,6 +11,7 @@ export * from "./rendering/texture-frame-series-animator";
 export * from "./rendering/texture-value-labels";
 export * from "./rendering/menu-item-creator";
 export * from "./rendering/menu-item-manager";
+export * from "./rendering/menu-item-styles";
 export * from "./rendering/render-managers/common/cesium-parabola";
 export * from "./rendering/render-managers/common/entity-label";
 export * from "./rendering/render-managers/common/entity-label-group";
@@ -70,7 +71,7 @@ export * from "./widgets/widget-info-view";
 export * from "./widgets/widget-left-panel";
 export * from "./widgets/widget-nav-compass";
 export * from "./widgets/widget-view-bar";
-export declare const VERSION = "7.6.2";
+export declare const VERSION = "7.6.3";
 /**
  * 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.

package/dist/types/rendering/menu-item-manager.d.ts

@@ -30,6 +30,7 @@ export declare namespace MenuItemManager {
         get Viewer(): Cesium.Viewer;
         private items;
         private pendingHandoffPool;
+        private authoredAlternations;
         private visualsRegister;
         get VisualsRegister(): VisualsRegister.Register;
         private onUpdate;
@@ -79,6 +80,7 @@ export declare namespace MenuItemManager {
             item: MenuItem.IItem;
             modelSpace?: boolean;
             recursive?: boolean;
+            preferredIds?: string[];
             getters?: ApiGetters;
             apiGetter?: BruceApi.IGetter;
         }): string;
@@ -92,7 +94,25 @@ export declare namespace MenuItemManager {
             recursive?: boolean;
             allowHandoff?: boolean;
         }): void;
+        /**
+         * Replaces enabled menu items with another, which reuses their graphics where both draw the same data.
+         */
+        SwapItem(params: {
+            fromIds: string[];
+            item: MenuItem.IItem;
+            modelSpace?: boolean;
+        }): string;
+        /**
+         * Restyles an enabled menu item in place with another of its own styles, returning false when it cannot.
+         */
+        SetItemStyle(params: {
+            menuItemId: string;
+            styleId: number | string;
+        }): boolean;
+        private pickRadioChild;
+        private renderInPlaceOf;
         private isHandoffCapable;
+        private isStyleSwapCapable;
         private computeHandoffKey;
         private tryClaimHandoffPayload;
         /**
@@ -102,6 +122,11 @@ export declare namespace MenuItemManager {
          */
         private transferSeriesSegments;
         FlushPendingHandoffs(): void;
+        private disposePooled;
+        /**
+         * Returns the tags and attenuation the item's view authored, before any bookmark wrote over them.
+         */
+        GetAuthoredAlternation(item: MenuItem.IItem): MenuItem.IItem;
         GetEnabledItemIds(): string[];
         GetEnabledItem(id: string): IRenderedItem;
         /**

package/dist/types/rendering/menu-item-styles.d.ts

@@ -0,0 +1,30 @@
+import { MenuItem } from "bruce-models";
+/**
+ * Reads and picks between a menu item's ordered styles, writing the pick to the single field renderers read.
+ */
+export declare namespace MenuItemStyles {
+    /**
+     * Returns the ordered styles a user can swap between for the item, or an empty array when it offers no choice.
+     */
+    function GetStyleIds(item: MenuItem.IItem): (number | string)[];
+    /**
+     * Returns the style the item currently renders with, from styleId or its one non-hidden zoom row.
+     */
+    function GetStyleId(item: MenuItem.IItem): number | string | undefined;
+    /**
+     * Returns a copy of the item rendering with the given style, or null when that style is not one of its options.
+     */
+    function WithStyleId(item: MenuItem.IItem, styleId: number | string): MenuItem.IItem | null;
+    /**
+     * Returns the item on the first of its styles unless it already uses one, or the same object when it has none.
+     */
+    function Resolve(item: MenuItem.IItem): MenuItem.IItem;
+    /**
+     * Returns a copy on the style a bookmark alternation picked, or the item itself when that is not an option.
+     */
+    function ApplyAlternation(item: MenuItem.IItem, alternation: MenuItem.IItem): MenuItem.IItem;
+    /**
+     * Returns true when the two items differ by nothing but which of their styles is picked.
+     */
+    function IsStyleChangeOnly(from: MenuItem.IItem, to: MenuItem.IItem): boolean;
+}

package/dist/types/rendering/render-managers/entities/entities-datalab-render-manager.d.ts

@@ -5,7 +5,7 @@ import { RenderManager } from "../render-manager";
 import { CesiumViewMonitor } from "../../../viewer/cesium-view-monitor";
 import { EntitySimulation } from "../common/entity-simulation";
 export declare namespace DataLabRenderManager {
-    class Manager implements RenderManager.IManager, RenderManager.IHandoffCapableManager, RenderManager.IHandoffReceiver {
+    class Manager implements RenderManager.IManager, RenderManager.IHandoffCapableManager, RenderManager.IHandoffReceiver, RenderManager.IStyleSwapCapable {
         private viewer;
         private item;
         private apiGetter;
@@ -61,6 +61,10 @@ export declare namespace DataLabRenderManager {
             zoomControl?: ZoomControl.IItem[];
             queueRerender?: boolean;
         }): void;
+        /**
+         * Switches to another of the item's own styles, restyling what is drawn without re-creating it.
+         */
+        SwapStyle(item: MenuItem.Item.IDataLab): void;
         private doEntityCheck;
         private distributeForRender;
         private deduplicateEntities;

package/dist/types/rendering/render-managers/entities/entities-ids-render-manager.d.ts

@@ -10,7 +10,7 @@ import { EntitySimulation } from "../common/entity-simulation";
  * This will render them in batches to avoid overloading the viewer.
  */
 export declare namespace EntitiesIdsRenderManager {
-    class Manager implements RenderManager.IManager {
+    class Manager implements RenderManager.IManager, RenderManager.IStyleSwapCapable {
         private viewer;
         private apiGetter;
         private monitor;
@@ -58,6 +58,10 @@ export declare namespace EntitiesIdsRenderManager {
             zoomControl?: ZoomControl.IItem[];
             queueRerender?: boolean;
         }): void;
+        /**
+         * Switches to another of the item's own styles, restyling what is drawn without re-creating it.
+         */
+        SwapStyle(item: MenuItem.Item.IEntityIds): void;
         private getHistoricLane;
         private onGetterUpdate;
         private renderEntities;

package/dist/types/rendering/render-managers/entities/entities-loaded-render-manager.d.ts

@@ -10,7 +10,7 @@ import { EntitySimulation } from "../common/entity-simulation";
  * If the entities DON'T have records, it is recommended to avoid using the 3dmodel visualization as it will fail to locate LODs.
  */
 export declare namespace EntitiesLoadedRenderManager {
-    class Manager implements RenderManager.IManager {
+    class Manager implements RenderManager.IManager, RenderManager.IStyleSwapCapable {
         private viewer;
         private apiGetter;
         private item;
@@ -73,6 +73,10 @@ export declare namespace EntitiesLoadedRenderManager {
             zoomControl?: ZoomControl.IItem[];
             queueRerender?: boolean;
         }): void;
+        /**
+         * Switches to another of the item's own styles, restyling what is drawn without re-creating it.
+         */
+        SwapStyle(item: MenuItem.Item.IEntitiesLoaded): void;
         private doEntityCheck;
         private onGetterUpdate;
         /**

package/dist/types/rendering/render-managers/entities/entities-render-manager.d.ts

@@ -11,7 +11,7 @@ import { RenderManager } from "../render-manager";
  * This will request entities based on setup menu item filter.
  */
 export declare namespace EntitiesRenderManager {
-    class Manager implements RenderManager.IManager, RenderManager.IHandoffCapableManager, RenderManager.IHandoffReceiver {
+    class Manager implements RenderManager.IManager, RenderManager.IHandoffCapableManager, RenderManager.IHandoffReceiver, RenderManager.IStyleSwapCapable {
         private viewer;
         private apiGetter;
         private sharedGetters;
@@ -43,6 +43,8 @@ export declare namespace EntitiesRenderManager {
         private useGeojson;
         private zoomControl;
         private scenario;
+        private drawnKey;
+        private drawnSettings;
         private renderPriority;
         private allowedTypeIDs;
         constructor(params: {
@@ -58,6 +60,7 @@ export declare namespace EntitiesRenderManager {
         Init(params?: {
             item: MenuItem.Item.IEntities;
         }): void;
+        private getDrawnSettingsSignature;
         private applyItemSettings;
         /**
          * Updates allowedTypeIDs values based in incoming data.
@@ -83,6 +86,10 @@ export declare namespace EntitiesRenderManager {
             zoomControl?: ZoomControl.IItem[];
             queueRerender?: boolean;
         }): void;
+        /**
+         * Switches to another of the item's own styles, restyling what is drawn without re-creating it.
+         */
+        SwapStyle(item: MenuItem.Item.IEntities): void;
         /**
          * Narrows a camera-driven check to the entities whose zoom band could actually have changed.
          * @param ids

package/dist/types/rendering/render-managers/entities/entity-render-manager.d.ts

@@ -8,7 +8,7 @@ import { EntitySimulation } from "../common/entity-simulation";
  * Manager for rendering a single Bruce entity.
  */
 export declare namespace EntityRenderManager {
-    class Manager implements RenderManager.IManager {
+    class Manager implements RenderManager.IManager, RenderManager.IStyleSwapCapable {
         private viewer;
         private apiGetter;
         private item;
@@ -41,6 +41,10 @@ export declare namespace EntityRenderManager {
             zoomControl?: ZoomControl.IItem[];
             queueRerender?: boolean;
         }): void;
+        /**
+         * Switches to another of the item's own styles, restyling what is drawn without re-creating it.
+         */
+        SwapStyle(item: MenuItem.Item.IEntity): void;
         private renderEntityChain;
         private renderEntity;
         private doRenderEntity;

package/dist/types/rendering/render-managers/render-manager.d.ts

@@ -1,4 +1,4 @@
-import { Entity, ZoomControl } from "bruce-models";
+import { Entity, MenuItem, ZoomControl } from "bruce-models";
 import * as Cesium from "cesium";
 export declare namespace RenderManager {
     interface IManager {
@@ -50,6 +50,15 @@ export declare namespace RenderManager {
          */
         AdoptHandoff(payload: IHandoffPayload): void;
     }
+    /**
+     * Opt-in capability for a manager that can switch to another of its menu item's own styles in place.
+     */
+    interface IStyleSwapCapable extends IManager {
+        /**
+         * Takes over an item that differs from the current one only by its picked style (see MenuItemStyles).
+         */
+        SwapStyle(item: MenuItem.IItem): void;
+    }
     /**
      * What a zoom-item resolution measured, so a later pass can tell whether the answer could have changed
      * without redoing it. See IBandCheck on a rendered graphic.

package/dist/types/rendering/render-managers/tilesets/tileset-arb-render-manager.d.ts

@@ -27,7 +27,7 @@ export declare namespace TilesetArbRenderManager {
         XGridsLCC = "XGridsLCC",
         Unknown = "Unknown"
     }
-    class Manager implements RenderManager.IManager {
+    class Manager implements RenderManager.IManager, RenderManager.IStyleSwapCapable {
         private viewer;
         private simulation;
         private getters;
@@ -82,6 +82,10 @@ export declare namespace TilesetArbRenderManager {
         private processFeatureQueueBatch;
         private evaluateFeatureProps;
         private onCTilesetLoad;
+        /**
+         * Switches to another of the item's own styles, restyling the loaded tileset without reloading it.
+         */
+        SwapStyle(item: MenuItem.Item.IArbTileset): void;
         Dispose(): void;
         private doDispose;
         ReRender(params: {

package/dist/types/rendering/render-managers/tilesets/tileset-cad-render-manager.d.ts

@@ -18,7 +18,7 @@ interface IModelTreeNode {
  * CAD tilesets are referred to as "MODEL" tilesets in some other areas of Bruce code.
  */
 export declare namespace TilesetCadRenderManager {
-    class Manager implements RenderManager.IManager, RenderManager.IHandoffCapableManager, RenderManager.IHandoffReceiver {
+    class Manager implements RenderManager.IManager, RenderManager.IHandoffCapableManager, RenderManager.IHandoffReceiver, RenderManager.IStyleSwapCapable {
         private viewer;
         private simulation;
         private simulationRemoval;
@@ -195,6 +195,10 @@ export declare namespace TilesetCadRenderManager {
          * @returns Map of entityId to array of child nodes.
          */
         getChildNodesBatch(entityIds: string[]): Map<string, IModelTreeNode[]>;
+        /**
+         * Switches to another of the item's own styles, restyling the loaded tileset without reloading it.
+         */
+        SwapStyle(item: MenuItem.Item.ICadTileset): void;
         Dispose(): void;
         private doDispose;
         ReRender(params: {

package/dist/types/rendering/render-managers/tilesets/tileset-entities-render-manager.d.ts

@@ -7,7 +7,7 @@ import { TilesetArbRenderManager } from "./tileset-arb-render-manager";
 import { CesiumViewMonitor } from "../../../viewer/cesium-view-monitor";
 import { EntitySimulation } from "../common/entity-simulation";
 export declare namespace TilesetEntitiesRenderManager {
-    class Manager implements RenderManager.IManager, RenderManager.IHandoffCapableManager, RenderManager.IHandoffReceiver {
+    class Manager implements RenderManager.IManager, RenderManager.IHandoffCapableManager, RenderManager.IHandoffReceiver, RenderManager.IStyleSwapCapable {
         private initCounter;
         private viewer;
         private simulation;
@@ -67,6 +67,10 @@ export declare namespace TilesetEntitiesRenderManager {
          */
         private processFeatureQueueBatch;
         private evaluateFeatureProps;
+        /**
+         * Switches to another of the item's own styles, restyling the loaded tileset without reloading it.
+         */
+        SwapStyle(item: MenuItem.Item.IEntitiesTileset): void;
         Dispose(): void;
         private doDispose;
         private onCTilesetLoad;

package/dist/types/widgets/tabs-left-panel/widget-left-panel-tab-menu-items.d.ts

@@ -67,6 +67,7 @@ export declare class WidgetLeftPanelTabMenuItems extends WidgetLeftPanelTab.ATab
     private _resolveState;
     private _updateCounts;
     private _toggleItem;
+    private _getEnabledIdsUnder;
     private _disableItem;
     private _selectItemEntities;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bruce-cesium",
-  "version": "7.6.2",
+  "version": "7.6.3",
   "description": "",
   "keywords": [],
   "main": "dist/bruce-cesium.umd.js",
@@ -83,7 +83,7 @@
     "typescript": "^5.0.4"
   },
   "dependencies": {
-    "bruce-models": "^7.1.122",
+    "bruce-models": "^7.1.123",
     "tslib": "^2.4.1"
   }
 }