Update CHANGELOG for 3.3.0 release

Author: chaitanyavalli reddipalli

docs-sources/releases/CHANGELOG.md

@@ -1,3 +1,22 @@
+# 3.3.0 (2026-03-26 09:46)
+1. Manual layout of lines is now also supported for class diagrams. 
+2. It's now possible to place Art files in subfolders (nested to any depth) inside a workspace folder. This helps in structuring a big workspace folder with many files. Already before this was supported for C++ source files.
+3. Synchronization of changed code snippets from C++ to Art files now also works for C++ files generated into subfolders.
+4. Colors in diagrams have been adjusted to improve the contrast for both light and dark themes. In particular this makes labels and icons shown on inherited symbols easier to read.
+5. The sequence diagram viewer now highlights a lifeline, message or note based on the cursor position in an `.art-trace` file when the diagram opens. This makes it easier to navigate in big trace files.
+6. Diagram layout settings are now only validated for open diagrams. This improves performance and reduces the number of reported problems.
+7. Diagram layout files are now automatically updated if an Art file is renamed. Also, any currently open diagrams for elements in that Art file will be automatically closed and reopened to reflect the change.
+8. Minimal sizes for symbols have been implemented in diagrams. This avoids making symbols too small by mistake.
+9. A capsule is not allowed to have ports and parts with the same name, and this is now checked by the validation rule [ART_0002]({$vars.doc.server$}/validation/#art_0002_duplicatenamesinscope).
+10. It's now possible to exclude all outgoing transitions for an inherited choice, as a way to remove the choice from an inheriting state machine (note that the choice itself cannot be excluded). Previously this was not allowed and led to an error [ART_0006]({$vars.doc.server$}/validation/#art_0006_choicewithoutoutgoingtransitions).
+11. A new validation rule [TC_7019]({$vars.doc.server$}/validation/#tc_7019_duplicatenamesinglobalscope) now detects if the global scope that is defined by an active TC has elements with duplicated names. This check was previously done by [ART_0002]({$vars.doc.server$}/validation/#art_0002_duplicatenamesinscope), but the new implementation is significantly faster since it only is performed on active TCs and not on all Art files in the workspace.
+12. The C++ code generator now ensures that transitions which reference entry or exit points of excluded states are now also implicitly excluded.
+13. When a TC is cleaned (either from the UI or when using the Art Compiler with the `--clean` option) prerequisite TCs are now automatically cleaned too. This makes it easier to perform builds that are fully "clean built". If you only want to clean one TC, simply delete its target folder.
+14. Default values for unspecified TC properties have been added for macOS. This makes it faster to get started with building applications on macOS, and also allows to [run a capsule without creating a TC]({$vars.doc.server$}/building/#building-and-running-without-a-tc) on macOS.
+15. The TargetRTS now supports a new configuration setting [`PORTFULL_WARNING`]({$vars.doc.server$}/target-rts/build/#portfull_warning). If enabled, a runtime warning will be printed if there is an attempt to connect more SAP ports to an SPP port than what the multiplicity of the SPP port allows.
+16. Generated trace files now contain information about which command-line arguments that were provided to the traced application. The information is printed in a new "args" property of the "trace" object in the comment that appears at the beginning of the trace file.
+17. Version 2.3.1 of the Art Exporter is now available. Improvements include better preservation of diagram layouts, several new migration options as well as detection and removal of certain incorrect model elements. See [this page](https://model-realtime.hcldoc.com/help/topic/com.ibm.xtools.rsarte.webdoc/Utilities/Art%20Exporter.html) for more detailed release notes for the Art Exporter.
+
 # 3.2.0 (2026-01-23 14:40)
 1. For state and structure diagrams with manual layout it's now possible to freely route transition lines. You can decide where on the source and target symbol the line should connect to, and also add bendpoints. Some or all line bendpoints can be deleted by means of commands in the context menu that appears when you select a line, or bendpoints of a line, and press `ctrl+space`.
 2. Diagrams now refresh automatically if their diagram settings change. This can for example happen if the `art_diagram_settings.json` file is committed to Git, and it changes after a Git command has run.