Merge pull request #292 from eccenca/maintain/mergeReleaseTag-v24.3.0

Release process changes from v24.3.0

Author: haschek

CHANGELOG.md

@@ -6,9 +6,19 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
 
 ## [Unreleased]
 
+## [24.3.0] - 2025-06-05
+
 ### Added
 
--   added support for `react-flow` v12 for `NodeContent` component, added v12-related components: `EdgeDefaultV12`, `NodeDefaultV12`, `EdgeDefs`
+-   added support for React Flow v12
+    -   `<NodeContent />` can used with `flowVersion="v12"`
+    -   more v12-only components: `EdgeDefaultV12`, `NodeDefaultV12`, `EdgeDefs`
+        -   they may be removed in future version when v12 elements are available direcly via `<EdgeDefault />` and `<NodeDefault />`
+
+### Deprecated
+
+-   `<EdgeDefaultV12 />` and `<NodeDefaultV12 />` will be removed when React Flow v12 is supported directly by `<EdgeDefault />` and `<NodeDefault />`
+-   `flowVersion` property: `legacy` and `next` will be removed/replaced by `v##` values
 
 ## [24.2.0] - 2025-06-04
 

package.json

@@ -1,7 +1,7 @@
 {
     "name": "@eccenca/gui-elements",
     "description": "GUI elements based on other libraries, usable in React application, written in Typescript.",
-    "version": "24.2.0",
+    "version": "24.3.0",
     "license": "Apache-2.0",
     "homepage": "https://github.com/eccenca/gui-elements",
     "bugs": "https://github.com/eccenca/gui-elements/issues",

src/extensions/react-flow/edges/EdgeDefaultV12.tsx

@@ -41,6 +41,11 @@ export type EdgeDefaultV12DataProps = Record<string, unknown> & {
     edgeSvgProps?: React.SVGProps<SVGGElement>;
 };
 
+/**
+ * This element cannot be used directly, it must be connected via a `edgeTypes` definition.
+ * @see https://reactflow.dev/docs/api/nodes/
+ * @deprecated (v26) will be removed when `EdgeDefault` supports v12 directly
+ */
 export const EdgeDefaultV12 = memo(
     ({
         id,

src/extensions/react-flow/nodes/NodeContent.tsx

@@ -156,7 +156,7 @@ export interface NodeContentProps<NODE_DATA, NODE_CONTENT_PROPS = any>
      * Array of property definition objects for `Handle` components that need to be created for the node.
      * @see https://reactflow.dev/docs/api/handle/
      */
-    handles?: NodeContentHandleLegacyProps[] | NodeContentHandleNextProps[] | NodeContentHandleV12Props[];
+    handles?: NodeContentHandleProps[];
     /**
      * Set the minimal number of handles on left or right side of the node to activate the recalculation of the minimal height of the node.
      */

src/extensions/react-flow/nodes/NodeDefaultV12.tsx

@@ -14,9 +14,9 @@ export interface NodeDefaultProps<NODE_DATA, NODE_CONTENT_PROPS = any> extends R
 }
 
 /**
- * The `NodeDefault` element manages the display of React-Flow nodes.
- * This element cannot be used directly, it must be connected via a `nodeTypes` definition and all properties need to be routed through the `elements` property items inside the `ReactFlow` container.
+ * This element cannot be used directly, it must be connected via a `nodeTypes` definition.
  * @see https://reactflow.dev/docs/api/nodes/
+ * @deprecated (v26) will be removed when `NodeDefault` supports v12 directly
  */
 export const NodeDefaultV12 = memo((node: NodeDefaultProps<any>) => {
     const {

src/extensions/react-flow/versionsupport.ts

@@ -5,6 +5,7 @@ import { useStore as useStoreFlowV12 } from "@xyflow/react";
 export interface ReacFlowVersionSupportProps {
     /**
      * Spevifies the context of the react flow renderer version that is used for the component.
+     * @deprecated (v25) `legacy` and `next` will be removed/replaced by `v##` values in future versions
      */
     flowVersion?: "v12" | "legacy" | "next" | "none";
 }