a

.changeset/tame-bulldogs-juggle.md

@@ -0,0 +1,5 @@
+---
+'@xyflow/react': patch
+---
+
+fix: improve TSDoc comments for `EdgeLabelOptions` and `EdgeTextProps`

packages/react/src/components/Edges/EdgeText.tsx

@@ -8,9 +8,9 @@ function EdgeTextComponent({
   x,
   y,
   label,
-  labelStyle = {},
+  labelStyle,
   labelShowBg = true,
-  labelBgStyle = {},
+  labelBgStyle,
   labelBgPadding = [2, 4],
   labelBgBorderRadius = 2,
   children,
@@ -34,7 +34,7 @@ function EdgeTextComponent({
     }
   }, [label]);
 
-  if (typeof label === 'undefined' || !label) {
+  if (!label) {
     return null;
   }
 

packages/react/src/types/edges.ts

@@ -28,6 +28,9 @@ export type EdgeLabelOptions = {
    * custom controls.
    */
   label?: ReactNode;
+  /**
+   * Custom styles to apply to the label.
+   */
   labelStyle?: CSSProperties;
   labelShowBg?: boolean;
   labelBgStyle?: CSSProperties;
@@ -108,7 +111,13 @@ export type DefaultEdgeOptions = DefaultEdgeOptionsBase<Edge>;
 
 export type EdgeTextProps = SVGAttributes<SVGElement> &
   EdgeLabelOptions & {
+    /**
+     * The x position where the label should be rendered.
+     */
     x: number;
+    /**
+     * The y position where the label should be rendered.
+     */
     y: number;
   };