add info to elements and changelog about future versions

Author: haschek

CHANGELOG.md

@@ -8,7 +8,15 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/) and this p
 
 ### 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`: `legacy` and `next` will be removed/replaced by `v##` values
 
 ## [24.2.0] - 2025-06-04
 

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/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";
 }