:tocdepth: 2

##############
Envision 4.0
##############

July 30, 2025 - SHA: 2514d4fe

Envision 4.0 is a major release which means it contains breaking changes. We have removed Node.js v18 support 
(end of life and support has ended on May 14 2025), and now carry support for both Node.js v20 and v22.

.. note::
    Breaking changes in this release only affects Envision Web. There are no breaking changes for Envision Desktop.


|web| Envision for Web        |desktop| Envision for Desktop

****************
Breaking Changes
****************

CAE-1526 Node.js v18 support removed |web|
==========================================

We have removed Node.js v18 support (end of life and support has ended on May 14 2025), and now carry support for 
both Node.js v20 and v22.

- Supported: Node.js v20 and v22
- Deprecated: Node.js v18 (previously deprecated in Envision 3.3, now removed)    

The UgServer will automatically load the correct native add-on based on your Node.js version:

- Node.js v22+: Loads CeeUgServer_v22.node
- Node.js v20+: Loads CeeUgServer_v20.node
- Node.js v18 and below: Not supported - will throw an error


***********
Fixed Bugs
***********

CAE-1476 QueryResultMinMax with Visible Items Reports Incorrect Values |web|
============================================================================

This update addresses issues in the ``queryResultMinMax`` function when querying
minimum and maximum result values based on visible items (``bCheckElementVisibility`` set to true).

Key fixes and improvements:

  1. Corrected result mapping handling for visible elements to ensure accurate scalar/vector values.
  2. Ignored undefined values when reporting min/max to prevent erroneous results.
  3. Updated result value retrievals to use respective result mapping functions for improved clarity.
  4. Refactored memory management for generating element visibility flags, replacing manual new/delete 
     operations with a more robust approach.

These changes enhance the reliability and maintainability of the result querying process.


CAE-1532 Fixed issue with Isovolumes and per-element-node result and 2D elements |web| |desktop|
================================================================================================

This release note addresses a corner case issue with isovolumes. Specifically, when computing an isovolume from a 
part containing 2D (shell) elements and attempting to map a per-element-node result onto it, the previous 
implementation failed.

The solution was refactored to prevent the lines from being added during the computation of the intersection surface 
for the minimum and maximum isosurfaces, ensuring proper mapping and avoiding the described issue.



*************
New Features
*************

CAE-1234 Envision now directly integrates with CEETRON Access |desktop| |web|
=============================================================================

This release introduces a direct integration with CEETRON Access, enabling users to have access to the latest CAE, FEA 
and CFD file interface versions and updates for every Envision release. 


CAE-1299 New file interface support for Nastran HDF5 files |desktop| |web|
==========================================================================

This release adds support for Nastran HDF5 files, allowing users to import and visualize these files directly in 
Envision. 


CAE-1430 Socket.io reconnection for UgServer |web|
==================================================

- Added support for automatic session recovery after unexpected client disconnections in the UgServer. Users can now 
  seamlessly reconnect within a configurable time window, resuming their previous session without data loss or any extra 
  configuration. The server will keep sessions alive for a limited duration, improving reliability in unstable network 
  conditions.
- To enable it, set the ``CEW_UG_MAX_DISCONNECT_DURATION_MS`` environment variable for the ug server. The default value 
  is 30000 (30 seconds). If you do not wish the client to automatically reconnect or for the server to keep the extra 
  sessions active, set ``CEW_UG_MAX_DISCONNECT_DURATION_MS`` to 0.
- The client's state must remain intact, the session will be in any case lost upon a page reload or if the client is 
  closed. All packets sent during the disconnect period will be queued and sent to the server once the connection is 
  restored.


CAE-1466 Mac assemblies are now properly signed |web|
=====================================================

MacOS distributions now codesigns and notarizes its binaries.


CAE-1541 Updated Abaqus file interface to version 2025 |desktop| |web|
======================================================================

This update includes the latest Abaqus file interface version 2025, ensuring compatibility with the most recent Abaqus
file formats and features. 


CAE-1543 Update form-data to 4.0.4 to address a critical CVE |web|
==================================================================

UgServer's dependency ``form-data`` has been updated to version 4.0.4 to address a `critical vulnerability. 
<https://github.com/form-data/form-data/security/advisories/GHSA-fjxv-7rqg-78g4>`_.

