Navigation Management

import { inject } from 'vue';

export default {
  setup() {
    const navManager = inject('navManager');
    // Use navigation methods...
  }
}

/**
 * Navigate to a specific route with Ionic-specific parameters
 * @param path - Route path or location to navigate to
 * @param routerAction - Type of navigation action (default: "push") 
 * @param routerDirection - Animation direction for navigation (default: "forward")
 * @param routerAnimation - Custom animation builder for transitions
 * @param tab - Tab context for the navigation
 */
handleNavigate(
  path: RouteLocationRaw,
  routerAction?: RouteAction,
  routerDirection?: RouteDirection,
  routerAnimation?: AnimationBuilder,
  tab?: string
): void;

// Basic navigation
navManager.handleNavigate('/profile');

// Navigation with direction and animation
navManager.handleNavigate('/settings', 'push', 'forward');

// Replace current route
navManager.handleNavigate('/login', 'replace', 'root');

// Tab-aware navigation
navManager.handleNavigate('/tabs/discover', 'push', 'forward', undefined, 'discover');

/**
 * Handle backward navigation with optional fallback route
 * @param defaultHref - Fallback route if no back history exists
 * @param routerAnimation - Custom animation for back navigation
 */
handleNavigateBack(defaultHref?: string, routerAnimation?: AnimationBuilder): void;

// Simple back navigation
navManager.handleNavigateBack();

// Back navigation with fallback
navManager.handleNavigateBack('/home');

// Back navigation with custom animation
navManager.handleNavigateBack('/home', customSlideAnimation);

/**
 * Navigate using external navigation options
 * @param navigationOptions - Object containing navigation parameters
 */
navigate(navigationOptions: ExternalNavigationOptions): void;

interface ExternalNavigationOptions {
  routerLink: string;
  routerDirection?: RouteDirection;
  routerAnimation?: AnimationBuilder;
  routerAction?: RouteAction;
}

navManager.navigate({
  routerLink: '/profile',
  routerDirection: 'forward',
  routerAction: 'push'
});

/**
 * Get current route information with navigation context
 * @returns Current route information object
 */
getCurrentRouteInfo(): RouteInfo;

/**
 * Get information about the route being left during navigation
 * @returns Route information for the leaving route
 */
getLeavingRouteInfo(): RouteInfo;

/**
 * Check if backward navigation is possible
 * @param deep - Number of steps to check back (default: 1)
 * @returns True if back navigation is possible
 */
canGoBack(deep?: number): boolean;

// Check if can go back one step
if (navManager.canGoBack()) {
  navManager.handleNavigateBack();
}

// Check if can go back multiple steps
if (navManager.canGoBack(3)) {
  // Can go back 3 steps
}

/**
 * Navigate backward in browser history with optional animation
 * @param routerAnimation - Custom animation for back navigation
 */
goBack(routerAnimation?: AnimationBuilder): void;

/**
 * Navigate forward in browser history with optional animation  
 * @param routerAnimation - Custom animation for forward navigation
 */
goForward(routerAnimation?: AnimationBuilder): void;

// Basic browser back
navManager.goBack();

// Browser back with custom animation
navManager.goBack(customSlideAnimation);

// Browser forward
navManager.goForward();

/**
 * Reset a tab to its initial route
 * @param tab - Tab identifier to reset
 */
resetTab(tab: string): void;

/**
 * Change to a different tab with optional specific path
 * @param tab - Tab identifier to switch to
 * @param path - Optional specific path within the tab
 */
changeTab(tab: string, path?: string): void;

/**
 * Set the current tab context for route information
 * @param tab - Tab identifier to set as current
 */
handleSetCurrentTab(tab: string): void;

// Reset tab to initial route
navManager.resetTab('discover');

// Switch to tab at specific path
navManager.changeTab('profile', '/tabs/profile/settings');

// Set current tab context
navManager.handleSetCurrentTab('home');

/**
 * Register a callback for history change events
 * @param callback - Function to call when history changes
 */
registerHistoryChangeListener(callback: (routeInfo: RouteInfo) => void): void;

navManager.registerHistoryChangeListener((routeInfo) => {
  console.log('Navigation changed:', routeInfo.pathname);
});