From 7acd6d74353a0be6d0c52c7de96ab19f10e97e98 Mon Sep 17 00:00:00 2001
From: Braks <78412429+bcakmakoglu@users.noreply.github.com>
Date: Thu, 23 Oct 2025 16:30:27 +0200
Subject: [PATCH] refactor(core): separate import and export objects and
 interfaces (#1978)

* refactor(core): separate import and export objects and interfaces

Signed-off-by: braks <78412429+bcakmakoglu@users.noreply.github.com>

* chore(changeset): add

* chore: cleanup

Signed-off-by: braks <78412429+bcakmakoglu@users.noreply.github.com>

---------

Signed-off-by: braks <78412429+bcakmakoglu@users.noreply.github.com>
---
 .changeset/modern-rocks-breathe.md |  5 +++++
 packages/core/src/store/actions.ts | 10 +++++-----
 packages/core/src/types/flow.ts    |  2 ++
 packages/core/src/types/store.ts   |  3 ++-
 4 files changed, 14 insertions(+), 6 deletions(-)
 create mode 100644 .changeset/modern-rocks-breathe.md

diff --git a/.changeset/modern-rocks-breathe.md b/.changeset/modern-rocks-breathe.md
new file mode 100644
index 000000000..31f6b706a
--- /dev/null
+++ b/.changeset/modern-rocks-breathe.md
@@ -0,0 +1,5 @@
+---
+"@vue-flow/core": minor
+---
+
+Separate flow import and export object shapes and interfaces. An export object has all fields as required, while an import object makes all fields optional.
diff --git a/packages/core/src/store/actions.ts b/packages/core/src/store/actions.ts
index 5019c6168..5160c40ed 100644
--- a/packages/core/src/store/actions.ts
+++ b/packages/core/src/store/actions.ts
@@ -830,9 +830,9 @@ export function useActions(state: State, nodeLookup: ComputedRef<NodeLookup>, ed
         setEdges(edges)
       }
 
-      if ((viewport?.x && viewport?.y) || position) {
-        const x = viewport?.x || position[0]
-        const y = viewport?.y || position[1]
+      const [xPos, yPos] = viewport?.x && viewport?.y ? [viewport.x, viewport.y] : position ?? [null, null]
+
+      if (xPos && yPos) {
         const nextZoom = viewport?.zoom || zoom || state.viewport.zoom
 
         return until(() => viewportHelper.value.viewportInitialized)
@@ -840,8 +840,8 @@ export function useActions(state: State, nodeLookup: ComputedRef<NodeLookup>, ed
           .then(() => {
             viewportHelper.value
               .setViewport({
-                x,
-                y,
+                x: xPos,
+                y: yPos,
                 zoom: nextZoom,
               })
               .then(() => {
diff --git a/packages/core/src/types/flow.ts b/packages/core/src/types/flow.ts
index 4ea8134aa..7590d50e4 100644
--- a/packages/core/src/types/flow.ts
+++ b/packages/core/src/types/flow.ts
@@ -140,6 +140,8 @@ export interface FlowExportObject {
   viewport: ViewportTransform
 }
 
+export type FlowImportObject = { [key in keyof FlowExportObject]?: FlowExportObject[key] }
+
 export interface FlowProps {
   id?: string
   /**
diff --git a/packages/core/src/types/store.ts b/packages/core/src/types/store.ts
index 0fd614f82..14fce8f85 100644
--- a/packages/core/src/types/store.ts
+++ b/packages/core/src/types/store.ts
@@ -7,6 +7,7 @@ import type {
   Elements,
   FlowElements,
   FlowExportObject,
+  FlowImportObject,
   FlowOptions,
   FlowProps,
   Rect,
@@ -297,7 +298,7 @@ export interface Actions extends Omit<ViewportHelper, 'viewportInitialized'> {
   /** return an object of graph values (elements, viewport transform) for storage and re-loading a graph */
   toObject: () => FlowExportObject
   /** load graph from export obj */
-  fromObject: (obj: FlowExportObject) => Promise<boolean>
+  fromObject: (obj: FlowImportObject) => Promise<boolean>
   /** force update node internal data, if handle bounds are incorrect, you might want to use this */
   updateNodeInternals: UpdateNodeInternals
   /** start a connection */