archy/neode-ui/src/utils/introSplash.ts

export interface IntroSplashDecisionInput {
  seenIntro: boolean
  routePath: string
  fromBoot: boolean
  devMode?: string
  onboardingComplete: boolean | null
  /** Explicit "Replay intro" click — overrides every suppression rule. */
  replayRequested?: boolean
}

export function shouldShowIntroSplash(input: IntroSplashDecisionInput): boolean {
  if (input.replayRequested) return true
  if (input.seenIntro) return false
  if (input.onboardingComplete === true) return false

  const isDirectRoute = input.routePath !== '/'
  if (input.fromBoot) return true
  if (input.devMode === 'boot') return false
  return !isDirectRoute
}