react-native-gesture-image-viewer 1.4.0 → 1.4.1

package/lib/module/GestureViewerManager.js

@@ -28,7 +28,7 @@ class GestureViewerManager {
   getState() {
     return {
       currentIndex: this.currentIndex,
-      dataLength: this.dataLength
+      totalCount: this.dataLength
     };
   }
   setWidth(width) {
@@ -63,21 +63,6 @@ class GestureViewerManager {
   setRotation(rotation) {
     this.rotation = rotation;
   }
-
-  /**
-   * @param angle - The angle to rotate.
-   * @default 90 (0, 90, 180, 270, 360)
-   * @param clockwise - The direction to rotate.
-   * @default true (clockwise)
-   *
-   * @example
-   * rotate(0) // reset rotation
-   * rotate(number, false) // rotate {number} degrees counter-clockwise
-   * rotate(90) // rotate 90 degrees clockwise
-   * rotate(180) // rotate 180 degrees clockwise
-   * rotate(270) // rotate 270 degrees clockwise
-   * rotate(360) // rotate 360 degrees clockwise
-   */
   rotate = (angle = 90, clockwise = true) => {
     const MAX_ANGLE = 360;
     if (!this.rotation || angle < 0 || angle > MAX_ANGLE || angle !== 0 && this.rotation.value % angle !== 0 && angle !== 360) {
@@ -95,12 +80,6 @@ class GestureViewerManager {
     const nextAngle = clockwise ? this.rotation.value + angle : this.rotation.value - angle;
     this.rotation.value = withTiming(nextAngle);
   };
-
-  /**
-   * @param multiplier - The multiplier to zoom in.
-   * @range 0.01 - 1
-   * @default 0.25
-   */
   zoomIn = (multiplier = 0.25) => {
     if (!this.scale || !this.translateX || !this.translateY || multiplier < 0.01 || multiplier > 1) {
       return;
@@ -121,12 +100,6 @@ class GestureViewerManager {
     this.translateX.value = withTiming(translateX);
     this.translateY.value = withTiming(translateY);
   };
-
-  /**
-   * @param multiplier - The multiplier to zoom out.
-   * @range 0.01 - 1
-   * @default 0.25
-   */
   zoomOut = (multiplier = 0.25) => {
     if (!this.scale || !this.translateX || !this.translateY || multiplier < 0.01 || multiplier > 1) {
       return;
@@ -152,11 +125,6 @@ class GestureViewerManager {
     this.translateX.value = withTiming(translateX);
     this.translateY.value = withTiming(translateY);
   };
-
-  /**
-   * @param scale - The scale to reset to.
-   * @default 1
-   */
   resetZoom = (scale = 1) => {
     if (!this.scale || !this.translateX || !this.translateY || scale <= 0 || scale > this.maxZoomScale) {
       return;

package/lib/module/GestureViewerManager.js.map

@@ -1 +1 @@
-{"version":3,"names":["withTiming","createBoundsConstraint","GestureViewerManager","currentIndex","dataLength","width","height","scale","translateX","translateY","maxZoomScale","listRef","enableSwipeGesture","listeners","Set","rotation","notifyListeners","state","getState","forEach","listener","subscribe","add","delete","setWidth","setHeight","setListRef","ref","setDataLength","length","setEnableSwipeGesture","enabled","setCurrentIndex","index","setZoomSharedValues","notifyStateChange","setRotation","rotate","angle","clockwise","MAX_ANGLE","value","nextAngle","Math","floor","zoomIn","multiplier","nextScale","min","zoomOut","max","resetZoom","goToIndex","scrollToIndex","animated","scrollTo","x","goToPrevious","goToNext","cleanUp","clear"],"sourceRoot":"../../src","sources":["GestureViewerManager.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["withTiming","createBoundsConstraint","GestureViewerManager","currentIndex","dataLength","width","height","scale","translateX","translateY","maxZoomScale","listRef","enableSwipeGesture","listeners","Set","rotation","notifyListeners","state","getState","forEach","listener","subscribe","add","delete","totalCount","setWidth","setHeight","setListRef","ref","setDataLength","length","setEnableSwipeGesture","enabled","setCurrentIndex","index","setZoomSharedValues","notifyStateChange","setRotation","rotate","angle","clockwise","MAX_ANGLE","value","nextAngle","Math","floor","zoomIn","multiplier","nextScale","min","zoomOut","max","resetZoom","goToIndex","scrollToIndex","animated","scrollTo","x","goToPrevious","goToNext","cleanUp","clear"],"sourceRoot":"../../src","sources":["GestureViewerManager.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/useGestureViewerController.js

@@ -2,10 +2,62 @@
 
 import { useEffect, useMemo, useRef, useState } from 'react';
 import { registry } from "./GestureViewerRegistry.js";
+/**
+ * Hook to control the gesture viewer programmatically.
+ *
+ * @param id - Viewer instance identifier (default: 'default')
+ * @returns Methods and state for controlling the viewer
+ *
+ * **Available methods:**
+ * - `goToIndex(index: number)` - Navigate to specific index (0 to totalCount-1)
+ * - `goToPrevious()` - Navigate to previous item
+ * - `goToNext()` - Navigate to next item
+ * - `zoomIn(multiplier?: number)` - Zoom in (default: 0.25)
+ * - `zoomOut(multiplier?: number)` - Zoom out (default: 0.25)
+ * - `resetZoom(scale?: number)` - Reset zoom level (default: 1.0)
+ * - `rotate(angle?: 0|90|180|270|360, clockwise?: boolean)` - Rotate content (default: 90° clockwise)
+ *
+ * **Available state:**
+ * - `currentIndex: number` - Current active index (read-only)
+ * - `totalCount: number` - Total number of items (read-only)
+ *
+ * @example
+ * ```tsx
+ * const { goToIndex, goToNext, goToPrevious, zoomIn, zoomOut, resetZoom, rotate, currentIndex, totalCount } = useGestureViewerController();
+ *
+ * // Navigate to specific index
+ * goToIndex(2);
+ *
+ * // Go to next image
+ * goToNext();
+ *
+ * // Zoom in by 25%
+ * zoomIn();
+ *
+ * // Zoom out by 50%
+ * zoomOut(0.5);
+ *
+ * // Reset to original size
+ * resetZoom();
+ *
+ * // Rotate 90 degrees clockwise
+ * rotate();
+ *
+ * // Rotate 180 degrees
+ * rotate(180);
+ *
+ * // Check current state
+ * console.log(`Image ${currentIndex + 1} of ${totalCount}`);
+ *
+ * // Check navigation availability
+ * const canGoNext = currentIndex < totalCount - 1;
+ * const canGoPrevious = currentIndex > 0;
+ * ```
+ */
 export const useGestureViewerController = (id = 'default') => {
   const [state, setState] = useState({
     currentIndex: 0,
-    dataLength: 0
+    totalCount: 0
   });
   const [manager, setManager] = useState(null);
   const unsubscribeRef = useRef(null);
@@ -21,7 +73,7 @@ export const useGestureViewerController = (id = 'default') => {
       }
       setState({
         currentIndex: 0,
-        dataLength: 0
+        totalCount: 0
       });
     };
     const unsubscribeFromRegistry = registry.subscribeToManager(id, handleManagerChange);
@@ -39,8 +91,7 @@ export const useGestureViewerController = (id = 'default') => {
     zoomOut: manager?.zoomOut || noopFunction,
     resetZoom: manager?.resetZoom || noopFunction,
     rotate: manager?.rotate || noopFunction,
-    currentIndex: state.currentIndex,
-    totalCount: state.dataLength
+    ...state
   };
 };
 //# sourceMappingURL=useGestureViewerController.js.map

package/lib/module/useGestureViewerController.js.map

@@ -1 +1 @@
-{"version":3,"names":["useEffect","useMemo","useRef","useState","registry","useGestureViewerController","id","state","setState","currentIndex","dataLength","manager","setManager","unsubscribeRef","handleManagerChange","newManager","current","getState","subscribe","unsubscribeFromRegistry","subscribeToManager","noopFunction","goToIndex","goToPrevious","goToNext","zoomIn","zoomOut","resetZoom","rotate","totalCount"],"sourceRoot":"../../src","sources":["useGestureViewerController.ts"],"mappings":";;AAAA,SAASA,SAAS,EAAEC,OAAO,EAAEC,MAAM,EAAEC,QAAQ,QAAQ,OAAO;AAG5D,SAASC,QAAQ,QAAQ,4BAAyB;AAElD,OAAO,MAAMC,0BAA0B,GAAGA,CAACC,EAAE,GAAG,SAAS,KAAK;EAC5D,MAAM,CAACC,KAAK,EAAEC,QAAQ,CAAC,GAAGL,QAAQ,CAA4B;IAC5DM,YAAY,EAAE,CAAC;IACfC,UAAU,EAAE;EACd,CAAC,CAAC;EAEF,MAAM,CAACC,OAAO,EAAEC,UAAU,CAAC,GAAGT,QAAQ,CAA8B,IAAI,CAAC;EACzE,MAAMU,cAAc,GAAGX,MAAM,CAAsB,IAAI,CAAC;EAExDF,SAAS,CAAC,MAAM;IACd,MAAMc,mBAAmB,GAAIC,UAAuC,IAAK;MACvEF,cAAc,CAACG,OAAO,GAAG,CAAC;MAC1BH,cAAc,CAACG,OAAO,GAAG,IAAI;MAE7BJ,UAAU,CAACG,UAAU,CAAC;MAEtB,IAAIA,UAAU,EAAE;QACdP,QAAQ,CAACO,UAAU,CAACE,QAAQ,CAAC,CAAC,CAAC;QAC/BJ,cAAc,CAACG,OAAO,GAAGD,UAAU,CAACG,SAAS,CAACV,QAAQ,CAAC;QACvD;MACF;MAEAA,QAAQ,CAAC;QAAEC,YAAY,EAAE,CAAC;QAAEC,UAAU,EAAE;MAAE,CAAC,CAAC;IAC9C,CAAC;IAED,MAAMS,uBAAuB,GAAGf,QAAQ,CAACgB,kBAAkB,CAACd,EAAE,EAAEQ,mBAAmB,CAAC;IAEpF,OAAO,MAAM;MACXK,uBAAuB,CAAC,CAAC;MACzBN,cAAc,CAACG,OAAO,GAAG,CAAC;IAC5B,CAAC;EACH,CAAC,EAAE,CAACV,EAAE,CAAC,CAAC;EAER,MAAMe,YAAY,GAAGpB,OAAO,CAAC,MAAM,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC;EAEhD,OAAO;IACLqB,SAAS,EAAEX,OAAO,EAAEW,SAAS,IAAID,YAAY;IAC7CE,YAAY,EAAEZ,OAAO,EAAEY,YAAY,IAAIF,YAAY;IACnDG,QAAQ,EAAEb,OAAO,EAAEa,QAAQ,IAAIH,YAAY;IAC3CI,MAAM,EAAEd,OAAO,EAAEc,MAAM,IAAIJ,YAAY;IACvCK,OAAO,EAAEf,OAAO,EAAEe,OAAO,IAAIL,YAAY;IACzCM,SAAS,EAAEhB,OAAO,EAAEgB,SAAS,IAAIN,YAAY;IAC7CO,MAAM,EAAEjB,OAAO,EAAEiB,MAAM,IAAIP,YAAY;IACvCZ,YAAY,EAAEF,KAAK,CAACE,YAAY;IAChCoB,UAAU,EAAEtB,KAAK,CAACG;EACpB,CAAC;AACH,CAAC","ignoreList":[]}
+{"version":3,"names":["useEffect","useMemo","useRef","useState","registry","useGestureViewerController","id","state","setState","currentIndex","totalCount","manager","setManager","unsubscribeRef","handleManagerChange","newManager","current","getState","subscribe","unsubscribeFromRegistry","subscribeToManager","noopFunction","goToIndex","goToPrevious","goToNext","zoomIn","zoomOut","resetZoom","rotate"],"sourceRoot":"../../src","sources":["useGestureViewerController.ts"],"mappings":";;AAAA,SAASA,SAAS,EAAEC,OAAO,EAAEC,MAAM,EAAEC,QAAQ,QAAQ,OAAO;AAE5D,SAASC,QAAQ,QAAQ,4BAAyB;AAGlD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,0BAA0B,GAAGA,CAACC,EAAE,GAAG,SAAS,KAA8B;EACrF,MAAM,CAACC,KAAK,EAAEC,QAAQ,CAAC,GAAGL,QAAQ,CAA+B;IAC/DM,YAAY,EAAE,CAAC;IACfC,UAAU,EAAE;EACd,CAAC,CAAC;EAEF,MAAM,CAACC,OAAO,EAAEC,UAAU,CAAC,GAAGT,QAAQ,CAA8B,IAAI,CAAC;EACzE,MAAMU,cAAc,GAAGX,MAAM,CAAsB,IAAI,CAAC;EAExDF,SAAS,CAAC,MAAM;IACd,MAAMc,mBAAmB,GAAIC,UAAuC,IAAK;MACvEF,cAAc,CAACG,OAAO,GAAG,CAAC;MAC1BH,cAAc,CAACG,OAAO,GAAG,IAAI;MAE7BJ,UAAU,CAACG,UAAU,CAAC;MAEtB,IAAIA,UAAU,EAAE;QACdP,QAAQ,CAACO,UAAU,CAACE,QAAQ,CAAC,CAAC,CAAC;QAC/BJ,cAAc,CAACG,OAAO,GAAGD,UAAU,CAACG,SAAS,CAACV,QAAQ,CAAC;QACvD;MACF;MAEAA,QAAQ,CAAC;QAAEC,YAAY,EAAE,CAAC;QAAEC,UAAU,EAAE;MAAE,CAAC,CAAC;IAC9C,CAAC;IAED,MAAMS,uBAAuB,GAAGf,QAAQ,CAACgB,kBAAkB,CAACd,EAAE,EAAEQ,mBAAmB,CAAC;IAEpF,OAAO,MAAM;MACXK,uBAAuB,CAAC,CAAC;MACzBN,cAAc,CAACG,OAAO,GAAG,CAAC;IAC5B,CAAC;EACH,CAAC,EAAE,CAACV,EAAE,CAAC,CAAC;EAER,MAAMe,YAAY,GAAGpB,OAAO,CAAC,MAAM,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC;EAEhD,OAAO;IACLqB,SAAS,EAAEX,OAAO,EAAEW,SAAS,IAAID,YAAY;IAC7CE,YAAY,EAAEZ,OAAO,EAAEY,YAAY,IAAIF,YAAY;IACnDG,QAAQ,EAAEb,OAAO,EAAEa,QAAQ,IAAIH,YAAY;IAC3CI,MAAM,EAAEd,OAAO,EAAEc,MAAM,IAAIJ,YAAY;IACvCK,OAAO,EAAEf,OAAO,EAAEe,OAAO,IAAIL,YAAY;IACzCM,SAAS,EAAEhB,OAAO,EAAEgB,SAAS,IAAIN,YAAY;IAC7CO,MAAM,EAAEjB,OAAO,EAAEiB,MAAM,IAAIP,YAAY;IACvC,GAAGd;EACL,CAAC;AACH,CAAC","ignoreList":[]}

package/lib/typescript/src/GestureViewerManager.d.ts

@@ -1,8 +1,5 @@
 import { type SharedValue } from 'react-native-reanimated';
-export type GestureViewerManagerState = {
-    currentIndex: number;
-    dataLength: number;
-};
+import type { GestureViewerControllerState } from './types';
 declare class GestureViewerManager {
     private currentIndex;
     private dataLength;
@@ -17,10 +14,10 @@ declare class GestureViewerManager {
     private listeners;
     private rotation;
     private notifyListeners;
-    subscribe(listener: (state: GestureViewerManagerState) => void): () => void;
+    subscribe(listener: (state: GestureViewerControllerState) => void): () => void;
     getState(): {
         currentIndex: number;
-        dataLength: number;
+        totalCount: number;
     };
     setWidth(width: number): void;
     setHeight(height: number): void;
@@ -31,37 +28,9 @@ declare class GestureViewerManager {
     setZoomSharedValues(scale: SharedValue<number>, translateX: SharedValue<number>, translateY: SharedValue<number>, maxZoomScale: number): void;
     notifyStateChange(): void;
     setRotation(rotation: SharedValue<number>): void;
-    /**
-     * @param angle - The angle to rotate.
-     * @default 90 (0, 90, 180, 270, 360)
-     * @param clockwise - The direction to rotate.
-     * @default true (clockwise)
-     *
-     * @example
-     * rotate(0) // reset rotation
-     * rotate(number, false) // rotate {number} degrees counter-clockwise
-     * rotate(90) // rotate 90 degrees clockwise
-     * rotate(180) // rotate 180 degrees clockwise
-     * rotate(270) // rotate 270 degrees clockwise
-     * rotate(360) // rotate 360 degrees clockwise
-     */
     rotate: (angle?: 0 | 90 | 180 | 270 | 360, clockwise?: boolean) => void;
-    /**
-     * @param multiplier - The multiplier to zoom in.
-     * @range 0.01 - 1
-     * @default 0.25
-     */
     zoomIn: (multiplier?: number) => void;
-    /**
-     * @param multiplier - The multiplier to zoom out.
-     * @range 0.01 - 1
-     * @default 0.25
-     */
     zoomOut: (multiplier?: number) => void;
-    /**
-     * @param scale - The scale to reset to.
-     * @default 1
-     */
     resetZoom: (scale?: number) => void;
     goToIndex: (index: number) => void;
     goToPrevious: () => void;

package/lib/typescript/src/GestureViewerManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GestureViewerManager.d.ts","sourceRoot":"","sources":["../../../src/GestureViewerManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAc,MAAM,yBAAyB,CAAC;AAGvE,MAAM,MAAM,yBAAyB,GAAG;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,cAAM,oBAAoB;IACxB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,kBAAkB,CAAQ;IAClC,OAAO,CAAC,SAAS,CAAyD;IAC1E,OAAO,CAAC,QAAQ,CAAoC;IAEpD,OAAO,CAAC,eAAe;IAMvB,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,yBAAyB,KAAK,IAAI;IAQ9D,QAAQ;;;;IAOR,QAAQ,CAAC,KAAK,EAAE,MAAM;IAItB,SAAS,CAAC,MAAM,EAAE,MAAM;IAIxB,UAAU,CAAC,GAAG,EAAE,GAAG;IAInB,aAAa,CAAC,MAAM,EAAE,MAAM;IAI5B,qBAAqB,CAAC,OAAO,EAAE,OAAO;IAItC,eAAe,CAAC,KAAK,EAAE,MAAM;IAM7B,mBAAmB,CACjB,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,EAC1B,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,EAC/B,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,EAC/B,YAAY,EAAE,MAAM;IAQtB,iBAAiB;IAIjB,WAAW,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC;IAIzC;;;;;;;;;;;;;OAaG;IACH,MAAM,GAAI,QAAO,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAQ,EAAE,mBAAgB,UA2B9D;IAEF;;;;OAIG;IACH,MAAM,GAAI,mBAAiB,UAoBzB;IAEF;;;;OAIG;IACH,OAAO,GAAI,mBAAiB,UA0B1B;IAEF;;;OAGG;IACH,SAAS,GAAI,cAAS,UAQpB;IAEF,SAAS,GAAI,OAAO,MAAM,UAcxB;IAEF,YAAY,aAIV;IAEF,QAAQ,aAIN;IAEF,OAAO;CAaR;AAED,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"GestureViewerManager.d.ts","sourceRoot":"","sources":["../../../src/GestureViewerManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAc,MAAM,yBAAyB,CAAC;AACvE,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAG5D,cAAM,oBAAoB;IACxB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,kBAAkB,CAAQ;IAClC,OAAO,CAAC,SAAS,CAA4D;IAC7E,OAAO,CAAC,QAAQ,CAAoC;IAEpD,OAAO,CAAC,eAAe;IAMvB,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,4BAA4B,KAAK,IAAI;IAQjE,QAAQ;;;;IAOR,QAAQ,CAAC,KAAK,EAAE,MAAM;IAItB,SAAS,CAAC,MAAM,EAAE,MAAM;IAIxB,UAAU,CAAC,GAAG,EAAE,GAAG;IAInB,aAAa,CAAC,MAAM,EAAE,MAAM;IAI5B,qBAAqB,CAAC,OAAO,EAAE,OAAO;IAItC,eAAe,CAAC,KAAK,EAAE,MAAM;IAM7B,mBAAmB,CACjB,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,EAC1B,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,EAC/B,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,EAC/B,YAAY,EAAE,MAAM;IAQtB,iBAAiB;IAIjB,WAAW,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC;IAIzC,MAAM,GAAI,QAAO,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAQ,EAAE,mBAAgB,UA2B9D;IAEF,MAAM,GAAI,mBAAiB,UAoBzB;IAEF,OAAO,GAAI,mBAAiB,UA0B1B;IAEF,SAAS,GAAI,cAAS,UAQpB;IAEF,SAAS,GAAI,OAAO,MAAM,UAcxB;IAEF,YAAY,aAIV;IAEF,QAAQ,aAIN;IAEF,OAAO;CAaR;AAED,eAAe,oBAAoB,CAAC"}

package/lib/typescript/src/index.d.ts

@@ -1,4 +1,4 @@
 export { GestureViewer } from './GestureViewer';
-export type { GestureViewerProps } from './types';
+export type { GestureViewerController, GestureViewerProps } from './types';
 export { useGestureViewerController } from './useGestureViewerController';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC"}

package/lib/typescript/src/types.d.ts

@@ -9,7 +9,7 @@ export interface GestureViewerProps<T = any, LC = typeof RNFlatList> {
     /**
      * When you want to efficiently manage multiple `GestureViewer` instances, you can use the `id` prop to use multiple `GestureViewer` components.
      * @remark `GestureViewer` automatically removes instances from memory when components are unmounted, so no manual memory management is required.
-     * @default 'default'
+     * @defaultValue 'default'
      */
     id?: string;
     /**
@@ -18,7 +18,7 @@ export interface GestureViewerProps<T = any, LC = typeof RNFlatList> {
     data: T[];
     /**
      * The index of the item to display in the `GestureViewer` when the component is mounted.
-     * @default 0
+     * @defaultValue 0
      */
     initialIndex?: number;
     /**
@@ -44,7 +44,7 @@ export interface GestureViewerProps<T = any, LC = typeof RNFlatList> {
     /**
      * The width of the `GestureViewer`.
      * @remark If you don't set this prop, the width of the `GestureViewer` will be the same as the width of the screen.
-     * @default screen width
+     * @defaultValue screen width
      */
     width?: number;
     /**
@@ -57,30 +57,30 @@ export interface GestureViewerProps<T = any, LC = typeof RNFlatList> {
      * **`true`**: Snap mode (`snapToInterval` auto-calculated)
      * - `snapToInterval` is automatically calculated based on `width` and `itemSpacing` values
      * - Use this option when you need item spacing
-     * @default false
+     * @defaultValue false
      *
      */
     useSnap?: boolean;
     /**
      * `dismissThreshold` controls when `onDismiss` is called by applying a threshold value during vertical gestures.
-     * @default 80
+     * @defaultValue 80
      */
     dismissThreshold?: number;
     /**
      * Calls `onDismiss` function when swiping down.
      * @remark Useful for closing modals with downward swipe gestures.
-     * @default true
+     * @defaultValue true
      */
     enableDismissGesture?: boolean;
     /**
      * Controls left/right swipe gestures.
      * @remark When `false`, horizontal gestures are disabled.
-     * @default true
+     * @defaultValue true
      */
     enableSwipeGesture?: boolean;
     /**
      * `resistance` controls the range of vertical movement by applying resistance during vertical gestures.
-     * @default 2
+     * @defaultValue 2
      */
     resistance?: number;
     /**
@@ -99,38 +99,167 @@ export interface GestureViewerProps<T = any, LC = typeof RNFlatList> {
     /**
      * By default, the background `opacity` gradually decreases from 1 to 0 during downward swipe gestures.
      * @remark When `false`, this animation is disabled.
-     * @default true
+     * @defaultValue true
      */
     animateBackdrop?: boolean;
     /**
      * Only works when zoom is active, allows moving item position when zoomed.
      * @remark When `false`, gesture movement is disabled during zoom.
-     * @default true
+     * @defaultValue true
      */
     enableZoomPanGesture?: boolean;
     /**
      * Controls two-finger pinch gestures.
      * @remark When `false`, two-finger zoom gestures are disabled.
-     * @default true
+     * @defaultValue true
      */
     enableZoomGesture?: boolean;
     /**
      * Controls double-tap zoom gestures.
      * @remark When `false`, double-tap zoom gestures are disabled.
-     * @default true
+     * @defaultValue true
      */
     enableDoubleTapGesture?: boolean;
     /**
      * The maximum zoom scale.
-     * @default 2
+     * @defaultValue 2
      */
     maxZoomScale?: number;
     /**
      * The spacing between items in pixels.
      * @remark Only applied when `useSnap` is `true`.
-     * @default 0
+     * @defaultValue 0
      */
     itemSpacing?: number;
 }
+/**
+ * Supported rotation angles in degrees.
+ */
+export type RotationAngle = 0 | 90 | 180 | 270 | 360;
+/**
+ * Controller for managing gesture-based image/content viewer interactions.
+ * Provides navigation, zoom, and rotation capabilities with state management.
+ */
+export type GestureViewerController = {
+    /**
+     * Navigates to the specified index in the viewer.
+     * Updates the currentIndex in the controller state.
+     *
+     * @param index - The target index (must be between 0 and totalCount - 1)
+     * @throws Will throw an error if index is out of bounds
+     *
+     * @example
+     * ```typescript
+     * controller.goToIndex(0); // Go to first item
+     * controller.goToIndex(controller.totalCount - 1); // Go to last item
+     * ```
+     */
+    goToIndex: (index: number) => void;
+    /**
+     * Navigates to the previous item in the sequence.
+     * If already at the first item, behavior depends on implementation (may wrap or do nothing).
+     * Updates currentIndex in the controller state.
+     */
+    goToPrevious: () => void;
+    /**
+     * Navigates to the next item in the sequence.
+     * If already at the last item, behavior depends on implementation (may wrap or do nothing).
+     * Updates currentIndex in the controller state.
+     */
+    goToNext: () => void;
+    /**
+     * Zooms in by the specified multiplier.
+     *
+     * @param multiplier - The zoom multiplier (0.01 - 1.0). Higher values zoom in more.
+     * @defaultValue 0.25
+     *
+     * @example
+     * ```typescript
+     * controller.zoomIn(); // Zoom in by 25%
+     * controller.zoomIn(0.5); // Zoom in by 50%
+     * ```
+     */
+    zoomIn: (multiplier?: number) => void;
+    /**
+     * Zooms out by the specified multiplier.
+     *
+     * @param multiplier - The zoom multiplier (0.01 - 1.0). Higher values zoom out more.
+     * @defaultValue 0.25
+     *
+     * @example
+     * ```typescript
+     * controller.zoomOut(); // Zoom out by 25%
+     * controller.zoomOut(0.1); // Zoom out by 10%
+     * ```
+     */
+    zoomOut: (multiplier?: number) => void;
+    /**
+     * Resets the zoom level to the specified scale.
+     *
+     * @param scale - The scale to reset to (1.0 = original size)
+     * @defaultValue 1.0
+     *
+     * @example
+     * ```typescript
+     * controller.resetZoom(); // Reset to original size
+     * controller.resetZoom(0.5); // Reset to 50% of original size
+     * ```
+     */
+    resetZoom: (scale?: number) => void;
+    /**
+     * Rotates the content by the specified angle.
+     *
+     * @param angle - Rotation angle in degrees. Must be one of: 0, 90, 180, 270, 360
+     * @param clockwise - Direction of rotation when angle is not 0 or 360
+     * @defaultValue angle: `90`, clockwise: `true`
+     *
+     * @remarks
+     * - Angle 0 or 360 resets rotation regardless of clockwise parameter
+     * - The clockwise parameter only affects rotation when angle is 90, 180, or 270
+     * - Rotation is cumulative and affects the current orientation
+     *
+     * @example
+     * ```typescript
+     * controller.rotate(); // Rotate 90 degrees clockwise
+     * controller.rotate(0); // Reset rotation
+     * controller.rotate(90, false); // Rotate 90 degrees counter-clockwise
+     * controller.rotate(180); // Rotate 180 degrees (clockwise by default)
+     * controller.rotate(270, false); // Rotate 270 degrees counter-clockwise
+     * controller.rotate(360); // Reset rotation (same as 0)
+     * ```
+     */
+    rotate: (angle?: RotationAngle, clockwise?: boolean) => void;
+} & GestureViewerControllerState;
+/**
+ * State information for the gesture viewer controller.
+ * Contains read-only properties that reflect the current state.
+ */
+export type GestureViewerControllerState = {
+    /**
+     * The current index of the active item in the viewer.
+     *
+     * @remarks
+     * This value is automatically updated when navigation methods are called.
+     *
+     * @example
+     * ```typescript
+     * console.log(`Currently viewing item ${controller.currentIndex + 1} of ${controller.totalCount}`);
+     * ```
+     */
+    readonly currentIndex: number;
+    /**
+     * The total number of items available in the viewer.
+     *
+     * @remarks
+     * This value determines the valid range for currentIndex (0 to totalCount - 1).
+     *
+     * @example
+     * ```typescript
+     * const hasNext = controller.currentIndex < controller.totalCount - 1;
+     * const hasPrevious = controller.currentIndex > 0;
+     * ```
+     */
+    readonly totalCount: number;
+};
 export {};
 //# sourceMappingURL=types.d.ts.map

package/lib/typescript/src/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,QAAQ,IAAI,UAAU,EAAE,UAAU,IAAI,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC7G,OAAO,KAAK,EAAE,QAAQ,IAAI,UAAU,EAAE,UAAU,IAAI,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAEvG,MAAM,MAAM,iBAAiB,GAAG,OAAO,UAAU,GAAG,OAAO,UAAU,CAAC;AACtE,MAAM,MAAM,mBAAmB,GAAG,OAAO,YAAY,GAAG,OAAO,YAAY,CAAC;AAE5E,KAAK,iBAAiB,CAAC,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAE/E,KAAK,oBAAoB,CAAC,EAAE,IAAI,EAAE,SAAS,iBAAiB,GACxD,KAAK,CAAC,cAAc,CAAC,EAAE,CAAC,GACxB,EAAE,SAAS,mBAAmB,GAC5B,KAAK,CAAC,cAAc,CAAC,EAAE,CAAC,GACxB,iBAAiB,CAAC,EAAE,CAAC,CAAC;AAE5B,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,GAAG,EAAE,EAAE,GAAG,OAAO,UAAU;IACjE;;;;OAIG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ;;OAEG;IACH,IAAI,EAAE,CAAC,EAAE,CAAC;IACV;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB;;OAEG;IACH,UAAU,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,KAAK,CAAC,YAAY,CAAC;IAC3D;;OAEG;IACH,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC,YAAY,KAAK,KAAK,CAAC,YAAY,CAAC;IACvE;;OAEG;IACH,aAAa,EAAE,EAAE,CAAC;IAClB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAG1B;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9C;;OAEG;IACH,aAAa,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACrC;;OAEG;IACH,cAAc,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IACtC;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/useGestureViewerController.d.ts

@@ -1,12 +1,55 @@
-export declare const useGestureViewerController: (id?: string) => {
-    goToIndex: (index: number) => void;
-    goToPrevious: () => void;
-    goToNext: () => void;
-    zoomIn: (multiplier?: number) => void;
-    zoomOut: (multiplier?: number) => void;
-    resetZoom: (scale?: number) => void;
-    rotate: (angle?: 0 | 90 | 180 | 270 | 360, clockwise?: boolean) => void;
-    currentIndex: number;
-    totalCount: number;
-};
+import type { GestureViewerController } from './types';
+/**
+ * Hook to control the gesture viewer programmatically.
+ *
+ * @param id - Viewer instance identifier (default: 'default')
+ * @returns Methods and state for controlling the viewer
+ *
+ * **Available methods:**
+ * - `goToIndex(index: number)` - Navigate to specific index (0 to totalCount-1)
+ * - `goToPrevious()` - Navigate to previous item
+ * - `goToNext()` - Navigate to next item
+ * - `zoomIn(multiplier?: number)` - Zoom in (default: 0.25)
+ * - `zoomOut(multiplier?: number)` - Zoom out (default: 0.25)
+ * - `resetZoom(scale?: number)` - Reset zoom level (default: 1.0)
+ * - `rotate(angle?: 0|90|180|270|360, clockwise?: boolean)` - Rotate content (default: 90° clockwise)
+ *
+ * **Available state:**
+ * - `currentIndex: number` - Current active index (read-only)
+ * - `totalCount: number` - Total number of items (read-only)
+ *
+ * @example
+ * ```tsx
+ * const { goToIndex, goToNext, goToPrevious, zoomIn, zoomOut, resetZoom, rotate, currentIndex, totalCount } = useGestureViewerController();
+ *
+ * // Navigate to specific index
+ * goToIndex(2);
+ *
+ * // Go to next image
+ * goToNext();
+ *
+ * // Zoom in by 25%
+ * zoomIn();
+ *
+ * // Zoom out by 50%
+ * zoomOut(0.5);
+ *
+ * // Reset to original size
+ * resetZoom();
+ *
+ * // Rotate 90 degrees clockwise
+ * rotate();
+ *
+ * // Rotate 180 degrees
+ * rotate(180);
+ *
+ * // Check current state
+ * console.log(`Image ${currentIndex + 1} of ${totalCount}`);
+ *
+ * // Check navigation availability
+ * const canGoNext = currentIndex < totalCount - 1;
+ * const canGoPrevious = currentIndex > 0;
+ * ```
+ */
+export declare const useGestureViewerController: (id?: string) => GestureViewerController;
 //# sourceMappingURL=useGestureViewerController.d.ts.map

package/lib/typescript/src/useGestureViewerController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useGestureViewerController.d.ts","sourceRoot":"","sources":["../../../src/useGestureViewerController.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,0BAA0B,GAAI,WAAc;;;;;;;;;;CA8CxD,CAAC"}
+{"version":3,"file":"useGestureViewerController.d.ts","sourceRoot":"","sources":["../../../src/useGestureViewerController.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,uBAAuB,EAAgC,MAAM,SAAS,CAAC;AAErF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,eAAO,MAAM,0BAA0B,GAAI,WAAc,KAAG,uBA6C3D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-gesture-image-viewer",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "description": "🖼️ A highly customizable and easy-to-use React Native image viewer with gesture support and external controls",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

package/src/GestureViewerManager.ts

@@ -1,11 +1,7 @@
 import { type SharedValue, withTiming } from 'react-native-reanimated';
+import type { GestureViewerControllerState } from './types';
 import { createBoundsConstraint } from './utils';
 
-export type GestureViewerManagerState = {
-  currentIndex: number;
-  dataLength: number;
-};
-
 class GestureViewerManager {
   private currentIndex = 0;
   private dataLength = 0;
@@ -17,7 +13,7 @@ class GestureViewerManager {
   private maxZoomScale = 2;
   private listRef: any | null = null;
   private enableSwipeGesture = true;
-  private listeners = new Set<(state: GestureViewerManagerState) => void>();
+  private listeners = new Set<(state: GestureViewerControllerState) => void>();
   private rotation: SharedValue<number> | null = null;
 
   private notifyListeners() {
@@ -26,7 +22,7 @@ class GestureViewerManager {
     this.listeners.forEach((listener) => listener(state));
   }
 
-  subscribe(listener: (state: GestureViewerManagerState) => void) {
+  subscribe(listener: (state: GestureViewerControllerState) => void) {
     this.listeners.add(listener);
 
     return () => {
@@ -37,7 +33,7 @@ class GestureViewerManager {
   getState() {
     return {
       currentIndex: this.currentIndex,
-      dataLength: this.dataLength,
+      totalCount: this.dataLength,
     };
   }
 
@@ -87,20 +83,6 @@ class GestureViewerManager {
     this.rotation = rotation;
   }
 
-  /**
-   * @param angle - The angle to rotate.
-   * @default 90 (0, 90, 180, 270, 360)
-   * @param clockwise - The direction to rotate.
-   * @default true (clockwise)
-   *
-   * @example
-   * rotate(0) // reset rotation
-   * rotate(number, false) // rotate {number} degrees counter-clockwise
-   * rotate(90) // rotate 90 degrees clockwise
-   * rotate(180) // rotate 180 degrees clockwise
-   * rotate(270) // rotate 270 degrees clockwise
-   * rotate(360) // rotate 360 degrees clockwise
-   */
   rotate = (angle: 0 | 90 | 180 | 270 | 360 = 90, clockwise = true) => {
     const MAX_ANGLE = 360;
 
@@ -130,11 +112,6 @@ class GestureViewerManager {
     this.rotation.value = withTiming(nextAngle);
   };
 
-  /**
-   * @param multiplier - The multiplier to zoom in.
-   * @range 0.01 - 1
-   * @default 0.25
-   */
   zoomIn = (multiplier = 0.25) => {
     if (!this.scale || !this.translateX || !this.translateY || multiplier < 0.01 || multiplier > 1) {
       return;
@@ -157,11 +134,6 @@ class GestureViewerManager {
     this.translateY.value = withTiming(translateY);
   };
 
-  /**
-   * @param multiplier - The multiplier to zoom out.
-   * @range 0.01 - 1
-   * @default 0.25
-   */
   zoomOut = (multiplier = 0.25) => {
     if (!this.scale || !this.translateX || !this.translateY || multiplier < 0.01 || multiplier > 1) {
       return;
@@ -190,10 +162,6 @@ class GestureViewerManager {
     this.translateY.value = withTiming(translateY);
   };
 
-  /**
-   * @param scale - The scale to reset to.
-   * @default 1
-   */
   resetZoom = (scale = 1) => {
     if (!this.scale || !this.translateX || !this.translateY || scale <= 0 || scale > this.maxZoomScale) {
       return;

package/src/index.tsx

@@ -1,3 +1,3 @@
 export { GestureViewer } from './GestureViewer';
-export type { GestureViewerProps } from './types';
+export type { GestureViewerController, GestureViewerProps } from './types';
 export { useGestureViewerController } from './useGestureViewerController';

package/src/types.ts

@@ -17,7 +17,7 @@ export interface GestureViewerProps<T = any, LC = typeof RNFlatList> {
   /**
    * When you want to efficiently manage multiple `GestureViewer` instances, you can use the `id` prop to use multiple `GestureViewer` components.
    * @remark `GestureViewer` automatically removes instances from memory when components are unmounted, so no manual memory management is required.
-   * @default 'default'
+   * @defaultValue 'default'
    */
   id?: string;
   /**
@@ -26,7 +26,7 @@ export interface GestureViewerProps<T = any, LC = typeof RNFlatList> {
   data: T[];
   /**
    * The index of the item to display in the `GestureViewer` when the component is mounted.
-   * @default 0
+   * @defaultValue 0
    */
   initialIndex?: number;
   /**
@@ -52,7 +52,7 @@ export interface GestureViewerProps<T = any, LC = typeof RNFlatList> {
   /**
    * The width of the `GestureViewer`.
    * @remark If you don't set this prop, the width of the `GestureViewer` will be the same as the width of the screen.
-   * @default screen width
+   * @defaultValue screen width
    */
   width?: number;
   /**
@@ -65,13 +65,13 @@ export interface GestureViewerProps<T = any, LC = typeof RNFlatList> {
    * **`true`**: Snap mode (`snapToInterval` auto-calculated)
    * - `snapToInterval` is automatically calculated based on `width` and `itemSpacing` values
    * - Use this option when you need item spacing
-   * @default false
+   * @defaultValue false
    *
    */
   useSnap?: boolean;
   /**
    * `dismissThreshold` controls when `onDismiss` is called by applying a threshold value during vertical gestures.
-   * @default 80
+   * @defaultValue 80
    */
   dismissThreshold?: number;
   // swipeThreshold?: number;
@@ -79,18 +79,18 @@ export interface GestureViewerProps<T = any, LC = typeof RNFlatList> {
   /**
    * Calls `onDismiss` function when swiping down.
    * @remark Useful for closing modals with downward swipe gestures.
-   * @default true
+   * @defaultValue true
    */
   enableDismissGesture?: boolean;
   /**
    * Controls left/right swipe gestures.
    * @remark When `false`, horizontal gestures are disabled.
-   * @default true
+   * @defaultValue true
    */
   enableSwipeGesture?: boolean;
   /**
    * `resistance` controls the range of vertical movement by applying resistance during vertical gestures.
-   * @default 2
+   * @defaultValue 2
    */
   resistance?: number;
   /**
@@ -109,36 +109,175 @@ export interface GestureViewerProps<T = any, LC = typeof RNFlatList> {
   /**
    * By default, the background `opacity` gradually decreases from 1 to 0 during downward swipe gestures.
    * @remark When `false`, this animation is disabled.
-   * @default true
+   * @defaultValue true
    */
   animateBackdrop?: boolean;
   /**
    * Only works when zoom is active, allows moving item position when zoomed.
    * @remark When `false`, gesture movement is disabled during zoom.
-   * @default true
+   * @defaultValue true
    */
   enableZoomPanGesture?: boolean;
   /**
    * Controls two-finger pinch gestures.
    * @remark When `false`, two-finger zoom gestures are disabled.
-   * @default true
+   * @defaultValue true
    */
   enableZoomGesture?: boolean;
   /**
    * Controls double-tap zoom gestures.
    * @remark When `false`, double-tap zoom gestures are disabled.
-   * @default true
+   * @defaultValue true
    */
   enableDoubleTapGesture?: boolean;
   /**
    * The maximum zoom scale.
-   * @default 2
+   * @defaultValue 2
    */
   maxZoomScale?: number;
   /**
    * The spacing between items in pixels.
    * @remark Only applied when `useSnap` is `true`.
-   * @default 0
+   * @defaultValue 0
    */
   itemSpacing?: number;
 }
+
+/**
+ * Supported rotation angles in degrees.
+ */
+export type RotationAngle = 0 | 90 | 180 | 270 | 360;
+
+/**
+ * Controller for managing gesture-based image/content viewer interactions.
+ * Provides navigation, zoom, and rotation capabilities with state management.
+ */
+export type GestureViewerController = {
+  /**
+   * Navigates to the specified index in the viewer.
+   * Updates the currentIndex in the controller state.
+   *
+   * @param index - The target index (must be between 0 and totalCount - 1)
+   * @throws Will throw an error if index is out of bounds
+   *
+   * @example
+   * ```typescript
+   * controller.goToIndex(0); // Go to first item
+   * controller.goToIndex(controller.totalCount - 1); // Go to last item
+   * ```
+   */
+  goToIndex: (index: number) => void;
+
+  /**
+   * Navigates to the previous item in the sequence.
+   * If already at the first item, behavior depends on implementation (may wrap or do nothing).
+   * Updates currentIndex in the controller state.
+   */
+  goToPrevious: () => void;
+
+  /**
+   * Navigates to the next item in the sequence.
+   * If already at the last item, behavior depends on implementation (may wrap or do nothing).
+   * Updates currentIndex in the controller state.
+   */
+  goToNext: () => void;
+
+  /**
+   * Zooms in by the specified multiplier.
+   *
+   * @param multiplier - The zoom multiplier (0.01 - 1.0). Higher values zoom in more.
+   * @defaultValue 0.25
+   *
+   * @example
+   * ```typescript
+   * controller.zoomIn(); // Zoom in by 25%
+   * controller.zoomIn(0.5); // Zoom in by 50%
+   * ```
+   */
+  zoomIn: (multiplier?: number) => void;
+
+  /**
+   * Zooms out by the specified multiplier.
+   *
+   * @param multiplier - The zoom multiplier (0.01 - 1.0). Higher values zoom out more.
+   * @defaultValue 0.25
+   *
+   * @example
+   * ```typescript
+   * controller.zoomOut(); // Zoom out by 25%
+   * controller.zoomOut(0.1); // Zoom out by 10%
+   * ```
+   */
+  zoomOut: (multiplier?: number) => void;
+
+  /**
+   * Resets the zoom level to the specified scale.
+   *
+   * @param scale - The scale to reset to (1.0 = original size)
+   * @defaultValue 1.0
+   *
+   * @example
+   * ```typescript
+   * controller.resetZoom(); // Reset to original size
+   * controller.resetZoom(0.5); // Reset to 50% of original size
+   * ```
+   */
+  resetZoom: (scale?: number) => void;
+
+  /**
+   * Rotates the content by the specified angle.
+   *
+   * @param angle - Rotation angle in degrees. Must be one of: 0, 90, 180, 270, 360
+   * @param clockwise - Direction of rotation when angle is not 0 or 360
+   * @defaultValue angle: `90`, clockwise: `true`
+   *
+   * @remarks
+   * - Angle 0 or 360 resets rotation regardless of clockwise parameter
+   * - The clockwise parameter only affects rotation when angle is 90, 180, or 270
+   * - Rotation is cumulative and affects the current orientation
+   *
+   * @example
+   * ```typescript
+   * controller.rotate(); // Rotate 90 degrees clockwise
+   * controller.rotate(0); // Reset rotation
+   * controller.rotate(90, false); // Rotate 90 degrees counter-clockwise
+   * controller.rotate(180); // Rotate 180 degrees (clockwise by default)
+   * controller.rotate(270, false); // Rotate 270 degrees counter-clockwise
+   * controller.rotate(360); // Reset rotation (same as 0)
+   * ```
+   */
+  rotate: (angle?: RotationAngle, clockwise?: boolean) => void;
+} & GestureViewerControllerState;
+
+/**
+ * State information for the gesture viewer controller.
+ * Contains read-only properties that reflect the current state.
+ */
+export type GestureViewerControllerState = {
+  /**
+   * The current index of the active item in the viewer.
+   *
+   * @remarks
+   * This value is automatically updated when navigation methods are called.
+   *
+   * @example
+   * ```typescript
+   * console.log(`Currently viewing item ${controller.currentIndex + 1} of ${controller.totalCount}`);
+   * ```
+   */
+  readonly currentIndex: number;
+
+  /**
+   * The total number of items available in the viewer.
+   *
+   * @remarks
+   * This value determines the valid range for currentIndex (0 to totalCount - 1).
+   *
+   * @example
+   * ```typescript
+   * const hasNext = controller.currentIndex < controller.totalCount - 1;
+   * const hasPrevious = controller.currentIndex > 0;
+   * ```
+   */
+  readonly totalCount: number;
+};

package/src/useGestureViewerController.ts

@@ -1,12 +1,64 @@
 import { useEffect, useMemo, useRef, useState } from 'react';
 import type GestureViewerManager from './GestureViewerManager';
-import type { GestureViewerManagerState } from './GestureViewerManager';
 import { registry } from './GestureViewerRegistry';
+import type { GestureViewerController, GestureViewerControllerState } from './types';
 
-export const useGestureViewerController = (id = 'default') => {
-  const [state, setState] = useState<GestureViewerManagerState>({
+/**
+ * Hook to control the gesture viewer programmatically.
+ *
+ * @param id - Viewer instance identifier (default: 'default')
+ * @returns Methods and state for controlling the viewer
+ *
+ * **Available methods:**
+ * - `goToIndex(index: number)` - Navigate to specific index (0 to totalCount-1)
+ * - `goToPrevious()` - Navigate to previous item
+ * - `goToNext()` - Navigate to next item
+ * - `zoomIn(multiplier?: number)` - Zoom in (default: 0.25)
+ * - `zoomOut(multiplier?: number)` - Zoom out (default: 0.25)
+ * - `resetZoom(scale?: number)` - Reset zoom level (default: 1.0)
+ * - `rotate(angle?: 0|90|180|270|360, clockwise?: boolean)` - Rotate content (default: 90° clockwise)
+ *
+ * **Available state:**
+ * - `currentIndex: number` - Current active index (read-only)
+ * - `totalCount: number` - Total number of items (read-only)
+ *
+ * @example
+ * ```tsx
+ * const { goToIndex, goToNext, goToPrevious, zoomIn, zoomOut, resetZoom, rotate, currentIndex, totalCount } = useGestureViewerController();
+ *
+ * // Navigate to specific index
+ * goToIndex(2);
+ *
+ * // Go to next image
+ * goToNext();
+ *
+ * // Zoom in by 25%
+ * zoomIn();
+ *
+ * // Zoom out by 50%
+ * zoomOut(0.5);
+ *
+ * // Reset to original size
+ * resetZoom();
+ *
+ * // Rotate 90 degrees clockwise
+ * rotate();
+ *
+ * // Rotate 180 degrees
+ * rotate(180);
+ *
+ * // Check current state
+ * console.log(`Image ${currentIndex + 1} of ${totalCount}`);
+ *
+ * // Check navigation availability
+ * const canGoNext = currentIndex < totalCount - 1;
+ * const canGoPrevious = currentIndex > 0;
+ * ```
+ */
+export const useGestureViewerController = (id = 'default'): GestureViewerController => {
+  const [state, setState] = useState<GestureViewerControllerState>({
     currentIndex: 0,
-    dataLength: 0,
+    totalCount: 0,
   });
 
   const [manager, setManager] = useState<GestureViewerManager | null>(null);
@@ -25,7 +77,7 @@ export const useGestureViewerController = (id = 'default') => {
         return;
       }
 
-      setState({ currentIndex: 0, dataLength: 0 });
+      setState({ currentIndex: 0, totalCount: 0 });
     };
 
     const unsubscribeFromRegistry = registry.subscribeToManager(id, handleManagerChange);
@@ -46,7 +98,6 @@ export const useGestureViewerController = (id = 'default') => {
     zoomOut: manager?.zoomOut || noopFunction,
     resetZoom: manager?.resetZoom || noopFunction,
     rotate: manager?.rotate || noopFunction,
-    currentIndex: state.currentIndex,
-    totalCount: state.dataLength,
+    ...state,
   };
 };