Stirling-PDF/frontend/src/core/components/AppProviders.tsx

import { ReactNode } from "react";
import { RainbowThemeProvider } from "@app/components/shared/RainbowThemeProvider";
import { FileContextProvider } from "@app/contexts/FileContext";
import { NavigationProvider } from "@app/contexts/NavigationContext";
import { ToolRegistryProvider } from "@app/contexts/ToolRegistryProvider";
import { FilesModalProvider } from "@app/contexts/FilesModalContext";
import { ToolWorkflowProvider } from "@app/contexts/ToolWorkflowContext";
import { HotkeyProvider } from "@app/contexts/HotkeyContext";
import { SidebarProvider } from "@app/contexts/SidebarContext";
import { PreferencesProvider } from "@app/contexts/PreferencesContext";
import { AppConfigProvider, AppConfigRetryOptions } from "@app/contexts/AppConfigContext";
import { RightRailProvider } from "@app/contexts/RightRailContext";
import { ViewerProvider } from "@app/contexts/ViewerContext";
import { SignatureProvider } from "@app/contexts/SignatureContext";
import { OnboardingProvider } from "@app/contexts/OnboardingContext";
import { TourOrchestrationProvider } from "@app/contexts/TourOrchestrationContext";
import { AdminTourOrchestrationProvider } from "@app/contexts/AdminTourOrchestrationContext";
import ErrorBoundary from "@app/components/shared/ErrorBoundary";
import { useScarfTracking } from "@app/hooks/useScarfTracking";
import { useAppInitialization } from "@app/hooks/useAppInitialization";

// Component to initialize scarf tracking (must be inside AppConfigProvider)
function ScarfTrackingInitializer() {
  useScarfTracking();
  return null;
}

// Component to run app-level initialization (must be inside AppProviders for context access)
function AppInitializer() {
  useAppInitialization();
  return null;
}

export interface AppProvidersProps {
  children: ReactNode;
  appConfigRetryOptions?: AppConfigRetryOptions;
}

/**
 * Core application providers
 * Contains all providers needed for the core
 */
export function AppProviders({ children, appConfigRetryOptions }: AppProvidersProps) {
  return (
    <PreferencesProvider>
      <RainbowThemeProvider>
        <ErrorBoundary>
          <OnboardingProvider>
            <AppConfigProvider retryOptions={appConfigRetryOptions}>
              <ScarfTrackingInitializer />
              <FileContextProvider enableUrlSync={true} enablePersistence={true}>
                <AppInitializer />
                <ToolRegistryProvider>
                  <NavigationProvider>
                    <FilesModalProvider>
                      <ToolWorkflowProvider>
                        <HotkeyProvider>
                          <SidebarProvider>
                            <ViewerProvider>
                              <SignatureProvider>
                                <RightRailProvider>
                                  <TourOrchestrationProvider>
                                    <AdminTourOrchestrationProvider>
                                      {children}
                                    </AdminTourOrchestrationProvider>
                                  </TourOrchestrationProvider>
                                </RightRailProvider>
                              </SignatureProvider>
                            </ViewerProvider>
                          </SidebarProvider>
                        </HotkeyProvider>
                      </ToolWorkflowProvider>
                    </FilesModalProvider>
                  </NavigationProvider>
                </ToolRegistryProvider>
              </FileContextProvider>
            </AppConfigProvider>
          </OnboardingProvider>
        </ErrorBoundary>
      </RainbowThemeProvider>
    </PreferencesProvider>
  );
}