react-native-lumen 1.1.0 → 1.1.2

package/lib/module/constants/animations.js

@@ -1,7 +1,7 @@
 "use strict";
 
-/**
- * Default spring configuration matching Reanimated 3 defaults.
+/**
+ * Default spring configuration matching Reanimated 3 defaults.
  */
 export const Reanimated3DefaultSpringConfig = {
   damping: 10,
@@ -9,16 +9,16 @@ export const Reanimated3DefaultSpringConfig = {
   stiffness: 100
 };
 
-/**
- * Spring configuration with duration.
+/**
+ * Spring configuration with duration.
  */
 export const Reanimated3DefaultSpringConfigWithDuration = {
   duration: 1333,
   dampingRatio: 0.5
 };
 
-/**
- * A bouncy and energetic spring configuration.
+/**
+ * A bouncy and energetic spring configuration.
  */
 export const WigglySpringConfig = {
   damping: 90,
@@ -26,16 +26,16 @@ export const WigglySpringConfig = {
   stiffness: 900
 };
 
-/**
- * A bouncy spring configuration with fixed duration.
+/**
+ * A bouncy spring configuration with fixed duration.
  */
 export const WigglySpringConfigWithDuration = {
   duration: 550,
   dampingRatio: 0.75
 };
 
-/**
- * A gentle and smooth spring configuration.
+/**
+ * A gentle and smooth spring configuration.
  */
 export const GentleSpringConfig = {
   damping: 120,
@@ -43,16 +43,16 @@ export const GentleSpringConfig = {
   stiffness: 900
 };
 
-/**
- * A gentle spring configuration with fixed duration.
+/**
+ * A gentle spring configuration with fixed duration.
  */
 export const GentleSpringConfigWithDuration = {
   duration: 550,
   dampingRatio: 1
 };
 
-/**
- * A snappy and responsive spring configuration.
+/**
+ * A snappy and responsive spring configuration.
  */
 export const SnappySpringConfig = {
   damping: 110,
@@ -61,8 +61,8 @@ export const SnappySpringConfig = {
   overshootClamping: true
 };
 
-/**
- * A snappy spring configuration with fixed duration.
+/**
+ * A snappy spring configuration with fixed duration.
  */
 export const SnappySpringConfigWithDuration = {
   duration: 550,

package/lib/module/constants/defaults.js

@@ -12,9 +12,9 @@ export const DEFAULT_LABELS = {
   skip: 'Skip'
 };
 
-/**
- * Default zone style configuration.
- * These values are used when no custom style is provided.
+/**
+ * Default zone style configuration.
+ * These values are used when no custom style is provided.
  */
 export const DEFAULT_ZONE_STYLE = {
   padding: 0,
@@ -35,8 +35,8 @@ export const DEFAULT_ZONE_STYLE = {
   springStiffness: 90
 };
 
-/**
- * Merges global and per-step zone styles with defaults.
+/**
+ * Merges global and per-step zone styles with defaults.
  */
 export function resolveZoneStyle(globalStyle, stepStyle) {
   const merged = {

package/lib/module/hooks/useTourScrollView.js

@@ -2,28 +2,28 @@
 
 import { useCallback, useMemo } from 'react';
 import { useTour } from "./useTour.js";
-/**
- * Hook to simplify integrating custom scroll views with the tour system.
- *
- * @example
- * // Basic usage with Animated.ScrollView
- * const { scrollViewRef } = useTourScrollView();
- * return <Animated.ScrollView ref={scrollViewRef}>...</Animated.ScrollView>;
- *
- * @example
- * // With scroll disabled during tour
- * const { scrollViewProps } = useTourScrollView({ disableScrollDuringTour: true });
- * return <Animated.ScrollView {...scrollViewProps}>...</Animated.ScrollView>;
- *
- * @example
- * // Custom scroll view wrapper (forwardRef pattern)
- * const MyScrollView = forwardRef((props, ref) => {
- *   const { scrollViewRef } = useTourScrollView();
- *   useImperativeHandle(ref, () => ({
- *     getScrollRef: () => scrollViewRef.current,
- *   }));
- *   return <Animated.ScrollView ref={scrollViewRef} {...props} />;
- * });
+/**
+ * Hook to simplify integrating custom scroll views with the tour system.
+ *
+ * @example
+ * // Basic usage with Animated.ScrollView
+ * const { scrollViewRef } = useTourScrollView();
+ * return <Animated.ScrollView ref={scrollViewRef}>...</Animated.ScrollView>;
+ *
+ * @example
+ * // With scroll disabled during tour
+ * const { scrollViewProps } = useTourScrollView({ disableScrollDuringTour: true });
+ * return <Animated.ScrollView {...scrollViewProps}>...</Animated.ScrollView>;
+ *
+ * @example
+ * // Custom scroll view wrapper (forwardRef pattern)
+ * const MyScrollView = forwardRef((props, ref) => {
+ *   const { scrollViewRef } = useTourScrollView();
+ *   useImperativeHandle(ref, () => ({
+ *     getScrollRef: () => scrollViewRef.current,
+ *   }));
+ *   return <Animated.ScrollView ref={scrollViewRef} {...props} />;
+ * });
  */
 export function useTourScrollView(options = {}) {
   const {
@@ -34,7 +34,8 @@ export function useTourScrollView(options = {}) {
   const tour = useTour();
   const {
     scrollViewRef,
-    currentStep
+    currentStep,
+    triggerScrollEnd
   } = tour;
   const isTourActive = currentStep !== null;
   const scrollEnabled = disableScrollDuringTour ? !isTourActive : true;
@@ -53,18 +54,20 @@ export function useTourScrollView(options = {}) {
   }, [scrollViewRef]);
   const scrollViewProps = useMemo(() => {
     const props = {
-      ref: scrollViewRef
+      ref: scrollViewRef,
+      onMomentumScrollEnd: triggerScrollEnd
     };
     if (disableScrollDuringTour) {
       props.scrollEnabled = scrollEnabled;
     }
     return props;
-  }, [scrollViewRef, disableScrollDuringTour, scrollEnabled]);
+  }, [scrollViewRef, triggerScrollEnd, disableScrollDuringTour, scrollEnabled]);
   return {
     scrollViewRef,
     isTourActive,
     scrollEnabled,
     scrollTo,
+    onMomentumScrollEnd: triggerScrollEnd,
     scrollViewProps
   };
 }

package/lib/module/hooks/useTourScrollView.js.map

@@ -1 +1 @@
-{"version":3,"names":["useCallback","useMemo","useTour","useTourScrollView","options","disableScrollDuringTour","tour","scrollViewRef","currentStep","isTourActive","scrollEnabled","scrollTo","opts","current","x","y","animated","scrollViewProps","props","ref"],"sourceRoot":"..\\..\\..\\src","sources":["hooks/useTourScrollView.ts"],"mappings":";;AAAA,SAASA,WAAW,EAAEC,OAAO,QAAQ,OAAO;AAC5C,SAASC,OAAO,QAAQ,cAAW;AAwCnC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,iBAAiBA,CAC/BC,OAA8B,GAAG,CAAC,CAAC,EACb;EACtB,MAAM;IAAEC,uBAAuB,GAAG;EAAM,CAAC,GAAGD,OAAO;;EAEnD;EACA,MAAME,IAAI,GAAGJ,OAAO,CAAC,CAAC;EACtB,MAAM;IAAEK,aAAa;IAAEC;EAAY,CAAC,GAAGF,IAAW;EAElD,MAAMG,YAAY,GAAGD,WAAW,KAAK,IAAI;EACzC,MAAME,aAAa,GAAGL,uBAAuB,GAAG,CAACI,YAAY,GAAG,IAAI;EAEpE,MAAME,QAAQ,GAAGX,WAAW,CACzBY,IAAoD,IAAK;IACxD,IAAI;MACF,IAAIL,aAAa,EAAEM,OAAO,EAAEF,QAAQ,EAAE;QACpCJ,aAAa,CAACM,OAAO,CAACF,QAAQ,CAAC;UAC7BG,CAAC,EAAEF,IAAI,CAACE,CAAC,IAAI,CAAC;UACdC,CAAC,EAAEH,IAAI,CAACG,CAAC,IAAI,CAAC;UACdC,QAAQ,EAAEJ,IAAI,CAACI,QAAQ,KAAK;QAC9B,CAAC,CAAC;MACJ;IACF,CAAC,CAAC,MAAM;MACN;IAAA;EAEJ,CAAC,EACD,CAACT,aAAa,CAChB,CAAC;EAED,MAAMU,eAAe,GAAGhB,OAAO,CAAC,MAAM;IACpC,MAAMiB,KAA6D,GAAG;MACpEC,GAAG,EAAEZ;IACP,CAAC;IACD,IAAIF,uBAAuB,EAAE;MAC3Ba,KAAK,CAACR,aAAa,GAAGA,aAAa;IACrC;IACA,OAAOQ,KAAK;EACd,CAAC,EAAE,CAACX,aAAa,EAAEF,uBAAuB,EAAEK,aAAa,CAAC,CAAC;EAE3D,OAAO;IACLH,aAAa;IACbE,YAAY;IACZC,aAAa;IACbC,QAAQ;IACRM;EACF,CAAC;AACH","ignoreList":[]}
+{"version":3,"names":["useCallback","useMemo","useTour","useTourScrollView","options","disableScrollDuringTour","tour","scrollViewRef","currentStep","triggerScrollEnd","isTourActive","scrollEnabled","scrollTo","opts","current","x","y","animated","scrollViewProps","props","ref","onMomentumScrollEnd"],"sourceRoot":"..\\..\\..\\src","sources":["hooks/useTourScrollView.ts"],"mappings":";;AAAA,SAASA,WAAW,EAAEC,OAAO,QAAQ,OAAO;AAC5C,SAASC,OAAO,QAAQ,cAAW;AAmDnC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,iBAAiBA,CAC/BC,OAA8B,GAAG,CAAC,CAAC,EACb;EACtB,MAAM;IAAEC,uBAAuB,GAAG;EAAM,CAAC,GAAGD,OAAO;;EAEnD;EACA,MAAME,IAAI,GAAGJ,OAAO,CAAC,CAAC;EACtB,MAAM;IAAEK,aAAa;IAAEC,WAAW;IAAEC;EAAiB,CAAC,GAAGH,IAAW;EAEpE,MAAMI,YAAY,GAAGF,WAAW,KAAK,IAAI;EACzC,MAAMG,aAAa,GAAGN,uBAAuB,GAAG,CAACK,YAAY,GAAG,IAAI;EAEpE,MAAME,QAAQ,GAAGZ,WAAW,CACzBa,IAAoD,IAAK;IACxD,IAAI;MACF,IAAIN,aAAa,EAAEO,OAAO,EAAEF,QAAQ,EAAE;QACpCL,aAAa,CAACO,OAAO,CAACF,QAAQ,CAAC;UAC7BG,CAAC,EAAEF,IAAI,CAACE,CAAC,IAAI,CAAC;UACdC,CAAC,EAAEH,IAAI,CAACG,CAAC,IAAI,CAAC;UACdC,QAAQ,EAAEJ,IAAI,CAACI,QAAQ,KAAK;QAC9B,CAAC,CAAC;MACJ;IACF,CAAC,CAAC,MAAM;MACN;IAAA;EAEJ,CAAC,EACD,CAACV,aAAa,CAChB,CAAC;EAED,MAAMW,eAAe,GAAGjB,OAAO,CAAC,MAAM;IACpC,MAAMkB,KAIL,GAAG;MACFC,GAAG,EAAEb,aAAa;MAClBc,mBAAmB,EAAEZ;IACvB,CAAC;IACD,IAAIJ,uBAAuB,EAAE;MAC3Bc,KAAK,CAACR,aAAa,GAAGA,aAAa;IACrC;IACA,OAAOQ,KAAK;EACd,CAAC,EAAE,CAACZ,aAAa,EAAEE,gBAAgB,EAAEJ,uBAAuB,EAAEM,aAAa,CAAC,CAAC;EAE7E,OAAO;IACLJ,aAAa;IACbG,YAAY;IACZC,aAAa;IACbC,QAAQ;IACRS,mBAAmB,EAAEZ,gBAAgB;IACrCS;EACF,CAAC;AACH","ignoreList":[]}

package/lib/module/utils/storage.js

@@ -1,8 +1,8 @@
 "use strict";
 
-/**
- * Storage adapter for tour persistence.
- * Auto-detects available storage (MMKV v4 or AsyncStorage) and provides a unified interface.
+/**
+ * Storage adapter for tour persistence.
+ * Auto-detects available storage (MMKV v4 or AsyncStorage) and provides a unified interface.
  */
 
 // ─── Types ───────────────────────────────────────────────────────────────────
@@ -12,9 +12,9 @@
 let cachedStorageType = null;
 let cachedAdapter = null;
 
-/**
- * Attempts to detect and return the MMKV v4 default instance.
- * Returns null if MMKV is not available.
+/**
+ * Attempts to detect and return the MMKV v4 default instance.
+ * Returns null if MMKV is not available.
  */
 function tryGetMMKV() {
   try {
@@ -43,9 +43,9 @@ function tryGetMMKV() {
   }
 }
 
-/**
- * Attempts to detect and return AsyncStorage.
- * Returns null if AsyncStorage is not available.
+/**
+ * Attempts to detect and return AsyncStorage.
+ * Returns null if AsyncStorage is not available.
  */
 function tryGetAsyncStorage() {
   try {
@@ -66,9 +66,9 @@ function tryGetAsyncStorage() {
   }
 }
 
-/**
- * Detects the available storage type and returns an adapter.
- * Priority: MMKV v4 > AsyncStorage > none
+/**
+ * Detects the available storage type and returns an adapter.
+ * Priority: MMKV v4 > AsyncStorage > none
  */
 export function detectStorage() {
   // Return cached result if available
@@ -110,9 +110,9 @@ export function detectStorage() {
   };
 }
 
-/**
- * Clears the cached storage detection result.
- * Useful for testing or when storage availability changes.
+/**
+ * Clears the cached storage detection result.
+ * Useful for testing or when storage availability changes.
  */
 export function clearStorageCache() {
   cachedStorageType = null;
@@ -123,8 +123,8 @@ export function clearStorageCache() {
 
 const STORAGE_KEY_PREFIX = '@lumen_tour_';
 
-/**
- * Generates a storage key for a specific tour.
+/**
+ * Generates a storage key for a specific tour.
  */
 export function getTourStorageKey(tourId) {
   return `${STORAGE_KEY_PREFIX}${tourId}`;
@@ -132,8 +132,8 @@ export function getTourStorageKey(tourId) {
 
 // ─── Storage Operations ──────────────────────────────────────────────────────
 
-/**
- * Saves the current tour progress to storage.
+/**
+ * Saves the current tour progress to storage.
  */
 export async function saveTourProgress(adapter, tourId, currentStepKey, stepIndex) {
   const state = {
@@ -147,9 +147,9 @@ export async function saveTourProgress(adapter, tourId, currentStepKey, stepInde
   await adapter.setItem(key, value);
 }
 
-/**
- * Loads the saved tour progress from storage.
- * Returns null if no progress is saved or if the data is invalid.
+/**
+ * Loads the saved tour progress from storage.
+ * Returns null if no progress is saved or if the data is invalid.
  */
 export async function loadTourProgress(adapter, tourId) {
   try {
@@ -170,16 +170,16 @@ export async function loadTourProgress(adapter, tourId) {
   }
 }
 
-/**
- * Clears the saved tour progress from storage.
+/**
+ * Clears the saved tour progress from storage.
  */
 export async function clearTourProgress(adapter, tourId) {
   const key = getTourStorageKey(tourId);
   await adapter.removeItem(key);
 }
 
-/**
- * Checks if there is saved progress for a tour.
+/**
+ * Checks if there is saved progress for a tour.
  */
 export async function hasTourProgress(adapter, tourId) {
   const progress = await loadTourProgress(adapter, tourId);

package/lib/typescript/src/components/TourOverlay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TourOverlay.d.ts","sourceRoot":"","sources":["../../../../src/components/TourOverlay.tsx"],"names":[],"mappings":"AA4CA,eAAO,MAAM,WAAW,oFAuJtB,CAAC"}
+{"version":3,"file":"TourOverlay.d.ts","sourceRoot":"","sources":["../../../../src/components/TourOverlay.tsx"],"names":[],"mappings":"AAwCA,eAAO,MAAM,WAAW,oFAmHtB,CAAC"}

package/lib/typescript/src/components/TourProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TourProvider.d.ts","sourceRoot":"","sources":["../../../../src/components/TourProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAON,MAAM,OAAO,CAAC;AAUf,OAAO,KAAK,EAGV,UAAU,EAIV,UAAU,EACX,MAAM,UAAU,CAAC;AA6FlB,UAAU,iBAAiB;IACzB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAID,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAwiBpD,CAAC"}
+{"version":3,"file":"TourProvider.d.ts","sourceRoot":"","sources":["../../../../src/components/TourProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAON,MAAM,OAAO,CAAC;AAUf,OAAO,KAAK,EAGV,UAAU,EAIV,UAAU,EACX,MAAM,UAAU,CAAC;AA6FlB,UAAU,iBAAiB;IACzB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAID,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAqjBpD,CAAC"}

package/lib/typescript/src/components/TourZone.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TourZone.d.ts","sourceRoot":"","sources":["../../../../src/components/TourZone.tsx"],"names":[],"mappings":"AAAA,OAAO,KAKN,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAYzD,OAAO,KAAK,EAEV,SAAS,EACT,SAAS,EACT,SAAS,EACV,MAAM,UAAU,CAAC;AAMlB,UAAU,aAAa;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,KAAK,CAAC,SAAS,CAAC;CAC1D;AAED,eAAO,MAAM,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,aAAa,CA0Z5C,CAAC"}
+{"version":3,"file":"TourZone.d.ts","sourceRoot":"","sources":["../../../../src/components/TourZone.tsx"],"names":[],"mappings":"AAAA,OAAO,KAMN,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAazD,OAAO,KAAK,EAEV,SAAS,EACT,SAAS,EACT,SAAS,EACV,MAAM,UAAU,CAAC;AAMlB,UAAU,aAAa;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,KAAK,CAAC,SAAS,CAAC;CAC1D;AAED,eAAO,MAAM,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,aAAa,CAuc5C,CAAC"}

package/lib/typescript/src/hooks/useTourScrollView.d.ts

@@ -29,12 +29,23 @@ export interface TourScrollViewResult {
         y?: number;
         animated?: boolean;
     }) => void;
+    /**
+     * Pass this to your ScrollView's onMomentumScrollEnd prop so the tour
+     * library knows exactly when a programmatic scroll has finished, allowing
+     * it to immediately re-measure the highlighted element instead of waiting
+     * for a fixed-duration timeout.
+     *
+     * Already included in scrollViewProps — only needed if you build your own
+     * scroll props manually.
+     */
+    onMomentumScrollEnd: () => void;
     /**
      * Props to spread onto your ScrollView for full tour integration.
-     * Includes ref and scrollEnabled (if disableScrollDuringTour is true).
+     * Includes ref, onMomentumScrollEnd, and scrollEnabled (if disableScrollDuringTour is true).
      */
     scrollViewProps: {
         ref: React.RefObject<any>;
+        onMomentumScrollEnd: () => void;
         scrollEnabled?: boolean;
     };
 }

package/lib/typescript/src/hooks/useTourScrollView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useTourScrollView.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useTourScrollView.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,aAAa,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACpC;;OAEG;IACH,YAAY,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,aAAa,EAAE,OAAO,CAAC;IACvB;;;OAGG;IACH,QAAQ,EAAE,CAAC,OAAO,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAC5E;;;OAGG;IACH,eAAe,EAAE;QACf,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,GAAE,qBAA0B,GAClC,oBAAoB,CA4CtB"}
+{"version":3,"file":"useTourScrollView.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useTourScrollView.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,aAAa,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACpC;;OAEG;IACH,YAAY,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,aAAa,EAAE,OAAO,CAAC;IACvB;;;OAGG;IACH,QAAQ,EAAE,CAAC,OAAO,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAC5E;;;;;;;;OAQG;IACH,mBAAmB,EAAE,MAAM,IAAI,CAAC;IAChC;;;OAGG;IACH,eAAe,EAAE;QACf,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAC1B,mBAAmB,EAAE,MAAM,IAAI,CAAC;QAChC,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,GAAE,qBAA0B,GAClC,oBAAoB,CAkDtB"}

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

@@ -411,6 +411,12 @@ export interface TourContextType {
      * Includes all steps across all screens (for multi-screen tours).
      */
     orderedStepKeys: string[];
+    /**
+     * Call this from the ScrollView's onMomentumScrollEnd event to signal that
+     * a programmatic scroll has finished. The library uses this to fire the
+     * final accurate measurement instead of relying on a fixed-duration timeout.
+     */
+    triggerScrollEnd: () => void;
 }
 export interface InternalTourContextType extends TourContextType {
     targetX: SharedValue<number>;
@@ -426,5 +432,19 @@ export interface InternalTourContextType extends TourContextType {
     setScrollViewRef: (ref: any) => void;
     /** Resolved zone style for the current step */
     currentZoneStyle: ZoneStyle | null;
+    /**
+     * Registers a one-shot callback that fires once when triggerScrollEnd is called.
+     * TourZone uses this to know when the programmatic scroll animation has settled.
+     */
+    registerScrollEndCallback: (cb: () => void) => void;
+    /** Clears any pending scroll-end callback (called on effect cleanup). */
+    unregisterScrollEndCallback: () => void;
+    /** Fires the registered scroll-end callback (if any) and clears it. */
+    triggerScrollEnd: () => void;
+    /**
+     * The configured backdrop opacity (0–1). TourZone reads this so it can
+     * fade the overlay back to the correct level after a scroll-induced fade-out.
+     */
+    backdropOpacity: number;
 }
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-lumen",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "A customizable app tour library for React Native",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
@@ -13,11 +13,7 @@
     "./package.json": "./package.json"
   },
   "files": [
-    "src",
     "lib",
-    "android",
-    "ios",
-    "cpp",
     "*.podspec",
     "react-native.config.js",
     "!ios/build",
@@ -54,7 +50,7 @@
   "bugs": {
     "url": "https://github.com/thedev204/react-native-lumen/issues"
   },
-  "homepage": "https://github.com/thedev204/react-native-lumen#readme",
+  "homepage": "https://thedev204.github.io/react-native-lumen/",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"
   },

package/src/components/TourOverlay.tsx

@@ -1,196 +0,0 @@
-import { memo, type ComponentType, useMemo } from 'react';
-import { StyleSheet, Dimensions } from 'react-native';
-import Svg, { Path } from 'react-native-svg';
-import Animated, {
-  useAnimatedProps,
-  useAnimatedStyle,
-} from 'react-native-reanimated';
-import { useTour } from '../hooks/useTour';
-import type { InternalTourContextType } from '../types';
-import { DEFAULT_ZONE_STYLE } from '../constants/defaults';
-
-const { width: SCREEN_WIDTH, height: SCREEN_HEIGHT } = Dimensions.get('window');
-
-const AnimatedPath = Animated.createAnimatedComponent(Path);
-const AnimatedView = Animated.View as unknown as ComponentType<any>;
-
-// Helper to create rounded rect path
-// x,y are top-left coordinates
-const createRoundedRectPath = (
-  x: number,
-  y: number,
-  w: number,
-  h: number,
-  r: number
-) => {
-  'worklet';
-  // Ensure radius doesn't exceed dimensions
-  const radius = Math.min(r, w / 2, h / 2);
-
-  // Standard SVG Path command for rounded rect
-  return `
-    M ${x + radius}, ${y}
-    H ${x + w - radius}
-    A ${radius} ${radius} 0 0 1 ${x + w}, ${y + radius}
-    V ${y + h - radius}
-    A ${radius} ${radius} 0 0 1 ${x + w - radius}, ${y + h}
-    H ${x + radius}
-    A ${radius} ${radius} 0 0 1 ${x}, ${y + h - radius}
-    V ${y + radius}
-    A ${radius} ${radius} 0 0 1 ${x + radius}, ${y}
-    Z
-  `;
-};
-
-export const TourOverlay = memo(() => {
-  const {
-    targetX,
-    targetY,
-    targetWidth,
-    targetHeight,
-    targetRadius,
-    opacity,
-    zoneBorderWidth,
-    config,
-    currentStep,
-    steps,
-    currentZoneStyle,
-  } = useTour() as InternalTourContextType;
-
-  // Get resolved zone style for styling the glow/border
-  const zoneStyle = useMemo(() => {
-    return {
-      ...DEFAULT_ZONE_STYLE,
-      ...config?.zoneStyle,
-      ...currentZoneStyle,
-    };
-  }, [config?.zoneStyle, currentZoneStyle]);
-
-  // Create the d string for the mask
-  // Outer rectangle covers the whole screen
-  // Inner shape is the "hole"
-  // fillRule="evenodd" makes the intersection transparent
-  const animatedProps = useAnimatedProps(() => {
-    const holePath = createRoundedRectPath(
-      targetX.value,
-      targetY.value,
-      targetWidth.value,
-      targetHeight.value,
-      targetRadius.value
-    );
-
-    const path = `
-      M 0,0 
-      H ${SCREEN_WIDTH} 
-      V ${SCREEN_HEIGHT} 
-      H 0 
-      Z 
-      ${holePath}
-    `;
-
-    return {
-      d: path,
-      fillOpacity: opacity.value,
-    };
-  });
-
-  const step = currentStep ? steps[currentStep] : null;
-  const isClickable = step?.clickable ?? false;
-
-  // Interaction Logic:
-  // 1. preventInteraction = true:
-  //    - Wrapper pointerEvents = 'box-none' (pass through) BUT SVG is auto?
-  //    - Actually, if we want to block OUTSIDE but allow INSIDE:
-  //      - SVG path normally blocks where it draws (the dark part).
-  //      - The 'hole' is empty, so touches pass through the hole to the app?
-  //      - YES, with fillRule="evenodd", the hole effectively has no fill.
-  //      - So if SVG is 'auto', touching the dark mask is blocked (if we consume touch).
-  //      - Touching the hole goes through to the app (GOOD for clickable).
-  //    - IF we want to BLOCK the hole (clickable=false):
-  //      - We need a transparent view covering the hole that consumes touches.
-  //
-  // 2. preventInteraction = false (default):
-  //    - Overlay shouldn't block anything?
-  //    - pointerEvents='none' on the whole container.
-
-  // Check per-step preventInteraction first, then fall back to global config
-  const shouldBlockOutside =
-    step?.preventInteraction ?? config?.preventInteraction ?? false;
-
-  // If we don't want to block outside, we just let everything pass.
-  // But wait, if we let everything pass, we can't implement 'clickable=false' strictness?
-  // Usually preventInteraction=false means "just show the highlighter, let user do whatever".
-
-  const containerPointerEvents =
-    shouldBlockOutside && currentStep ? 'box-none' : 'none';
-
-  // If blocking outside, the SVG (which is absolute fill) needs to catch touches on the dark part.
-
-  // Blocker style for the hole (only if NOT clickable)
-  const blockerStyle = useAnimatedStyle(() => {
-    return {
-      position: 'absolute',
-      left: targetX.value,
-      top: targetY.value,
-      width: targetWidth.value,
-      height: targetHeight.value,
-      // We can match radius too if needed, but rect is fine for touch area usually
-      borderRadius: targetRadius.value,
-    };
-  });
-
-  // Animated style for the zone border/glow ring
-  const zoneBorderStyle = useAnimatedStyle(() => {
-    const isGlowEnabled = config?.enableGlow === true;
-    const borderW = zoneBorderWidth?.value ?? zoneStyle.borderWidth;
-
-    return {
-      position: 'absolute' as const,
-      left: targetX.value,
-      top: targetY.value,
-      width: targetWidth.value,
-      height: targetHeight.value,
-      borderRadius: targetRadius.value,
-      borderWidth: borderW,
-      borderColor: zoneStyle.borderColor,
-      backgroundColor: 'transparent',
-      ...(isGlowEnabled && {
-        // Glow effect using React Native 0.76+ boxShadow API
-        boxShadow: `${zoneStyle.glowOffsetX}px ${zoneStyle.glowOffsetY}px ${zoneStyle.glowRadius}px ${zoneStyle.glowSpread}px ${zoneStyle.glowColor}`,
-      }),
-    };
-  });
-
-  // Determine if we should show the border/glow
-  const showBorder = config?.enableGlow === true || zoneStyle.borderWidth > 0;
-
-  return (
-    <AnimatedView
-      pointerEvents={containerPointerEvents}
-      style={StyleSheet.absoluteFill}
-    >
-      <Svg height="100%" width="100%" style={StyleSheet.absoluteFill}>
-        <AnimatedPath
-          animatedProps={animatedProps as any}
-          fill="black" // The backdrop color
-          fillRule="evenodd"
-          onPress={() => {
-            // Consume touch on the backdrop?
-          }}
-        />
-      </Svg>
-      {/* If strictly blocking interaction AND current step is NOT clickable, we cover the hole */}
-      {shouldBlockOutside && !isClickable && currentStep && (
-        <AnimatedView
-          style={blockerStyle}
-          pointerEvents="auto" // Catch touches
-          // backgroundColor="transparent" // Default
-        />
-      )}
-      {/* Border/Glow ring around the zone */}
-      {showBorder && currentStep && (
-        <AnimatedView style={zoneBorderStyle} pointerEvents="none" />
-      )}
-    </AnimatedView>
-  );
-});