react-native-lumen 1.0.0 → 1.1.0

package/lib/module/utils/storage.js

@@ -0,0 +1,188 @@
+"use strict";
+
+/**
+ * Storage adapter for tour persistence.
+ * Auto-detects available storage (MMKV v4 or AsyncStorage) and provides a unified interface.
+ */
+
+// ─── Types ───────────────────────────────────────────────────────────────────
+
+// ─── Storage Detection ───────────────────────────────────────────────────────
+
+let cachedStorageType = null;
+let cachedAdapter = null;
+
+/**
+ * Attempts to detect and return the MMKV v4 default instance.
+ * Returns null if MMKV is not available.
+ */
+function tryGetMMKV() {
+  try {
+    // Try to require react-native-mmkv (v4 uses different API)
+
+    const mmkvModule = require('react-native-mmkv');
+
+    // MMKV v4 exports createMMKV function
+    if (mmkvModule?.createMMKV) {
+      const createMMKV = mmkvModule.createMMKV;
+      // Create a dedicated instance for tour storage
+      const storage = createMMKV({
+        id: 'react-native-lumen-tour'
+      });
+      if (typeof storage.getString === 'function' && typeof storage.set === 'function' && typeof storage.remove === 'function') {
+        return {
+          getItem: key => storage.getString(key) ?? null,
+          setItem: (key, value) => storage.set(key, value),
+          removeItem: key => storage.remove(key)
+        };
+      }
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Attempts to detect and return AsyncStorage.
+ * Returns null if AsyncStorage is not available.
+ */
+function tryGetAsyncStorage() {
+  try {
+    // Try to require @react-native-async-storage/async-storage
+
+    const asyncStorageModule = require('@react-native-async-storage/async-storage');
+    const AsyncStorage = asyncStorageModule?.default || asyncStorageModule;
+    if (AsyncStorage && typeof AsyncStorage.getItem === 'function' && typeof AsyncStorage.setItem === 'function' && typeof AsyncStorage.removeItem === 'function') {
+      return {
+        getItem: key => AsyncStorage.getItem(key),
+        setItem: (key, value) => AsyncStorage.setItem(key, value),
+        removeItem: key => AsyncStorage.removeItem(key)
+      };
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Detects the available storage type and returns an adapter.
+ * Priority: MMKV v4 > AsyncStorage > none
+ */
+export function detectStorage() {
+  // Return cached result if available
+  if (cachedStorageType !== null) {
+    return {
+      type: cachedStorageType,
+      adapter: cachedAdapter
+    };
+  }
+
+  // Try MMKV first (fastest)
+  const mmkvAdapter = tryGetMMKV();
+  if (mmkvAdapter) {
+    cachedStorageType = 'mmkv';
+    cachedAdapter = mmkvAdapter;
+    return {
+      type: 'mmkv',
+      adapter: mmkvAdapter
+    };
+  }
+
+  // Try AsyncStorage
+  const asyncStorageAdapter = tryGetAsyncStorage();
+  if (asyncStorageAdapter) {
+    cachedStorageType = 'async-storage';
+    cachedAdapter = asyncStorageAdapter;
+    return {
+      type: 'async-storage',
+      adapter: asyncStorageAdapter
+    };
+  }
+
+  // No storage available
+  cachedStorageType = 'none';
+  cachedAdapter = null;
+  return {
+    type: 'none',
+    adapter: null
+  };
+}
+
+/**
+ * Clears the cached storage detection result.
+ * Useful for testing or when storage availability changes.
+ */
+export function clearStorageCache() {
+  cachedStorageType = null;
+  cachedAdapter = null;
+}
+
+// ─── Storage Key Generation ──────────────────────────────────────────────────
+
+const STORAGE_KEY_PREFIX = '@lumen_tour_';
+
+/**
+ * Generates a storage key for a specific tour.
+ */
+export function getTourStorageKey(tourId) {
+  return `${STORAGE_KEY_PREFIX}${tourId}`;
+}
+
+// ─── Storage Operations ──────────────────────────────────────────────────────
+
+/**
+ * Saves the current tour progress to storage.
+ */
+export async function saveTourProgress(adapter, tourId, currentStepKey, stepIndex) {
+  const state = {
+    tourId,
+    currentStepKey,
+    stepIndex,
+    timestamp: Date.now()
+  };
+  const key = getTourStorageKey(tourId);
+  const value = JSON.stringify(state);
+  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.
+ */
+export async function loadTourProgress(adapter, tourId) {
+  try {
+    const key = getTourStorageKey(tourId);
+    const value = await adapter.getItem(key);
+    if (!value) {
+      return null;
+    }
+    const state = JSON.parse(value);
+
+    // Validate the loaded state
+    if (state.tourId !== tourId || typeof state.currentStepKey !== 'string' || typeof state.stepIndex !== 'number') {
+      return null;
+    }
+    return state;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * 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.
+ */
+export async function hasTourProgress(adapter, tourId) {
+  const progress = await loadTourProgress(adapter, tourId);
+  return progress !== null;
+}
+//# sourceMappingURL=storage.js.map

package/lib/module/utils/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["cachedStorageType","cachedAdapter","tryGetMMKV","mmkvModule","require","createMMKV","storage","id","getString","set","remove","getItem","key","setItem","value","removeItem","tryGetAsyncStorage","asyncStorageModule","AsyncStorage","default","detectStorage","type","adapter","mmkvAdapter","asyncStorageAdapter","clearStorageCache","STORAGE_KEY_PREFIX","getTourStorageKey","tourId","saveTourProgress","currentStepKey","stepIndex","state","timestamp","Date","now","JSON","stringify","loadTourProgress","parse","clearTourProgress","hasTourProgress","progress"],"sourceRoot":"..\\..\\..\\src","sources":["utils/storage.ts"],"mappings":"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","ignoreList":[]}

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":"AA2CA,eAAO,MAAM,WAAW,oFA6GtB,CAAC"}
+{"version":3,"file":"TourOverlay.d.ts","sourceRoot":"","sources":["../../../../src/components/TourOverlay.tsx"],"names":[],"mappings":"AA4CA,eAAO,MAAM,WAAW,oFAuJtB,CAAC"}

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

@@ -1,12 +1,29 @@
 import React from 'react';
-import type { TourConfig, InternalTourContextType } from '../types';
-export declare const TourContext: React.Context<InternalTourContextType | null>;
+import type { TourConfig, StepsOrder } from '../types';
 interface TourProviderProps {
     children: React.ReactNode;
     /**
-     * Optional custom steps order. If provided, the tour will follow this array of keys.
+     * Optional custom steps order. Supports two formats:
+     *
+     * **Flat array** (single-screen or simple multi-screen):
+     * ```
+     * stepsOrder={['bio', 'prompt', 'poll', 'filters', 'swipeableCards']}
+     * ```
+     *
+     * **Screen-grouped object** (multi-screen tours):
+     * ```
+     * stepsOrder={{
+     *   ProfileSelf: ['bio', 'prompt', 'poll'],
+     *   HomeSwipe: ['filters'],
+     *   SwipeableCards: ['swipeableCards'],
+     * }}
+     * ```
+     *
+     * When using the object format, steps are flattened in the order the screens appear.
+     * The tour automatically waits when advancing to a step on an unmounted screen,
+     * and resumes when that step's TourZone mounts.
      */
-    stepsOrder?: string[];
+    stepsOrder?: StepsOrder;
     /**
      * Initial overlay opacity. Default 0.5
      */

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;AASf,OAAO,KAAK,EAGV,UAAU,EACV,uBAAuB,EACxB,MAAM,UAAU,CAAC;AAQlB,eAAO,MAAM,WAAW,+CAAsD,CAAC;AAE/E,UAAU,iBAAiB;IACzB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;;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,CAiTpD,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,CAwiBpD,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"TourTooltip.d.ts","sourceRoot":"","sources":["../../../../src/components/TourTooltip.tsx"],"names":[],"mappings":"AAoBA,eAAO,MAAM,WAAW,2FAyKtB,CAAC"}
+{"version":3,"file":"TourTooltip.d.ts","sourceRoot":"","sources":["../../../../src/components/TourTooltip.tsx"],"names":[],"mappings":"AAmFA,eAAO,MAAM,WAAW,2FA2MtB,CAAC"}

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

@@ -1,15 +1,33 @@
 import React from 'react';
 import type { ViewStyle, StyleProp } from 'react-native';
+import type { ZoneStyle, ZoneShape, CardProps } from '../types';
 interface TourZoneProps {
     stepKey: string;
     name?: string;
     description: string;
     order?: number;
-    shape?: 'rect' | 'circle';
+    shape?: ZoneShape;
     borderRadius?: number;
     children: React.ReactNode;
     style?: StyleProp<ViewStyle>;
     clickable?: boolean;
+    preventInteraction?: boolean;
+    required?: boolean;
+    completed?: boolean;
+    zonePadding?: number;
+    zonePaddingTop?: number;
+    zonePaddingRight?: number;
+    zonePaddingBottom?: number;
+    zonePaddingLeft?: number;
+    zoneBorderWidth?: number;
+    zoneBorderColor?: string;
+    zoneGlowColor?: string;
+    zoneGlowRadius?: number;
+    zoneGlowSpread?: number;
+    zoneGlowOffsetX?: number;
+    zoneGlowOffsetY?: number;
+    zoneStyle?: ZoneStyle;
+    renderCustomCard?: (props: CardProps) => React.ReactNode;
 }
 export declare const TourZone: React.FC<TourZoneProps>;
 export {};

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;AAkBzD,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,MAAM,GAAG,QAAQ,CAAC;IAC1B,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;CACrB;AAED,eAAO,MAAM,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,aAAa,CA+U5C,CAAC"}
+{"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"}

package/lib/typescript/src/constants/defaults.d.ts

@@ -1,4 +1,5 @@
 import type { WithSpringConfig } from 'react-native-reanimated';
+import type { ZoneStyle } from '../types';
 export declare const DEFAULT_SPRING_CONFIG: WithSpringConfig;
 export declare const DEFAULT_BACKDROP_OPACITY = 0.5;
 export declare const DEFAULT_LABELS: {
@@ -7,4 +8,13 @@ export declare const DEFAULT_LABELS: {
     finish: string;
     skip: string;
 };
+/**
+ * Default zone style configuration.
+ * These values are used when no custom style is provided.
+ */
+export declare const DEFAULT_ZONE_STYLE: Required<ZoneStyle>;
+/**
+ * Merges global and per-step zone styles with defaults.
+ */
+export declare function resolveZoneStyle(globalStyle?: ZoneStyle, stepStyle?: ZoneStyle): Required<ZoneStyle>;
 //# sourceMappingURL=defaults.d.ts.map

package/lib/typescript/src/constants/defaults.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../../../src/constants/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,eAAO,MAAM,qBAAqB,EAAE,gBAGnC,CAAC;AAEF,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAE5C,eAAO,MAAM,cAAc;;;;;CAK1B,CAAC"}
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../../../src/constants/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,eAAO,MAAM,qBAAqB,EAAE,gBAGnC,CAAC;AAEF,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAE5C,eAAO,MAAM,cAAc;;;;;CAK1B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,SAAS,CAiBlD,CAAC;AAEF;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,CAAC,EAAE,SAAS,EACvB,SAAS,CAAC,EAAE,SAAS,GACpB,QAAQ,CAAC,SAAS,CAAC,CAmBrB"}

package/lib/typescript/src/context/TourContext.d.ts

@@ -0,0 +1,3 @@
+import type { InternalTourContextType } from '../types';
+export declare const TourContext: import("react").Context<InternalTourContextType | null>;
+//# sourceMappingURL=TourContext.d.ts.map

package/lib/typescript/src/context/TourContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TourContext.d.ts","sourceRoot":"","sources":["../../../../src/context/TourContext.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAExD,eAAO,MAAM,WAAW,yDAAsD,CAAC"}

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

@@ -0,0 +1,65 @@
+export interface TourScrollViewOptions {
+    /**
+     * If true, scrolling will be disabled while the tour is active.
+     * @default false
+     */
+    disableScrollDuringTour?: boolean;
+}
+export interface TourScrollViewResult {
+    /**
+     * Animated ref to attach to your ScrollView/Animated.ScrollView.
+     * This is the same ref as `scrollViewRef` from useTour().
+     */
+    scrollViewRef: React.RefObject<any>;
+    /**
+     * Whether the tour is currently active (a step is being shown).
+     */
+    isTourActive: boolean;
+    /**
+     * Whether scrolling should be enabled based on tour state.
+     * Only relevant if disableScrollDuringTour option is true.
+     */
+    scrollEnabled: boolean;
+    /**
+     * Helper function to scroll to a specific position.
+     * Wraps the scrollTo method with error handling.
+     */
+    scrollTo: (options: {
+        x?: number;
+        y?: number;
+        animated?: boolean;
+    }) => void;
+    /**
+     * Props to spread onto your ScrollView for full tour integration.
+     * Includes ref and scrollEnabled (if disableScrollDuringTour is true).
+     */
+    scrollViewProps: {
+        ref: React.RefObject<any>;
+        scrollEnabled?: boolean;
+    };
+}
+/**
+ * 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 declare function useTourScrollView(options?: TourScrollViewOptions): TourScrollViewResult;
+//# sourceMappingURL=useTourScrollView.d.ts.map

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

@@ -0,0 +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"}

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

@@ -2,8 +2,12 @@ export * from './types';
 export * from './components/TourProvider';
 export * from './components/TourZone';
 export * from './hooks/useTour';
+export { useTourScrollView } from './hooks/useTourScrollView';
+export type { TourScrollViewOptions, TourScrollViewResult, } from './hooks/useTourScrollView';
 export { TourOverlay } from './components/TourOverlay';
 export { TourTooltip } from './components/TourTooltip';
 export * from './constants/defaults';
 export * from './constants/animations';
+export { detectStorage, clearStorageCache, type StorageType, } from './utils/storage';
+export type { ZoneStyle, ZoneShape, TourStep, CardProps, TourConfig, TourLabels, TooltipStyles, TourPersistenceConfig, TourContextType, StorageAdapter, StepsOrder, } from './types';
 //# 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,cAAc,SAAS,CAAC;AACxB,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,YAAY,EACV,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AAGvC,OAAO,EACL,aAAa,EACb,iBAAiB,EACjB,KAAK,WAAW,GACjB,MAAM,iBAAiB,CAAC;AAGzB,YAAY,EACV,SAAS,EACT,SAAS,EACT,QAAQ,EACR,SAAS,EACT,UAAU,EACV,UAAU,EACV,aAAa,EACb,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,UAAU,GACX,MAAM,SAAS,CAAC"}