fcs-core-viewer 0.54.0 → 0.55.0

package/fcs-core-editor@types/Editor3D/Editor3DState.d.ts

@@ -5,6 +5,7 @@
 export declare class Editor3DState {
     private static _instance;
     private _isOperationRunning;
+    private _isCheckedOutVersion;
     private constructor();
     /**
      * Returns the singleton instance.
@@ -25,6 +26,17 @@ export declare class Editor3DState {
      * the response (or error) has been received.
      */
     static setOperationRunning(value: boolean): void;
+    /**
+     * Returns true when the user is viewing a checked-out historical version.
+     * All modelling operations should be blocked in this state.
+     */
+    static IsCheckedOutVersion(): boolean;
+    /**
+     * Sets the checked-out-version flag.
+     * Call with `true` after a successful checkout and `false` after
+     * a trim-to-version or when the user returns to the latest version.
+     */
+    static setCheckedOutVersion(value: boolean): void;
     /**
      * Shows or hides the full-screen spinner overlay that blocks UI interaction
      * while a backend operation is in progress.

package/fcs-core-editor@types/Editor3D/Network/BackendClient.d.ts

@@ -54,6 +54,18 @@ export declare class BackendManager {
      * @returns
      */
     sendToBackend(message: any, endpoint: string): Promise<any>;
+    /**
+     * Sends a GET request to the backend at the given endpoint.
+     * @param endpoint The endpoint path (e.g. '/model-versions/some-id')
+     * @returns The parsed JSON response, or throws on error.
+     */
+    getFromBackend(endpoint: string): Promise<any>;
+    /**
+     * Fetches the SERVICE mode flag for a given model environment.
+     * @param modelEnvironmentId The model environment ID
+     * @returns boolean indicating if the environment is in SERVICE mode
+     */
+    getModelEnvironmentServiceMode(modelEnvironmentId: Number): Promise<boolean>;
     /**
      * Along with a message also a binary file is uploaded.
      * @param message

package/fcs-core-editor@types/Editor3D/Network/ModelHistoryClient.d.ts

@@ -0,0 +1,41 @@
+/**
+ * A single entry in the model version history.
+ */
+export interface ModelVersion {
+    /** Unique identifier for this history entry. */
+    id: string;
+    /** ISO timestamp of when this version was saved. */
+    timestamp: string;
+    /** The Azure Blob Storage key for the model zip at this version. */
+    modelBlobKey: string;
+}
+/**
+ * Client for model-history related API calls.
+ * Uses the existing BackendManager for consistent auth, base-URL, and error
+ * handling behaviour.
+ */
+export declare class ModelHistoryClient {
+    private static _instance;
+    private _backendManager;
+    private constructor();
+    static getInstance(): ModelHistoryClient;
+    /**
+     * Fetches all stored versions for a given model from the backend.
+     * Calls GET /model-versions/{modelId} on the model service.
+     * @param modelId The model identifier (UUID).
+     * @returns Array of ModelVersion entries ordered oldest → newest.
+     */
+    fetchModelVersions(modelId: string): Promise<ModelVersion[]>;
+    /**
+     * Loads a historical model blob into runtime memory without permanently
+     * altering the version history.  Uses operation 1004 (checkout_version).
+     * @param blobKey The Azure Blob Storage key of the version to check out.
+     */
+    checkoutVersion(blobKey: string): Promise<any>;
+    /**
+     * Permanently trims the version history so that the specified version
+     * becomes the latest.  Uses operation 1005 (trim_to_version).
+     * @param blobKey The Azure Blob Storage key of the version to trim to.
+     */
+    trimToVersion(blobKey: string): Promise<any>;
+}

package/fcs-core-editor@types/Editor3D/Network/SocketCommandsGateway.d.ts

@@ -64,6 +64,7 @@ export declare class SocketCommandsGateway implements IBackendEvents {
         set_color_by_quality: any;
         set_entity_representation: any;
         clear_model: any;
+        update_model_history: any;
         set_element_types: any;
         add_mesh_to_model: any;
         add_temporary_mesh_to_model: any;
@@ -228,6 +229,11 @@ export declare class SocketCommandsGateway implements IBackendEvents {
      * @param instructions Contains exported STEP file path
      */
     private export_STEP_for_selection;
+    /**
+     * Handles model history archive update from ModelService.
+     * Receives the complete history archive and initializes ModelHistoryPanel.
+     */
+    private update_model_history;
     measure_distance(data: BackendInstructions): Promise<CommandExecutionResponse>;
     /**
      * Helper to wrap socket BackendInstructions into the format expected by

package/fcs-core-editor@types/Editor3D/Operations/CAE/CreationTools_2D/OpRemesh.d.ts

@@ -1,6 +1,6 @@
 export declare class Remesh {
     data: {};
-    faceUIDs: number[];
+    elementUIDs: number[];
     elementSize: number;
     elementOrder: number;
     meshType: {};
@@ -27,6 +27,7 @@ export declare class Remesh {
     optsteps3d: number;
     secondorder: number;
     usegmsh: boolean;
+    groups: number[][];
     constructor(data: {});
     perform(): Promise<boolean>;
 }

package/fcs-core-editor@types/Editor3D/Operations/OperationCollection.d.ts

@@ -6,6 +6,8 @@ export declare enum OperationToId {
     Common_State_LoadModel = 1001,
     Common_State_SaveModel = 1002,
     Common_State_NewModel = 1003,
+    Common_State_CheckoutVersion = 1004,
+    Common_State_TrimToVersion = 1005,
     /**
      * Simulation - 10xx
      */

package/fcs-core-editor@types/Editor3D/UserInterface/UIComponents/EditorUIComponents.d.ts

@@ -4,6 +4,7 @@ import { ViewerCADToolbox } from "./MainMenu/Toolboxes/CADToolbox";
 import { ViewerCAEToolbox } from "./MainMenu/Toolboxes/CAEToolbox";
 import { TopBar } from './Topbar/TopBar';
 import { OptionsMenu } from "./OptionsMenu/OptionsMenu";
+import { ModelHistoryPanel } from './ModelHistory/ModelHistoryPanel';
 import { TreeView } from '../../../Viewer3D/UserInterface/UIComponents/TreeView/TreeView';
 import { TreeViewContextMenu } from '../../../Viewer3D/UserInterface/UIComponents/TreeView/TreeView';
 import { ViewerUIComponents } from '../../../Viewer3D/UserInterface/ViewerUIComponents';
@@ -21,5 +22,6 @@ export declare class EditorUIComponents extends ViewerUIComponents {
     viewerCAEToolbox: ViewerCAEToolbox;
     topBar: TopBar;
     optionsMenu: OptionsMenu;
+    modelHistoryPanel: ModelHistoryPanel;
     constructor();
 }

package/fcs-core-editor@types/Editor3D/UserInterface/UIComponents/ModelHistory/ModelHistoryPanel.d.ts

@@ -0,0 +1,65 @@
+/**
+ * ModelHistoryPanel
+ *
+ * Renders a dropdown in the top-left corner of the Editor UI that lets users:
+ *   1. Browse the version timeline (mapped by timestamp).
+ *   2. Check out an older version (read-only).
+ *   3. "Continue from Here" to trim history and resume editing.
+ *
+ * The panel is always visible (unless SERVICE mode). When no archive entries
+ * exist the dropdown is replaced by a "No archive exists" message.
+ *
+ * The panel is mounted into the `div#div_model_history` element that is
+ * injected into the Editor's HTML by Editor3DUISetup.
+ */
+export declare class ModelHistoryPanel {
+    private static _instance;
+    private _container;
+    private _client;
+    private _versions;
+    /** Blob key of the version currently checked out (null = latest). */
+    private _activeVersionBlobKey;
+    /** The blob key of the latest (current) model version, sent by ModelService. */
+    private _latestBlobKey;
+    /** Stored so the version list can be re-fetched after a trim. */
+    private _modelId;
+    private _triggerBtn;
+    private _menu;
+    private _select;
+    private _emptyMsg;
+    private _badge;
+    private _checkoutBtn;
+    private _continueBtn;
+    private _returnBtn;
+    private _isMenuOpen;
+    private constructor();
+    static getInstance(): ModelHistoryPanel;
+    /**
+     * Initializes the ModelHistoryPanel with history archive received from ModelService.
+     * Called each time an `update_model_history` WebSocket message arrives.
+     *
+     * @param modelId The model identifier.
+     * @param historyArchive Map of ISO timestamps to blob keys.
+     * @param isServiceMode If true, disables and hides the history panel.
+     * @param isCheckedOut If true, the session is viewing a historical version.
+     * @param latestBlobKey The blob key of the latest model version (for Return to Latest).
+     */
+    initializeWithArchive(modelId: string, historyArchive?: Record<string, string>, isServiceMode?: boolean, isCheckedOut?: boolean, latestBlobKey?: string): Promise<void>;
+    private _build;
+    private _populateSelect;
+    private _showPanel;
+    private _hidePanel;
+    private _showEmptyState;
+    private _showVersionList;
+    private _enterCheckedOutMode;
+    private _exitCheckedOutMode;
+    private _toggleMenu;
+    private _openMenu;
+    private _closeMenu;
+    private _onCheckoutClicked;
+    private _onContinueClicked;
+    private _onReturnToLatestClicked;
+    private _getSortedVersions;
+    private _getSortedVersionsDesc;
+    private _formatTimestamp;
+}

package/fcs-core-editor@types/Editor3D/Wrapper/Editor3D.d.ts

@@ -11,6 +11,9 @@ export interface PluginResponse extends Response {
     finished: boolean;
     message: string;
     event: string;
+    plugin_name?: string;
+    plugin_version?: string;
+    plugin_version_stamp?: string;
 }
 /**
  * Constructor for generic 3D editor.

package/fcs-core-editor@types/Viewer3D/Common/Diagnostics/StatusBar.d.ts

@@ -62,6 +62,7 @@ export declare class StatusBar {
     private copyLogsButton;
     private closeLogsButton;
     private versionBadge;
+    private pluginVersionBadge;
     /**
      *  Private constructor.
      */
@@ -71,6 +72,10 @@ export declare class StatusBar {
      * as a badge on the right end of the status bar.
      */
     private _fetchAndDisplayVersion;
+    /**
+     * Displays a plugin version badge in the status bar.
+     */
+    setPluginVersionStamp(pluginName: string, versionTimestamp: string): void;
     /**
      * Getter for singleton instance.
      */

package/fcs-core-editor@types/Viewer3D/Wrapper/SceneWrapper.d.ts

@@ -25,6 +25,8 @@ export declare class SceneWrapper {
     render: any;
     renderer: any;
     labelRenderer2D: any;
+    labelRenderer3D: any;
+    directionalLight: THREE.DirectionalLight;
     camToStart_world: any;
     camToStart_world_unit: any;
     camToStart_local: any;
@@ -71,15 +73,16 @@ export declare class SceneWrapper {
      * @param grPrimitive
      * @param currentCamera
      * @param controls
-     * @param render
      * @param renderer
      * @param labelRenderer2D
+     * @param labelRenderer3D
+     * @param directionalLight
      * @param camToStart_world
      * @param camToStart_world_unit
      * @param camToStart_local
      * @param camToStart_length
      */
-    constructor(canvas: HTMLCanvasElement, height: any, width: any, scene: any, sceneObjects: {}, grMesh: any, grLine: any, grPoint: any, grLabel: any, grPushPin: THREE.Group, grPrimitive: any, currentCamera: any, controls: any, render: any, renderer: any, labelRenderer2D: any, camToStart_world: any, camToStart_world_unit: any, camToStart_local: any, camToStart_length: any, axisLeft: any, axisBottom: any);
+    constructor(canvas: HTMLCanvasElement, height: any, width: any, scene: any, sceneObjects: {}, grMesh: any, grLine: any, grPoint: any, grLabel: any, grPushPin: THREE.Group, grPrimitive: any, currentCamera: any, controls: any, renderer: any, labelRenderer2D: any, labelRenderer3D: any, directionalLight: THREE.DirectionalLight, camToStart_world: any, camToStart_world_unit: any, camToStart_local: any, camToStart_length: any, axisLeft: any, axisBottom: any);
     static getInstance(): SceneWrapper;
     setParentViewerWrapper: (viewerWrapper: Viewer3DWrapper) => void;
     getHeight: () => any;
@@ -108,8 +111,6 @@ export declare class SceneWrapper {
     setCurrentCamera: (currentCamera: any) => void;
     getControls: () => any;
     setControls: (controls: any) => void;
-    getRender: () => any;
-    setRender: (render: any) => void;
     getRenderer: () => any;
     setRenderer: (renderer: any) => void;
     getLabelRenderer2D: () => any;

package/fcs-core-editor@types/Viewer3D/Wrapper/Viewer3DWrapper.d.ts

@@ -53,7 +53,7 @@ export declare class Viewer3DWrapper {
     axisBottom: number;
     controls: any;
     ambientLight: any;
-    directionalLight: any;
+    directionalLight: THREE.DirectionalLight;
     directionalLights: [{
         direction: any;
         color: any;
@@ -171,10 +171,6 @@ export declare class Viewer3DWrapper {
      */
     DefineAllTasks(): Promise<void>;
     animate(): void;
-    /**
-     * Public rendering method.
-     */
-    render(): void;
     /**
      *
      */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "fcs-core-viewer",
-    "version": "0.54.0",
+    "version": "0.55.0",
     "description": "3D Viewer in the Cloud",
     "author": {
         "name": "Femsolve Kft."