@korsolutions/guidon 1.0.9 → 1.0.10

package/dist/typescript/module/types.d.ts

@@ -165,8 +165,8 @@ export interface GuidonTooltipRenderProps {
  */
 export interface GuidonProviderProps {
     children: ReactNode;
-    /** Configuration for the guidon */
-    config: GuidonConfig;
+    /** Configuration for the guidon (optional when using configureTours) */
+    config?: GuidonConfig;
     /** Whether to auto-start when the component mounts */
     autoStart?: boolean;
     /** Condition function to determine if guidon should start */
@@ -194,11 +194,19 @@ export interface GuidonTargetProps {
     /** Whether this target is currently active (for conditional rendering) */
     active?: boolean;
 }
+/**
+ * Collection of named tours
+ */
+export type GuidonTours = Record<string, GuidonConfig>;
 /**
  * Internal store state
  */
 export interface GuidonState {
-    /** Currently active guidon config */
+    /** Collection of all configured tours */
+    tours: GuidonTours;
+    /** ID of the currently active tour */
+    activeTourId: string | null;
+    /** Currently active guidon config (derived from tours + activeTourId, or legacy single config) */
     config: GuidonConfig | null;
     /** Whether the guidon is currently active */
     isActive: boolean;
@@ -221,10 +229,14 @@ export interface GuidonState {
  * Internal store actions
  */
 export interface GuidonActions {
-    /** Configure the guidon */
+    /** Configure a single guidon (legacy API, still supported) */
     configure: (config: GuidonConfig) => void;
-    /** Start the guidon */
-    start: () => void;
+    /** Configure multiple named tours */
+    configureTours: (tours: GuidonTours) => void;
+    /** Start a tour by ID, or the legacy single config if no ID provided */
+    start: (tourId?: string) => void;
+    /** Stop the current tour without completing it */
+    stop: () => void;
     /** Go to the next step */
     next: () => void;
     /** Go to the previous step */

package/dist/typescript/module/types.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@korsolutions/guidon",
-  "version": "1.0.9",
+  "version": "1.0.10",
   "description": "A cross-platform walkthrough/onboarding component library for React Native with web support. Features spotlight effects, customizable tooltips, and flexible persistence options. ",
   "repository": "https://github.com/KorSoftwareSolutions/guidon.git",
   "author": "Christian Jimenez <christianjimenezfael@gmail.com>",

package/src/components/GuidonProvider.tsx

@@ -10,7 +10,7 @@ import type {
 } from '../types';
 
 interface GuidonContextValue {
-  start: () => void;
+  start: (tourId?: string) => void;
   skip: () => void;
   reset: () => void;
   replay: () => Promise<void>;
@@ -43,6 +43,7 @@ export function GuidonProvider({
   const hasInitialized = useRef(false);
   const isActive = useGuidonStore((state: GuidonStore) => state.isActive);
   const storeIsCompleted = useGuidonStore((state: GuidonStore) => state.isCompleted);
+  const storeConfig = useGuidonStore((state: GuidonStore) => state.config);
   const currentStepIndex = useGuidonStore((state: GuidonStore) => state.currentStepIndex);
   const configure = useGuidonStore((state: GuidonStore) => state.configure);
   const start = useGuidonStore((state: GuidonStore) => state.start);
@@ -53,17 +54,23 @@ export function GuidonProvider({
   // Check for waiting state (target element not mounted)
   const waitingState = useWaitingState();
 
+  // Use config prop ID for persistence, or fall back to store config ID
+  const persistenceId = config?.id ?? storeConfig?.id ?? '__guidon_default__';
+
   const {
     isLoading,
     isCompleted: persistedCompleted,
     markCompleted,
     markStepViewed,
     clearProgress,
-  } = useGuidonPersistence(persistenceAdapter, config.id);
+  } = useGuidonPersistence(persistenceAdapter, persistenceId);
 
   const isCompleted = storeIsCompleted || persistedCompleted;
 
+  // Only configure if a config prop is provided (legacy single-config mode)
   useEffect(() => {
+    if (!config) return;
+
     const enhancedConfig: GuidonConfig = {
       ...config,
       onComplete: async () => {
@@ -89,8 +96,9 @@ export function GuidonProvider({
     configure(enhancedConfig);
   }, [config, configure, persistenceAdapter, markCompleted, markStepViewed, currentStepIndex]);
 
+  // Auto-start only in legacy single-config mode
   useEffect(() => {
-    if (!autoStart || hasInitialized.current || isLoading) return;
+    if (!config || !autoStart || hasInitialized.current || isLoading) return;
 
     const checkAndStart = async () => {
       hasInitialized.current = true;
@@ -108,11 +116,15 @@ export function GuidonProvider({
     };
 
     checkAndStart();
-  }, [autoStart, isLoading, persistedCompleted, shouldStart, start]);
+  }, [config, autoStart, isLoading, persistedCompleted, shouldStart, start]);
 
   // Handle wait timeout - auto-skip to next step if waiting too long
+  // Works for both legacy and multi-tour mode (reads from store)
   useEffect(() => {
-    const currentStep = config.steps[currentStepIndex];
+    const activeConfig = storeConfig;
+    if (!activeConfig) return;
+
+    const currentStep = activeConfig.steps[currentStepIndex];
     const waitTimeout = currentStep?.waitTimeout;
 
     // Only set timeout if:
@@ -132,7 +144,7 @@ export function GuidonProvider({
     }, waitTimeout);
 
     return () => clearTimeout(timer);
-  }, [currentStepIndex, config.steps, waitingState?.isWaiting, next]);
+  }, [currentStepIndex, storeConfig, waitingState?.isWaiting, next]);
 
   const replay = useCallback(async () => {
     if (persistenceAdapter) {
@@ -145,9 +157,9 @@ export function GuidonProvider({
     }, 100);
   }, [persistenceAdapter, clearProgress, reset, start]);
 
-  const manualStart = useCallback(() => {
+  const manualStart = useCallback((tourId?: string) => {
     if (!isActive && !isLoading) {
-      start();
+      start(tourId);
     }
   }, [isActive, isLoading, start]);
 
@@ -161,16 +173,20 @@ export function GuidonProvider({
     isLoading,
   };
 
+  // Get theme from prop config or store config
+  const activeTheme = config?.theme ?? storeConfig?.theme;
+  const activeDuration = config?.animationDuration ?? storeConfig?.animationDuration;
+
   const overlayContent = (
     <>
       <GuidonOverlay
-        theme={config.theme}
-        animationDuration={config.animationDuration}
+        theme={activeTheme}
+        animationDuration={activeDuration}
         onBackdropPress={onBackdropPress}
       />
       <GuidonTooltip
-        theme={config.theme}
-        animationDuration={config.animationDuration}
+        theme={activeTheme}
+        animationDuration={activeDuration}
         renderCustomTooltip={renderTooltip}
         labels={tooltipLabels}
       />

package/src/index.ts

@@ -26,6 +26,7 @@ export {
 export type {
   GuidonStep,
   GuidonConfig,
+  GuidonTours,
   GuidonTheme,
   GuidonProgress,
   GuidonPersistenceAdapter,

package/src/store.ts

@@ -1,30 +1,66 @@
 import { create } from "zustand";
 import { useShallow } from "zustand/react/shallow";
-import type { GuidonConfig, GuidonStore, TargetMeasurements } from "./types";
+import type { GuidonConfig, GuidonStore, GuidonTours, TargetMeasurements } from "./types";
 
 const initialState = {
-  config: null,
+  tours: {} as GuidonTours,
+  activeTourId: null as string | null,
+  config: null as GuidonConfig | null,
   isActive: false,
   currentStepIndex: 0,
   isCompleted: false,
-  targetMeasurements: {},
+  targetMeasurements: {} as Record<string, TargetMeasurements>,
   isLoading: false,
-  error: null,
+  error: null as string | null,
   waitingForTarget: false,
-  waitingTargetId: null,
+  waitingTargetId: null as string | null,
 };
 
 export const useGuidonStore = create<GuidonStore>((set, get) => ({
   ...initialState,
 
   configure: (config: GuidonConfig) => {
+    const { config: existingConfig } = get();
+
+    // Skip if same config reference (prevents re-renders from resetting)
+    if (existingConfig === config) {
+      return;
+    }
+
     console.log("[Guidon] configure() called - resetting to step 0");
     set({ config, currentStepIndex: 0, isCompleted: false });
   },
 
-  start: () => {
-    const { config } = get();
-    console.log("[Guidon] start() called - will reset to step 0", {
+  configureTours: (tours: GuidonTours) => {
+    const { tours: existingTours } = get();
+
+    // Skip if same tours reference (prevents re-renders from resetting)
+    if (existingTours === tours) {
+      return;
+    }
+
+    console.log("[Guidon] configureTours() called with tours:", Object.keys(tours));
+    set({ tours });
+  },
+
+  start: (tourId?: string) => {
+    const { tours, config: legacyConfig } = get();
+
+    // If tourId provided, use that tour from the tours collection
+    let config: GuidonConfig | null = null;
+    if (tourId) {
+      config = tours[tourId] ?? null;
+      if (!config) {
+        console.log(`[Guidon] start() - tour "${tourId}" not found`);
+        return;
+      }
+    } else {
+      // Fall back to legacy single config
+      config = legacyConfig;
+    }
+
+    console.log("[Guidon] start() called", {
+      tourId: tourId ?? "legacy",
       hasConfig: !!config,
       stepCount: config?.steps.length ?? 0,
     });
@@ -38,7 +74,13 @@ export const useGuidonStore = create<GuidonStore>((set, get) => ({
       "[Guidon] starting walkthrough with steps:",
       config.steps.map((s) => s.id),
     );
-    set({ isActive: true, currentStepIndex: 0, isCompleted: false });
+    set({
+      config,
+      activeTourId: tourId ?? null,
+      isActive: true,
+      currentStepIndex: 0,
+      isCompleted: false
+    });
 
     // Call onStepEnter for the first step
     const firstStep = config.steps[0];
@@ -48,6 +90,18 @@ export const useGuidonStore = create<GuidonStore>((set, get) => ({
     }
   },
 
+  stop: () => {
+    const { config, currentStepIndex, isActive } = get();
+    if (!isActive) return;
+
+    console.log("[Guidon] stop() called");
+
+    const currentStep = config?.steps[currentStepIndex];
+    currentStep?.onStepExit?.();
+
+    set({ isActive: false, activeTourId: null });
+  },
+
   next: () => {
     const { config, currentStepIndex, isActive } = get();
     console.log("[Guidon] next() called", {
@@ -193,17 +247,39 @@ export const useGuidonStore = create<GuidonStore>((set, get) => ({
  */
 export const Guidon = {
   /**
-   * Configure the walkthrough with steps and options
+   * Configure a single walkthrough (legacy API)
    */
   configure: (config: GuidonConfig) => {
     useGuidonStore.getState().configure(config);
   },
 
   /**
-   * Start the walkthrough
+   * Configure multiple named tours
+   * @example
+   * Guidon.configureTours({
+   *   explore: { steps: [...], onComplete: () => {} },
+   *   profile: { steps: [...] },
+   * });
+   */
+  configureTours: (tours: GuidonTours) => {
+    useGuidonStore.getState().configureTours(tours);
+  },
+
+  /**
+   * Start a tour by ID, or the legacy single config if no ID provided
+   * @example
+   * Guidon.start('explore'); // Start the 'explore' tour
+   * Guidon.start(); // Start legacy single config
    */
-  start: () => {
-    useGuidonStore.getState().start();
+  start: (tourId?: string) => {
+    useGuidonStore.getState().start(tourId);
+  },
+
+  /**
+   * Stop the current tour without completing it
+   */
+  stop: () => {
+    useGuidonStore.getState().stop();
   },
 
   /**
@@ -262,6 +338,20 @@ export const Guidon = {
     return useGuidonStore.getState().isCompleted;
   },
 
+  /**
+   * Get the currently active tour ID (null if using legacy single config)
+   */
+  getActiveTourId: () => {
+    return useGuidonStore.getState().activeTourId;
+  },
+
+  /**
+   * Get all configured tours
+   */
+  getTours: () => {
+    return useGuidonStore.getState().tours;
+  },
+
   /**
    * Get the current step index
    */

package/src/types.ts

@@ -186,8 +186,8 @@ export interface GuidonTooltipRenderProps {
  */
 export interface GuidonProviderProps {
   children: ReactNode;
-  /** Configuration for the guidon */
-  config: GuidonConfig;
+  /** Configuration for the guidon (optional when using configureTours) */
+  config?: GuidonConfig;
   /** Whether to auto-start when the component mounts */
   autoStart?: boolean;
   /** Condition function to determine if guidon should start */
@@ -215,11 +215,20 @@ export interface GuidonTargetProps {
   active?: boolean;
 }
 
+/**
+ * Collection of named tours
+ */
+export type GuidonTours = Record<string, GuidonConfig>;
+
 /**
  * Internal store state
  */
 export interface GuidonState {
-  /** Currently active guidon config */
+  /** Collection of all configured tours */
+  tours: GuidonTours;
+  /** ID of the currently active tour */
+  activeTourId: string | null;
+  /** Currently active guidon config (derived from tours + activeTourId, or legacy single config) */
   config: GuidonConfig | null;
   /** Whether the guidon is currently active */
   isActive: boolean;
@@ -243,10 +252,14 @@ export interface GuidonState {
  * Internal store actions
  */
 export interface GuidonActions {
-  /** Configure the guidon */
+  /** Configure a single guidon (legacy API, still supported) */
   configure: (config: GuidonConfig) => void;
-  /** Start the guidon */
-  start: () => void;
+  /** Configure multiple named tours */
+  configureTours: (tours: GuidonTours) => void;
+  /** Start a tour by ID, or the legacy single config if no ID provided */
+  start: (tourId?: string) => void;
+  /** Stop the current tour without completing it */
+  stop: () => void;
   /** Go to the next step */
   next: () => void;
   /** Go to the previous step */