@mantis-core/next-core

Reusable Next.js app-level providers for Mantis Core apps.

Scope

• Query client creation.
• Session provider wiring.
• PrimeReact provider wiring.
• Toast provider wiring.

Out Of Scope

• Route/page business logic.
• Domain data fetching.
• UI components outside provider concerns.

Public API

createMantisCoreQueryClient(): QueryClient

type MantisCoreBaseProviderProps = PropsWithChildren<{
  includeSessionProvider?: boolean;
  includeToaster?: boolean;
  queryClient?: QueryClient;
  toasterProps?: ToasterProps;
}>;

MantisCoreBaseProvider(props)

type UseMantisToasts = {
  addSuccessToast(...)
  addErrorToast(...)
  addInfoToast(...)
  addWarningToast(...)
  addLoadingToast(...)
  promiseToast(...)
  jsxToast(...)
  dismiss(...)
  remove(...)
}

useMantisToasts(): UseMantisToasts

Usage Example

"use client";

import { MantisCoreBaseProvider } from "@mantis-core/next-core";

export default function Providers({ children }: { children: React.ReactNode }) {
  return <MantisCoreBaseProvider>{children}</MantisCoreBaseProvider>;
}

"use client";

import { useMantisToasts } from "@mantis-core/next-core";

export function Example() {
  const toast = useMantisToasts();
  return <button onClick={() => toast.addSuccessToast("Guardado")}>Toast</button>;
}

Provider Behavior

• Creates a default QueryClient unless one is injected.
• Wraps children with PrimeReactProvider.
• Optionally includes SessionProvider.
• Optionally includes react-hot-toast with sane defaults.
• Toast defaults use CSS tokens (--card, --foreground, --border, semantic colors).

Build

pnpm --filter @mantis-core/next-core build
pnpm --filter @mantis-core/next-core typecheck

Peer Dependencies

This package expects the consuming app to provide:

• react, react-dom
• next-auth
• @tanstack/react-query
• primereact
• react-hot-toast