From 55fa118f0bd0deff3aa0fed6fd44ab5c44bfcbd0 Mon Sep 17 00:00:00 2001
From: matcane <mateuszcane@gmail.com>
Date: Sat, 19 Sep 2026 15:22:31 +0200
Subject: [PATCH] docs(slider): add JSDoc to props

---
 src/ImageComparisonSlider.tsx | 29 ++++++++++++++++++++++++++++-
 1 file changed, 28 insertions(+), 1 deletion(-)

diff --git a/src/ImageComparisonSlider.tsx b/src/ImageComparisonSlider.tsx
index ecf79ba..afa3c30 100644
--- a/src/ImageComparisonSlider.tsx
+++ b/src/ImageComparisonSlider.tsx
@@ -22,20 +22,47 @@ const LINE_WIDTH = 3;
 
 type PassThroughImageProps = Omit<ImageProps, "source" | "style" | "contentFit">;
 
+/** Props for {@link ImageComparisonSlider}. */
 export interface ImageComparisonSliderProps {
+  /** Revealed image */
   before: ImageSource | number;
+
+  /** Background image */
   after: ImageSource | number;
+
+  /** Split ratio, 0–1 */
   initialPosition?: number;
-  contentFit?: ImageProps["contentFit"];
+
+  /** Comparison UI and gestures */
   enabled?: boolean;
+
+  /** Both images */
+  contentFit?: ImageProps["contentFit"];
+
+  /** Image stack corners */
   borderRadius?: number;
+
+  /** Root container */
   style?: StyleProp<ViewStyle>;
+
+  /** Knob children */
   knobContent?: ReactNode;
+
+  /** Divider line */
   renderLine?: ReactNode;
+
+  /** before (expo-image, minus source / style / contentFit) */
   beforeImageProps?: PassThroughImageProps;
+
+  /** after */
   afterImageProps?: PassThroughImageProps;
 }
 
+/**
+ * Before/after image comparison slider for React Native and Expo.
+ *
+ * @see {@link ImageComparisonSliderProps}
+ */
 export function ImageComparisonSlider({
   before,
   after,