react-native-lumen 1.0.1 → 1.1.1

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

@@ -1,5 +1,94 @@
 import type { WithSpringConfig, SharedValue } from 'react-native-reanimated';
 import React from 'react';
+import type { ViewStyle, TextStyle } from 'react-native';
+/**
+ * Shape variants for the zone cutout.
+ */
+export type ZoneShape = 'rounded-rect' | 'circle' | 'pill';
+/**
+ * Customization options for the zone appearance.
+ * Can be set globally via TourConfig or per-step via TourStep/TourZone.
+ */
+export interface ZoneStyle {
+    /**
+     * Uniform padding around the highlighted element.
+     * @default 0
+     */
+    padding?: number;
+    /**
+     * Top padding (overrides `padding` for top side).
+     */
+    paddingTop?: number;
+    /**
+     * Right padding (overrides `padding` for right side).
+     */
+    paddingRight?: number;
+    /**
+     * Bottom padding (overrides `padding` for bottom side).
+     */
+    paddingBottom?: number;
+    /**
+     * Left padding (overrides `padding` for left side).
+     */
+    paddingLeft?: number;
+    /**
+     * Border radius of the zone (for 'rounded-rect' shape).
+     * @default 10
+     */
+    borderRadius?: number;
+    /**
+     * Shape of the zone cutout.
+     * - 'rounded-rect': Standard rounded rectangle (default)
+     * - 'circle': Circular zone that encompasses the element
+     * - 'pill': Pill/capsule shape with fully rounded ends
+     * @default 'rounded-rect'
+     */
+    shape?: ZoneShape;
+    /**
+     * Width of the border around the zone.
+     * Set to 0 to disable.
+     * @default 0
+     */
+    borderWidth?: number;
+    /**
+     * Color of the border.
+     * @default 'transparent'
+     */
+    borderColor?: string;
+    /**
+     * Color of the outer glow effect. Applied only if `enableGlow` is true in `TourConfig`.
+     * @default '#FFFFFF'
+     */
+    glowColor?: string;
+    /**
+     * Blur radius for the glow effect. Applied only if `enableGlow` is true in `TourConfig`.
+     * @default 10
+     */
+    glowRadius?: number;
+    /**
+     * Spread radius for the glow effect. Applied only if `enableGlow` is true in `TourConfig`.
+     * @default 5
+     */
+    glowSpread?: number;
+    /**
+     * Horizontal offset for the glow effect.
+     * @default 0
+     */
+    glowOffsetX?: number;
+    /**
+     * Vertical offset for the glow effect.
+     * @default 0
+     */
+    glowOffsetY?: number;
+    /**
+     * Spring damping for zone animations (per-step override).
+     */
+    springDamping?: number;
+    /**
+     * Spring stiffness for zone animations (per-step override).
+     */
+    springStiffness?: number;
+}
 export interface TourStep {
     /**
      * Unique key for this step.
@@ -26,6 +115,36 @@ export interface TourStep {
      * If false, interactions are blocked (default behavior depends on global config).
      */
     clickable?: boolean;
+    /**
+     * If true, prevents interaction with the underlying app for this specific step.
+     * Overrides the global preventInteraction setting from TourConfig.
+     * @default undefined (uses global setting)
+     */
+    preventInteraction?: boolean;
+    /**
+     * If true, the skip button is hidden for this step (user must complete or press next).
+     * @default false
+     */
+    required?: boolean;
+    /**
+     * Controls whether the next/finish button is enabled.
+     * - `undefined`: No enforcement, next button always enabled (default).
+     * - `false`: Next button is disabled (grayed out, non-pressable).
+     * - `true`: Next button is enabled.
+     *
+     * Use this to gate progression until the user completes an action.
+     */
+    completed?: boolean;
+    /**
+     * Per-step zone style overrides.
+     * Merged with global zoneStyle from TourConfig.
+     */
+    zoneStyle?: ZoneStyle;
+    /**
+     * Custom render function for this step's tooltip/card.
+     * Overrides the global renderCard from TourConfig.
+     */
+    renderCustomCard?: (props: CardProps) => React.ReactNode;
 }
 export interface MeasureResult {
     x: number;
@@ -34,12 +153,80 @@ export interface MeasureResult {
     height: number;
 }
 export type StepMap = Record<string, TourStep>;
+/**
+ * Steps order can be either:
+ * - A flat array of step keys (single-screen tour): `['bio', 'prompt', 'poll']`
+ * - A screen-grouped object (multi-screen tour): `{ ProfileSelf: ['bio', 'prompt'], HomeSwipe: ['filters'] }`
+ */
+export type StepsOrder = string[] | Record<string, string[]>;
 export interface TourLabels {
     next?: string;
     previous?: string;
     finish?: string;
     skip?: string;
 }
+export interface TooltipStyles {
+    /**
+     * Background color of the tooltip
+     */
+    backgroundColor?: string;
+    /**
+     * Border radius of the tooltip (for shape customization)
+     */
+    borderRadius?: number;
+    /**
+     * Text color for the title
+     */
+    titleColor?: string;
+    /**
+     * Text color for the description
+     */
+    descriptionColor?: string;
+    /**
+     * Background color for the primary button
+     */
+    primaryButtonColor?: string;
+    /**
+     * Text color for the primary button
+     */
+    primaryButtonTextColor?: string;
+    /**
+     * Border radius for the primary button
+     */
+    primaryButtonBorderRadius?: number;
+    /**
+     * Text color for the skip button
+     */
+    skipButtonTextColor?: string;
+    /**
+     * Custom style for the tooltip container
+     */
+    containerStyle?: ViewStyle;
+    /**
+     * Custom style for the title text
+     */
+    titleStyle?: TextStyle;
+    /**
+     * Custom style for the description text
+     */
+    descriptionStyle?: TextStyle;
+    /**
+     * Custom style for the primary button
+     */
+    primaryButtonStyle?: ViewStyle;
+    /**
+     * Custom style for the primary button text
+     */
+    primaryButtonTextStyle?: TextStyle;
+    /**
+     * Custom style for the skip button
+     */
+    skipButtonStyle?: ViewStyle;
+    /**
+     * Custom style for the skip button text
+     */
+    skipButtonTextStyle?: TextStyle;
+}
 export interface CardProps {
     step: TourStep;
     currentStepIndex: number;
@@ -50,10 +237,70 @@ export interface CardProps {
     isFirst: boolean;
     isLast: boolean;
     labels?: TourLabels;
+    /**
+     * Whether the step is required (skip button should be hidden).
+     */
+    required?: boolean;
+    /**
+     * Whether the step's completion condition is met.
+     * - `undefined`: No enforcement, next button always enabled.
+     * - `false`: Next button should be disabled.
+     * - `true`: Next button should be enabled.
+     */
+    completed?: boolean;
+}
+/**
+ * Storage adapter interface for tour persistence.
+ * Compatible with MMKV v4 and AsyncStorage APIs.
+ */
+export interface StorageAdapter {
+    getItem: (key: string) => Promise<string | null> | string | null;
+    setItem: (key: string, value: string) => Promise<void> | void;
+    removeItem: (key: string) => Promise<void> | void;
+}
+/**
+ * Configuration for tour progress persistence.
+ */
+export interface TourPersistenceConfig {
+    /**
+     * Enable persistence. When true, the library will auto-detect available storage
+     * (MMKV v4 or AsyncStorage) and save/restore tour progress.
+     * @default false
+     */
+    enabled: boolean;
+    /**
+     * Unique identifier for this tour. Used as the storage key.
+     * Required when persistence is enabled.
+     * @example 'onboarding-tour' or 'feature-tour-v2'
+     */
+    tourId: string;
+    /**
+     * Custom storage adapter. If not provided, the library will auto-detect
+     * MMKV v4 or AsyncStorage.
+     */
+    storage?: StorageAdapter;
+    /**
+     * If true, automatically resume the tour from the saved step when start() is called
+     * without a specific step key.
+     * @default true
+     */
+    autoResume?: boolean;
+    /**
+     * If true, clear saved progress when the tour is completed (reaches the last step).
+     * @default true
+     */
+    clearOnComplete?: boolean;
+    /**
+     * Maximum age (in milliseconds) for saved progress. Progress older than this
+     * will be ignored and cleared.
+     * @default undefined (no expiration)
+     * @example 7 * 24 * 60 * 60 * 1000 // 7 days
+     */
+    maxAge?: number;
 }
 export interface TourConfig {
     /**
-     * Animation configuration for the spotlight movement.
+     * Animation configuration for the zone movement.
      */
     springConfig?: WithSpringConfig;
     /**
@@ -73,14 +320,35 @@ export interface TourConfig {
      * Backdrop opacity. Default 0.5
      */
     backdropOpacity?: number;
+    /**
+     * Custom styles for the tooltip appearance
+     */
+    tooltipStyles?: TooltipStyles;
+    /**
+     * Global zone style settings.
+     * Can be overridden per-step via TourStep.zoneStyle or TourZone props.
+     */
+    zoneStyle?: ZoneStyle;
+    /**
+     * Persistence configuration for saving/restoring tour progress.
+     * Supports MMKV v4 and AsyncStorage out of the box.
+     */
+    persistence?: TourPersistenceConfig;
+    /**
+     * Defines whether to apply a shadow/glow effect to the active tour zone highlight.
+     * @default false
+     */
+    enableGlow?: boolean;
 }
 export interface TourContextType {
     /**
      * Starts the tour at the first step or a specific step (by key).
+     * If persistence is enabled and autoResume is true, will resume from saved progress.
      */
     start: (stepKey?: string) => void;
     /**
      * Stops the tour and hides the overlay.
+     * Does NOT clear saved progress (use clearProgress for that).
      */
     stop: () => void;
     /**
@@ -117,9 +385,38 @@ export interface TourContextType {
      */
     config?: TourConfig;
     /**
+     * Animated ref to attach to your ScrollView for auto-scrolling.
+     * Use this ref directly on your ScrollView/Animated.ScrollView component.
+     * For custom scroll view components, use the useTourScrollView hook instead.
+     */
+    scrollViewRef: React.RefObject<any>;
+    /**
+     * @deprecated Use scrollViewRef directly instead.
      * Registers the main ScrollView ref for auto-scrolling
      */
     setScrollViewRef: (ref: any) => void;
+    /**
+     * Clears any saved tour progress from storage.
+     * Only available when persistence is enabled.
+     */
+    clearProgress: () => Promise<void>;
+    /**
+     * Whether there is saved progress available to resume.
+     * Only meaningful when persistence is enabled.
+     */
+    hasSavedProgress: boolean;
+    /**
+     * The full ordered list of step keys for this tour.
+     * Derived from stepsOrder prop or step registration order.
+     * 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>;
@@ -128,8 +425,26 @@ export interface InternalTourContextType extends TourContextType {
     targetHeight: SharedValue<number>;
     targetRadius: SharedValue<number>;
     opacity: SharedValue<number>;
+    /** Border width for the zone glow ring */
+    zoneBorderWidth: SharedValue<number>;
     containerRef: React.RefObject<any>;
     scrollViewRef: React.RefObject<any>;
     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/lib/typescript/src/utils/storage.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Storage adapter for tour persistence.
+ * Auto-detects available storage (MMKV v4 or AsyncStorage) and provides a unified interface.
+ */
+export type StorageType = 'mmkv' | 'async-storage' | 'custom' | 'none';
+export interface StorageAdapter {
+    getItem: (key: string) => Promise<string | null> | string | null;
+    setItem: (key: string, value: string) => Promise<void> | void;
+    removeItem: (key: string) => Promise<void> | void;
+}
+export interface TourStorageState {
+    tourId: string;
+    currentStepKey: string;
+    stepIndex: number;
+    timestamp: number;
+}
+/**
+ * Detects the available storage type and returns an adapter.
+ * Priority: MMKV v4 > AsyncStorage > none
+ */
+export declare function detectStorage(): {
+    type: StorageType;
+    adapter: StorageAdapter | null;
+};
+/**
+ * Clears the cached storage detection result.
+ * Useful for testing or when storage availability changes.
+ */
+export declare function clearStorageCache(): void;
+/**
+ * Generates a storage key for a specific tour.
+ */
+export declare function getTourStorageKey(tourId: string): string;
+/**
+ * Saves the current tour progress to storage.
+ */
+export declare function saveTourProgress(adapter: StorageAdapter, tourId: string, currentStepKey: string, stepIndex: number): Promise<void>;
+/**
+ * Loads the saved tour progress from storage.
+ * Returns null if no progress is saved or if the data is invalid.
+ */
+export declare function loadTourProgress(adapter: StorageAdapter, tourId: string): Promise<TourStorageState | null>;
+/**
+ * Clears the saved tour progress from storage.
+ */
+export declare function clearTourProgress(adapter: StorageAdapter, tourId: string): Promise<void>;
+/**
+ * Checks if there is saved progress for a tour.
+ */
+export declare function hasTourProgress(adapter: StorageAdapter, tourId: string): Promise<boolean>;
+//# sourceMappingURL=storage.d.ts.map

package/lib/typescript/src/utils/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../../src/utils/storage.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,eAAe,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEvE,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;IACjE,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC9D,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACnD;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAyED;;;GAGG;AACH,wBAAgB,aAAa,IAAI;IAC/B,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;CAChC,CA0BA;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAGxC;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAExD;AAID;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAYf;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAwBlC;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,OAAO,CAAC,CAGlB"}