diff --git a/.changeset/hungry-coins-sparkle.md b/.changeset/hungry-coins-sparkle.md
new file mode 100644
index 00000000..a60ead63
--- /dev/null
+++ b/.changeset/hungry-coins-sparkle.md
@@ -0,0 +1,5 @@
+---
+'@xyflow/system': patch
+---
+
+fix: improve TSDoc comments for `HandleProps`, `NodeBase` and `InternalNodeBase`