Config Types

interface SpotlightConfig {
  enabled?: boolean;
  padding?: number;
  borderRadius?: number;
  animate?: boolean;
  duration?: number;
  overlayColor?: string;
  overlayOpacity?: number;
  clickThrough?: boolean;
}

interface KeyboardConfig {
  enabled?: boolean;
  bindings?: {
    next?: string[];
    prev?: string[];
    skip?: string[];
    complete?: string[];
  };
  trapFocus?: boolean;
}

interface ScrollConfig {
  enabled?: boolean;
  behavior?: 'smooth' | 'instant' | 'auto';
  block?: 'start' | 'center' | 'end' | 'nearest';
  inline?: 'start' | 'center' | 'end' | 'nearest';
  offset?: number | { top: number; left: number };
}

interface PersistenceConfig {
  enabled?: boolean;
  strategy?: 'localStorage' | 'sessionStorage' | 'custom';
  key?: string;
  version?: number;
  storage?: {
    get: (key: string) => Promise<unknown> | unknown;
    set: (key: string, value: unknown) => Promise<void> | void;
    remove: (key: string) => Promise<void> | void;
  };
}

interface A11yConfig {
  announcements?: boolean;
  liveRegion?: 'polite' | 'assertive';
  ariaLabel?: string;
  closeLabel?: string;
  nextLabel?: string;
  prevLabel?: string;
  skipLabel?: string;
}

const defaultSpotlight: SpotlightConfig = {
  enabled: true,
  padding: 8,
  borderRadius: 4,
  animate: true,
  duration: 200,
  overlayColor: '#000',
  overlayOpacity: 0.5,
  clickThrough: false,
};

const defaultKeyboard: KeyboardConfig = {
  enabled: true,
  bindings: {
    next: ['ArrowRight', 'Enter'],
    prev: ['ArrowLeft'],
    skip: ['Escape'],
  },
  trapFocus: true,
};

const defaultScroll: ScrollConfig = {
  enabled: true,
  behavior: 'smooth',
  block: 'center',
  inline: 'nearest',
};

interface TourKitProviderProps {
  children: React.ReactNode
  config?: TourKitConfig
  /** Text direction; 'auto' resolves from document.dir on mount. */
  dir?: 'ltr' | 'rtl' | 'auto'
  onTourStart?: (tourId: string) => void
  onTourComplete?: (tourId: string) => void
  onTourSkip?: (tourId: string, stepIndex: number) => void
  onStepView?: (tourId: string, stepId: string, stepIndex: number) => void
  onBranchAction?: (tourId, stepId, actionId, target) => void
  onTourBranch?: (fromTourId, toTourId, fromStepId) => void
}

interface TourKitContextValue {
  config: TourKitConfig
  direction: 'ltr' | 'rtl'
  isRTL: boolean
  onTourStart?: (tourId: string) => void
  onTourComplete?: (tourId: string) => void
  onTourSkip?: (tourId: string, stepIndex: number) => void
  onStepView?: (tourId: string, stepId: string, stepIndex: number) => void
  onBranchAction?: (tourId, stepId, actionId, target) => void
  onTourBranch?: (fromTourId, toTourId, fromStepId) => void
}

type Direction = 'ltr' | 'rtl' | 'auto'

interface ElementPositionResult {
  element: HTMLElement | null
  rect: DOMRect | null
  scrollParent: HTMLElement | null
  update: () => void
}