import type { AuthPluginBase, AuthView } from "@better-auth-ui/core"
import type { ComponentType, ReactNode } from "react"
import type { SettingsTab } from "./settings-tab"

export type { AuthPluginViewPaths } from "@better-auth-ui/core"

/** Props for plugin-contributed auth buttons (e.g. passkey, magic link). */
export type AuthButtonProps = {
  className?: string
  children?: ReactNode
  /** Current auth view — lets buttons context-switch (e.g. show "back to sign-in"). */
  view?: AuthView
}

/** Props for plugin-contributed cards under `/settings/security`. */
export type SecurityCardProps = {
  className?: string
  children?: ReactNode
}

/** Props for plugin-contributed cards under `/settings/account`. */
export type AccountCardProps = {
  className?: string
  children?: ReactNode
}

/** Props for plugin-contributed cards under `/organization/...` settings. */
export type OrganizationCardProps = {
  className?: string
  children?: ReactNode
}

/** Props for plugin-contributed items in the `UserButton` dropdown. */
export type UserMenuItemProps = {
  className?: string
  /** When true, the subtitle line (email when name/username is shown) is hidden. */
  hideSubtitle?: boolean
}

/** Framework-agnostic slot component shapes. UI packages narrow these via `TComponents`. */
export type AuthPluginComponents = {
  /** Rendered below the submit button in auth forms. */
  authButtons?: ComponentType<AuthButtonProps>[]
  /** Captcha widget rendered above the submit button, below additionalFields. Singular — only one captcha can be active at a time. */
  captchaComponent?: ReactNode
  /** Rendered as cards inside security settings. */
  securityCards?: ComponentType<SecurityCardProps>[]
  /** Rendered as cards inside account settings. */
  accountCards?: ComponentType<AccountCardProps>[]
  /** Rendered as cards inside the active organization's settings. */
  organizationCards?: ComponentType<OrganizationCardProps>[]
  /** Rendered as items inside the `UserButton` dropdown. */
  userMenuItems?: ComponentType<UserMenuItemProps>[]
}

/** Plugin view overrides keyed by `AuthPluginViewPaths`. Always replaces the built-in view. */
export type AuthPluginViews<TAuthViewProps, TSettingsViewProps> = {
  auth?: Record<string, ComponentType<TAuthViewProps>>
  settings?: Record<string, ComponentType<TSettingsViewProps>>
}

/** Conditional view replacements — only used when the built-in flow isn't viable. */
export type AuthPluginFallbackViews<TAuthViewProps> = {
  auth?: {
    /** Rendered at `/auth/sign-in` when `emailAndPassword.enabled === false`. */
    signIn?: ComponentType<TAuthViewProps>
  }
}

/**
 * UI-aware plugin definition. UI packages bind the generics in their own
 * `AuthPlugin` re-export so plugin authors don't have to.
 *
 * @typeParam TComponents - Slot component shapes (e.g. heroui variant unions).
 * @typeParam TAuthViewProps - Props the `<Auth>` router spreads onto plugin auth views.
 * @typeParam TSettingsViewProps - Props the `<Settings>` router spreads onto plugin settings views.
 */
export type AuthPlugin<
  TComponents = AuthPluginComponents,
  // biome-ignore lint/suspicious/noExplicitAny: any
  TAuthViewProps = any,
  // biome-ignore lint/suspicious/noExplicitAny: any
  TSettingsViewProps = any
> = AuthPluginBase &
  TComponents & {
    views?: AuthPluginViews<TAuthViewProps, TSettingsViewProps>
    fallbackViews?: AuthPluginFallbackViews<TAuthViewProps>
    /**
     * Tabs the plugin contributes to the settings page. Each entry is a
     * {@link SettingsTab} (`view`, `label`, `component`). Read at runtime via
     * `useAuthPlugin(plugin).settingsTabs`.
     */
    settingsTabs?: SettingsTab[]
  }