fix(immutable): upgrade to v5 (option 1)

.changeset/immutable-v5-cmf-cqrs-major.md

@@ -0,0 +1,13 @@
+---
+'@talend/react-cmf-cqrs': major
+---
+
+Upgrade Immutable.js to v5
+
+## Breaking Changes
+
+- **Immutable.js upgraded from v3.8.2 to v5.x**: Consumers depending on Immutable v3 or v4 APIs must update accordingly.
+- **Default import removed**: `import Immutable from 'immutable'` is no longer supported. Use named imports instead (e.g., `import { Map, List, fromJS, isImmutable } from 'immutable'`).
+- **`react-immutable-proptypes` removed**: Custom internal validators replace `ImmutablePropTypes`. No peer-dep on `react-immutable-proptypes` anymore.
+
+See the [migration guide](../docs/breaking-change-immutable-v5.md) for full details and upgrade instructions.

.changeset/immutable-v5-cmf-major.md

@@ -0,0 +1,15 @@
+---
+'@talend/react-cmf': major
+---
+
+Upgrade Immutable.js to v5
+
+## Breaking Changes
+
+- **Immutable.js upgraded from v3.8.2 to v5.x**: Consumers depending on Immutable v3 or v4 APIs must update accordingly.
+- **Default import removed**: `import Immutable from 'immutable'` is no longer supported. Use named imports instead (e.g., `import { Map, List, fromJS, isImmutable } from 'immutable'`). All cmf source and expressions modules have been updated accordingly.
+- **`Iterable` removed**: Replace `Immutable.Iterable` checks with `isImmutable()` from `immutable`.
+- **`react-immutable-proptypes` removed**: Custom internal validators replace `ImmutablePropTypes`. No peer-dep on `react-immutable-proptypes` anymore.
+- **`OrderedMap` → `Map`**: `Map` in Immutable v5 preserves insertion order, making `OrderedMap` redundant. All internal usage has been updated.
+
+See the [migration guide](../docs/breaking-change-immutable-v5.md) for full details and upgrade instructions.

.changeset/immutable-v5-components-major.md

@@ -0,0 +1,14 @@
+---
+'@talend/react-components': major
+---
+
+Upgrade Immutable.js to v5
+
+## Breaking Changes
+
+- **Immutable.js upgraded from v3.8.2 to v5.x**: Consumers depending on Immutable v3 or v4 APIs must update accordingly.
+- **Default import removed**: `import Immutable from 'immutable'` is no longer supported. Use named imports instead (e.g., `import { Map, List, fromJS, isImmutable } from 'immutable'`). ActionDropdown and other components have been updated accordingly.
+- **`Iterable` removed**: Replace `Immutable.Iterable` checks with `isImmutable()` from `immutable`.
+- **`react-immutable-proptypes` removed**: Custom internal validators replace `ImmutablePropTypes`. No peer-dep on `react-immutable-proptypes` anymore.
+
+See the [migration guide](../docs/breaking-change-immutable-v5.md) for full details and upgrade instructions.

.changeset/immutable-v5-containers-major.md

@@ -0,0 +1,15 @@
+---
+'@talend/react-containers': major
+---
+
+Upgrade Immutable.js to v5
+
+## Breaking Changes
+
+- **Immutable.js upgraded from v3.8.2 to v5.x**: Consumers depending on Immutable v3 or v4 APIs must update accordingly.
+- **Default import removed**: `import Immutable from 'immutable'` is no longer supported. Use named imports instead (e.g., `import { Map, List, fromJS, isImmutable } from 'immutable'`).
+- **`Iterable` removed**: Replace `Immutable.Iterable` checks with `isImmutable()` from `immutable`.
+- **`react-immutable-proptypes` removed**: Custom internal validators replace `ImmutablePropTypes`. No peer-dep on `react-immutable-proptypes` anymore.
+- **`OrderedMap` → `Map`**: `Map` in Immutable v5 preserves insertion order, making `OrderedMap` redundant. All internal usage has been updated.
+
+See the [migration guide](../docs/breaking-change-immutable-v5.md) for full details and upgrade instructions.

.changeset/immutable-v5-flow-designer-major.md

@@ -0,0 +1,15 @@
+---
+'@talend/react-flow-designer': major
+---
+
+Upgrade Immutable.js to v5
+
+## Breaking Changes
+
+- **Immutable.js upgraded from v3.8.2 to v5.x**: Consumers depending on Immutable v3 or v4 APIs must update accordingly.
+- **Default import removed**: `import Immutable from 'immutable'` is no longer supported. Use named imports instead (e.g., `import { Map, List, fromJS, isImmutable } from 'immutable'`). Reducers (link, node, port) and renderers (LinksRenderer, NodesRenderer, PortsRenderer) have been updated accordingly.
+- **`Iterable` removed**: Replace `Immutable.Iterable` checks with `isImmutable()` from `immutable`.
+- **`react-immutable-proptypes` removed**: Custom internal validators replace `ImmutablePropTypes`. No peer-dep on `react-immutable-proptypes` anymore.
+- **`OrderedMap` → `Map`**: `Map` in Immutable v5 preserves insertion order, making `OrderedMap` redundant. All internal usage has been updated.
+
+See the [migration guide](../docs/breaking-change-immutable-v5.md) for full details and upgrade instructions.

.changeset/immutable-v5-sagas-major.md

@@ -0,0 +1,13 @@
+---
+'@talend/react-sagas': major
+---
+
+Upgrade Immutable.js to v5
+
+## Breaking Changes
+
+- **Immutable.js upgraded from v3.8.2 to v5.x**: Consumers depending on Immutable v3 or v4 APIs must update accordingly.
+- **Default import removed**: `import Immutable from 'immutable'` is no longer supported. Use named imports instead (e.g., `import { Map, List, fromJS, isImmutable } from 'immutable'`).
+- **`react-immutable-proptypes` removed**: Custom internal validators replace `ImmutablePropTypes`. No peer-dep on `react-immutable-proptypes` anymore.
+
+See the [migration guide](../docs/breaking-change-immutable-v5.md) for full details and upgrade instructions.

.gitignore

@@ -51,3 +51,10 @@ eslint-report.json
 stylelint-report.json
 i18n-extract
 .test-cache
+
+# TMP
+_bmad
+_bmad-*
+.github/agents/bmad-*
+.github/prompts/bmad_*
+.github/prompts/bmad-*

.prettierignore

@@ -8,3 +8,10 @@ dist
 node_modules
 __fixtures__
 tools/scripts-config-storybook-lib/.storybook-templates/main.js
+
+# TMP
+_bmad
+_bmad-output
+.github/agents/bmad-*
+.github/prompts/bmad_*
+.github/prompts/bmad-*

docs/breaking-change-immutable-v5.md

@@ -0,0 +1,160 @@
+# Breaking Changes: Immutable.js v5 Migration
+
+This document covers the breaking changes introduced by the Immutable.js v5 migration
+across the following packages:
+
+- `@talend/react-cmf`
+- `@talend/react-components`
+- `@talend/react-containers`
+- `@talend/react-flow-designer`
+- `@talend/react-cmf-cqrs`
+- `@talend/react-sagas`
+
+---
+
+## 1. Immutable.js upgraded from v3.8.2 to v5.x
+
+The `immutable` peer dependency has been bumped to `^5.0.0`.
+
+Immutable v5 ships significant performance improvements and API clean-ups relative to v3/v4.
+Consumers must upgrade their own `immutable` dependency and review any private API usage.
+
+**Action required:** Update your `package.json`:
+
+```json
+{
+	"dependencies": {
+		"immutable": "^5.0.0"
+	}
+}
+```
+
+---
+
+## 2. Default import removed
+
+The default export of `immutable` no longer exists in v5. Any code relying on the default
+import will fail at runtime.
+
+**Before:**
+
+```js
+import Immutable from 'immutable';
+
+const map = Immutable.Map({ key: 'value' });
+const list = Immutable.List([1, 2, 3]);
+```
+
+**After:**
+
+```js
+import { Map, List, fromJS, isImmutable } from 'immutable';
+
+const map = Map({ key: 'value' });
+const list = List([1, 2, 3]);
+```
+
+---
+
+## 3. `Iterable` replaced by `isImmutable()`
+
+`Immutable.Iterable` (and the `Iterable.isIterable()` helper) were removed in v5.
+Use the top-level `isImmutable()` function to check whether a value is an Immutable
+data structure.
+
+**Before:**
+
+```js
+import Immutable from 'immutable';
+
+if (Immutable.Iterable.isIterable(value)) {
+	// ...
+}
+```
+
+**After:**
+
+```js
+import { isImmutable } from 'immutable';
+
+if (isImmutable(value)) {
+	// ...
+}
+```
+
+---
+
+## 4. `react-immutable-proptypes` removed
+
+The `react-immutable-proptypes` package has been removed from all affected packages.
+Custom lightweight validators (provided internally) replace it.
+
+If your application depends on `ImmutablePropTypes` from `react-immutable-proptypes`,
+you must either:
+
+- Remove the dependency and write plain PropTypes validators, **or**
+- Keep `react-immutable-proptypes` as a direct dependency of your own package.
+
+**Before (in your component):**
+
+```js
+import ImmutablePropTypes from 'react-immutable-proptypes';
+
+MyComponent.propTypes = {
+	items: ImmutablePropTypes.list.isRequired,
+};
+```
+
+**After (example using plain PropTypes + isImmutable):**
+
+```js
+import PropTypes from 'prop-types';
+import { isImmutable } from 'immutable';
+
+MyComponent.propTypes = {
+	items: (props, propName) => {
+		if (!isImmutable(props[propName])) {
+			return new Error(`${propName} must be an Immutable structure`);
+		}
+		return null;
+	},
+};
+```
+
+---
+
+## 5. `OrderedMap` replaced by `Map`
+
+Immutable v5's `Map` preserves insertion order by default, making `OrderedMap`
+redundant. All internal usages of `OrderedMap` have been replaced with `Map`.
+
+If your code uses `OrderedMap` directly from these packages' re-exports or expects
+`OrderedMap` instances from props/state, switch to `Map`.
+
+**Before:**
+
+```js
+import Immutable from 'immutable';
+
+const ordered = Immutable.OrderedMap({ a: 1, b: 2 });
+```
+
+**After:**
+
+```js
+import { Map } from 'immutable';
+
+const map = Map({ a: 1, b: 2 }); // insertion order preserved in v5
+```
+
+---
+
+## Migration Summary
+
+| Change           | v3 / v4                             | v5                                         |
+| ---------------- | ----------------------------------- | ------------------------------------------ |
+| Package import   | `import Immutable from 'immutable'` | `import { Map, List, … } from 'immutable'` |
+| Iterable check   | `Immutable.Iterable.isIterable(x)`  | `isImmutable(x)`                           |
+| Ordered map      | `OrderedMap({ … })`                 | `Map({ … })`                               |
+| PropTypes        | `react-immutable-proptypes`         | Custom validators / plain PropTypes        |
+| Peer dep version | `^3.8.2` or `^4.0.0`                | `^5.0.0`                                   |

packages/cmf-cqrs/package.json

@@ -43,7 +43,7 @@
   "dependencies": {
     "@talend/react-cmf": "^12.1.0",
     "@talend/utils": "^3.7.0",
-    "immutable": "^3.8.2",
+    "immutable": "^5.1.5",
     "redux-saga": "^1.4.2"
   },
   "devDependencies": {

packages/cmf/__tests__/componentState.test.js

@@ -1,5 +1,5 @@
 import PropTypes from 'prop-types';
-import Immutable, { Map } from 'immutable';
+import { Map, fromJS } from 'immutable';
 
 import state, {
 	getStateAccessors,
@@ -67,7 +67,7 @@ describe('state', () => {
 	it('should getStateProps return state', () => {
 		const storeState = {
 			cmf: {
-				components: Immutable.fromJS({
+				components: fromJS({
 					foo: {
 						bar: {
 							open: true,