payload-react-router 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,24 @@
+MIT License
+
+Copyright (c) 2026 Sakuga Software
+
+The Vite plugin under src/vite is ported from @payloadcms/tanstack-start:
+Copyright (c) 2018-2026 Payload CMS, LLC <info@payloadcms.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,264 @@
-# Temporary Holding Version
+# payload-react-router
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Mounts the [Payload](https://payloadcms.com) admin panel, REST API and GraphQL API inside a
+**React Router 8** app. It implements Payload's framework-adapter contracts (server, router,
+view and layout adapters, server functions); `@payloadcms/ui` is used unmodified.
+
+> **Status: experimental.** It runs on React Router's **RSC Framework Mode**, which React
+> Router itself ships as `unstable_` ("subject to breaking changes in minor/patch releases").
+> Payload's admin is built from React Server Components, so RSC is required, not optional —
+> see [Why RSC](#why-rsc). Versions are pinned for that reason.
+
+| Tested with | Version |
+| --- | --- |
+| `payload`, `@payloadcms/*` | `4.0.0-canary.39` |
+| `react-router`, `@react-router/dev`, `@react-router/serve` | `8.4.0` |
+| `@vitejs/plugin-rsc` | `0.5.35` (0.5.26 fails the build; 0.5.36 trips a React Router build invariant) |
+| `react`, `react-dom`, `react-server-dom-webpack` | `19.3.0` |
+| Vite | `8.x` |
+| Node.js | `>= 24.15` (Payload 4) |
+
+The adapter is exercised by a demo app: SQLite, Lexical, drafts + autosave, uploads, two
+locales, a global, and a website that reads content through the Local API. A 26-test Playwright
+bench runs on that app against both the production build and `vite dev`, with the adapter
+installed from the packed tarball. The demo app is in a private repository for now; the
+scenarios and results are in [`docs/COMPAT.md`](./docs/COMPAT.md).
+
+## Adding Payload to a React Router app
+
+### 1. Dependencies
+
+```bash
+pnpm add payload @payloadcms/ui @payloadcms/translations @payloadcms/graphql graphql \
+  @payloadcms/db-sqlite @payloadcms/richtext-lexical payload-react-router \
+  react@19.3.0 react-dom@19.3.0 react-server-dom-webpack@19.3.0 \
+  react-router@8.4.0 @react-router/serve@8.4.0
+pnpm add -D @react-router/dev@8.4.0 @vitejs/plugin-rsc@0.5.35 vite sass-embedded
+```
+
+### 2. Switch the app to RSC Framework Mode
+
+```ts
+// vite.config.ts
+import { unstable_reactRouterRSC as reactRouterRSC } from '@react-router/dev/vite'
+import rsc from '@vitejs/plugin-rsc'
+import { payload } from 'payload-react-router/vite'
+import { defineConfig } from 'vite'
+
+export default defineConfig({
+  plugins: [payload({ payloadConfigPath: './payload.config.ts' }), reactRouterRSC(), rsc()],
+})
+```
+
+`react-router.config.ts` needs nothing special (`ssr: true`, the default). React Router's RSC
+mode does not support `splitRouteModules`, `serverBundles`, `presets` or `buildEnd`.
+
+Existing routes keep working: a route with a `default` export is a client component, as
+before; a route can opt into a server component by exporting `ServerComponent` instead. The
+`.server.ts` file convention is not enforced in RSC mode — use the `server-only` package if
+you rely on it.
+
+The `payload()` plugin adds the `@payload-config` alias, SCSS importers, SSR externals,
+dependency-optimizer lists and a handful of Vite-level workarounds Payload needs (ported from
+`@payloadcms/tanstack-start`).
+
+### 3. Payload config
+
+```ts
+// payload.config.ts
+export default buildConfig({
+  admin: {
+    importMap: {
+      baseDir: import.meta.dirname,
+      // The Payload CLI only knows the Next.js and TanStack Start folder layouts.
+      importMapFile: path.resolve(import.meta.dirname, 'app/routes/payload/importMap.js'),
+    },
+  },
+  // In production this file is bundled into build/server/: anchor runtime paths
+  // (SQLite file, upload staticDir) on process.cwd(), not import.meta.dirname.
+  db: sqliteAdapter({ client: { url: `file:${path.resolve(process.cwd(), 'payload.db')}` } }),
+  // ...
+})
+```
+
+Generate the import map whenever admin components change:
+
+```bash
+PAYLOAD_CONFIG_PATH=./payload.config.ts pnpm payload generate:importmap
+```
+
+and add `app/routes/payload/importMap.d.ts`:
+
+```ts
+import type { ImportMap } from 'payload'
+export declare const importMap: ImportMap
+```
+
+### 4. Routes
+
+```ts
+// app/routes.ts
+import { index, layout, route, type RouteConfig } from '@react-router/dev/routes'
+
+export default [
+  layout('routes/site/layout.tsx', [index('routes/site/home.tsx') /* your site */]),
+  layout('routes/payload/layout.tsx', { id: 'payload' }, [route('admin/*', 'routes/payload/admin.tsx')]),
+  route('api/*', 'routes/payload/api.ts'),
+] satisfies RouteConfig
+```
+
+The admin renders its own `<html>` (theme, language and direction attributes), so the root
+route must not. Let each layout route own its document:
+
+```tsx
+// app/root.tsx
+import { Outlet } from 'react-router'
+import { payloadMiddleware } from 'payload-react-router/server'
+
+export const middleware = [payloadMiddleware]
+
+export function ServerComponent() {
+  return <Outlet />
+}
+```
+
+`payloadMiddleware` must be on the root route: it scopes every request (documents, data
+requests, server functions, resource routes) so Payload can read headers and set cookies.
+
+```tsx
+// app/routes/payload/server-functions.ts
+'use server'
+import type { ServerFunctionClientArgs } from 'payload'
+import config from '@payload-config'
+import { handleServerFunctions } from 'payload-react-router/server'
+import { importMap } from './importMap.js'
+
+export async function serverFunction(args: ServerFunctionClientArgs, _revalidation?: FormData) {
+  return handleServerFunctions({ ...args, config, importMap })
+}
+```
+
+```tsx
+// app/routes/payload/layout.tsx — the admin document and providers
+import config from '@payload-config'
+import '@payloadcms/ui/css/app.css'
+import { PayloadAdminLayout } from 'payload-react-router/server'
+import { Outlet } from 'react-router'
+import { importMap } from './importMap.js'
+import { serverFunction } from './server-functions'
+
+export function ServerComponent() {
+  return (
+    <PayloadAdminLayout config={config} importMap={importMap} serverFunction={serverFunction}>
+      <Outlet />
+    </PayloadAdminLayout>
+  )
+}
+```
+
+```tsx
+// app/routes/payload/admin.tsx — /admin and every admin view
+import config from '@payload-config'
+import { AdminPage, loadAdminPage } from 'payload-react-router/server'
+import type { Route } from './+types/admin'
+import { importMap } from './importMap.js'
+
+export const loader = ({ params, request }: Route.LoaderArgs) =>
+  loadAdminPage({ config, importMap, request, splat: params['*'] })
+
+export function ServerComponent({ loaderData }: Route.ComponentProps) {
+  return <AdminPage {...loaderData} />
+}
+```
+
+```ts
+// app/routes/payload/api.ts — REST + GraphQL
+import config from '@payload-config'
+import { createAPIRoute } from 'payload-react-router/server'
+
+export const { action, loader, middleware } = createAPIRoute({ config })
+```
+
+### 5. Reading content from the site (Local API)
+
+```tsx
+// app/routes/site/home.tsx
+import config from '@payload-config'
+import { getPayload } from 'payload'
+
+export async function loader() {
+  const payload = await getPayload({ config })
+  const posts = await payload.find({ collection: 'posts', overrideAccess: false })
+  return { posts: posts.docs }
+}
+```
+
+Same process, no HTTP hop, no token. Pass `overrideAccess: false` so collection access control
+decides what anonymous visitors see.
+
+### 6. Production
+
+```bash
+pnpm react-router build
+pnpm react-router-serve ./build/server/index.js
+```
+
+The schema is pushed automatically in development only. For production, create migrations
+(`payload migrate:create`) and pass them as `prodMigrations` to the database adapter, or run
+`payload migrate` before starting.
+
+## API
+
+`payload-react-router/vite`
+
+- `payload({ payloadConfigPath, devServerExternalPackages?, silenceDependencyWarnings? })`
+
+`payload-react-router/server`
+
+- `payloadMiddleware` — root route middleware (request scope + `Set-Cookie`).
+- `PayloadAdminLayout` — admin document + providers (server component).
+- `loadAdminPage({ config, importMap, request, splat })` / `AdminPage` — admin views.
+- `handleServerFunctions` — Payload's server-function dispatcher.
+- `createAPIRoute({ config })` / `handleAPIRoute({ config, request })` — REST + GraphQL.
+- `login` / `logout` / `refresh` — Payload auth functions bound to this adapter.
+- `reactRouterServerAdapter`, `createPageRenderServerAdapter`, `initAdminContext`,
+  `getRequestI18n`, `getRequest`, `serializeCookie` — lower-level pieces.
+
+`payload-react-router/client`
+
+- `ReactRouterAdapter` — Payload's router contract on React Router hooks.
+- `PayloadRootProviders` — `RootProviders` bound to the router adapter.
+
+## How it maps to Payload's contracts
+
+| Contract | Implementation |
+| --- | --- |
+| `ServerAdapter` | Per-request `AsyncLocalStorage` opened by `payloadMiddleware`. Headers/cookies come from the `Request`; `setCookie` is appended to the response. `redirect`/`notFound`/`forbidden`/`unauthorized`/`permanentRedirect` throw React Router responses with real 302/404/403/401/308 statuses. |
+| View adapter | `loadAdminPage` calls `renderRoot` in the route loader and renders the tree to completion, so a `redirect()`/`notFound()` raised deep inside a view still becomes a real redirect or a 404 page. |
+| Layout adapter | `PayloadAdminLayout` (server component) renders `DocumentRoot` and providers. |
+| Router adapter | `useNavigate` / `navigate(-1)` / `useRevalidator().revalidate()` / `Link`; `replaceState` uses the History API, which React Router does not observe. |
+| Server functions | A real `'use server'` function: results, including React nodes, travel over Flight as with Next.js. Calls opt out of React Router's automatic revalidation (`$SKIP_REVALIDATION`); Payload refreshes explicitly. |
+| REST / GraphQL | Resource route → `handleEndpoints`; `POST /api/graphql` → GraphQL handler; `OPTIONS` answered by a route middleware. |
+
+The full contract-by-contract comparison with `@payloadcms/next` and
+`@payloadcms/tanstack-start`, and every issue found in the contracts, are in
+[`docs/NOTES.md`](./docs/NOTES.md) (in French). Test coverage is in
+[`docs/COMPAT.md`](./docs/COMPAT.md).
+
+## Why RSC
+
+Payload's admin views (`renderRoot`), its root layout and its server functions are React
+Server Components: they are async, run server-only code, and return React elements to the
+client (a rendered document, a list, form fields with custom server components). Without an
+RSC runtime they cannot render — `@payloadcms/tanstack-start` enables RSC for the same reason.
+A plain "SSR + loaders" React Router app cannot host the admin without changing
+`@payloadcms/ui`.
+
+## Known limitations
+
+- React Router RSC mode is `unstable_`; pin versions and re-run the bench on upgrades.
+- Mounting the admin at `/` (Payload's `admin-root` setup) is untested; TanStack skips it too.
+- The Payload CLI does not detect React Router: use `importMapFile` and `PAYLOAD_CONFIG_PATH`.
+- Each admin page is rendered to completion on the server before streaming starts (needed
+  to turn in-view redirects into real redirects; TanStack does the same).
+- Live preview and cloud storage adapters are not covered by the bench yet.

package/dist/client/PayloadRootProviders.d.ts

@@ -0,0 +1,22 @@
+import type { RootLayoutData } from '@payloadcms/ui/layouts/Root/getRootLayoutData';
+import type { ServerFunctionClientArgs } from 'payload';
+import type { ReactNode } from 'react';
+/**
+ * Signature of the app's `'use server'` function. The second argument is the
+ * revalidation opt-out added by {@link PayloadRootProviders}; the server side
+ * ignores it.
+ */
+export type PayloadServerFunction = (args: ServerFunctionClientArgs, revalidation?: FormData) => Promise<unknown>;
+export type PayloadRootProvidersProps = {
+    children: ReactNode;
+    data: RootLayoutData;
+    serverFunction: PayloadServerFunction;
+};
+declare global {
+    interface Window {
+        /** Set once the admin has hydrated. End-to-end tests wait for it before interacting. */
+        __PAYLOAD_ADMIN_HYDRATED__?: boolean;
+    }
+}
+/** Payload's `RootProviders`, bound to React Router. Rendered by `PayloadAdminLayout`. */
+export declare function PayloadRootProviders({ children, data, serverFunction }: PayloadRootProvidersProps): import("react/jsx-runtime").JSX.Element;

package/dist/client/PayloadRootProviders.js

@@ -0,0 +1,29 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { RootProviders } from '@payloadcms/ui';
+import React, { useCallback, useEffect } from 'react';
+import { ReactRouterAdapter } from "./RouterAdapter.js";
+/**
+ * React Router re-renders the current route after *every* server function
+ * call, unless the call carries a `FormData` with a `$SKIP_REVALIDATION` entry
+ * (`react-router/lib/rsc/server.rsc.ts`, `processServerAction`).
+ *
+ * Payload calls server functions constantly — `form-state` runs on every
+ * keystroke — and refreshes explicitly with `router.refresh()` when it needs
+ * fresh server output, the way Next's server actions behave. Without the
+ * opt-out each keystroke would re-render the whole admin page.
+ */
+function skipRevalidation() {
+    const formData = new FormData();
+    formData.set('$SKIP_REVALIDATION', '1');
+    return formData;
+}
+/** Payload's `RootProviders`, bound to React Router. Rendered by `PayloadAdminLayout`. */
+export function PayloadRootProviders({ children, data, serverFunction }) {
+    const callServerFunction = useCallback((args) => serverFunction(args, skipRevalidation()), [serverFunction]);
+    useEffect(() => {
+        window.__PAYLOAD_ADMIN_HYDRATED__ = true;
+    }, []);
+    return (_jsx(RootProviders, { data: data, RouterAdapter: ReactRouterAdapter, serverFunction: callServerFunction, children: children }));
+}
+//# sourceMappingURL=PayloadRootProviders.js.map

package/dist/client/PayloadRootProviders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PayloadRootProviders.js","sourceRoot":"","sources":["../../src/client/PayloadRootProviders.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AAMZ,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,KAAK,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAErD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAqB,CAAA;AAYxD;;;;;;;;;GASG;AACH,SAAS,gBAAgB;IACvB,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAA;IAC/B,QAAQ,CAAC,GAAG,CAAC,oBAAoB,EAAE,GAAG,CAAC,CAAA;IACvC,OAAO,QAAQ,CAAA;AACjB,CAAC;AAeD,0FAA0F;AAC1F,MAAM,UAAU,oBAAoB,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,EAA6B;IAChG,MAAM,kBAAkB,GAAG,WAAW,CACpC,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,gBAAgB,EAAE,CAAC,EAClD,CAAC,cAAc,CAAC,CACjB,CAAA;IAED,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,CAAC,0BAA0B,GAAG,IAAI,CAAA;IAC1C,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,OAAO,CACL,KAAC,aAAa,IAAC,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,kBAAkB,EAAE,cAAc,EAAE,kBAAkB,YAC7F,QAAQ,GACK,CACjB,CAAA;AACH,CAAC"}

package/dist/client/RouterAdapter.d.ts

@@ -0,0 +1,14 @@
+import type { RouterAdapterComponent } from 'payload';
+/**
+ * Payload's `RouterAdapter` contract implemented with React Router hooks.
+ *
+ * - `push` / `replace` → `useNavigate()`; `scroll: false` → `preventScrollReset`.
+ * - `back` → `navigate(-1)`.
+ * - `refresh` → `useRevalidator().revalidate()`, which in RSC mode re-renders the
+ *   matched server routes, like Next's `router.refresh()`.
+ * - `replaceState` → the History API directly: React Router does not observe
+ *   `history.replaceState`, so the URL changes without a server round trip
+ *   (the list view relies on that). TanStack needs a private flag for this.
+ * - While React Router navigates or revalidates, Payload's progress bar is held.
+ */
+export declare const ReactRouterAdapter: RouterAdapterComponent;

package/dist/client/RouterAdapter.js

@@ -0,0 +1,64 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { RouterAdapterContext, useRouteTransition } from '@payloadcms/ui';
+import React, { useCallback, useEffect, useMemo } from 'react';
+import { Link, useLocation, useNavigate, useNavigation, useParams, useRevalidator, } from 'react-router';
+import { normalizeNavigationTarget, toAdminParams } from "./navigation.js";
+const ReactRouterLink = ({ children, href, prefetch, ref, replace, scroll, ...rest }) => (_jsx(Link, { prefetch: prefetch === false ? 'none' : 'intent', preventScrollReset: scroll === false, ref: ref, replace: replace, to: href, ...rest, children: children }));
+const currentLocation = () => ({
+    origin: window.location.origin,
+    pathname: window.location.pathname,
+    search: window.location.search,
+});
+/**
+ * Payload's `RouterAdapter` contract implemented with React Router hooks.
+ *
+ * - `push` / `replace` → `useNavigate()`; `scroll: false` → `preventScrollReset`.
+ * - `back` → `navigate(-1)`.
+ * - `refresh` → `useRevalidator().revalidate()`, which in RSC mode re-renders the
+ *   matched server routes, like Next's `router.refresh()`.
+ * - `replaceState` → the History API directly: React Router does not observe
+ *   `history.replaceState`, so the URL changes without a server round trip
+ *   (the list view relies on that). TanStack needs a private flag for this.
+ * - While React Router navigates or revalidates, Payload's progress bar is held.
+ */
+export const ReactRouterAdapter = ({ children }) => {
+    const navigate = useNavigate();
+    const location = useLocation();
+    const params = useParams();
+    const navigation = useNavigation();
+    const revalidator = useRevalidator();
+    const { holdRouteTransition } = useRouteTransition();
+    const isBusy = navigation.state !== 'idle' || revalidator.state !== 'idle';
+    useEffect(() => (isBusy ? holdRouteTransition() : undefined), [holdRouteTransition, isBusy]);
+    const push = useCallback((path, options) => {
+        void navigate(normalizeNavigationTarget(path, currentLocation()), {
+            preventScrollReset: options?.scroll === false,
+        });
+    }, [navigate]);
+    const replace = useCallback((path, options) => {
+        void navigate(normalizeNavigationTarget(path, currentLocation()), {
+            preventScrollReset: options?.scroll === false,
+            replace: true,
+        });
+    }, [navigate]);
+    const back = useCallback(() => void navigate(-1), [navigate]);
+    const { revalidate } = revalidator;
+    const refresh = useCallback(() => void revalidate(), [revalidate]);
+    const replaceState = useCallback((url) => {
+        // Keep React Router's history entry state (key / index) intact.
+        window.history.replaceState(window.history.state, '', url);
+    }, []);
+    const router = useMemo(() => ({ back, push, refresh, replace, replaceState }), [back, push, refresh, replace, replaceState]);
+    const adaptedParams = useMemo(() => toAdminParams(params), [params]);
+    const searchParams = useMemo(() => new URLSearchParams(location.search), [location.search]);
+    const value = useMemo(() => ({
+        Link: ReactRouterLink,
+        params: adaptedParams,
+        pathname: location.pathname,
+        router,
+        searchParams,
+    }), [adaptedParams, location.pathname, router, searchParams]);
+    return _jsx(RouterAdapterContext, { value: value, children: children });
+};
+//# sourceMappingURL=RouterAdapter.js.map

package/dist/client/RouterAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouterAdapter.js","sourceRoot":"","sources":["../../src/client/RouterAdapter.tsx"],"names":[],"mappings":"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"}

package/dist/client/navigation.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Turns the targets Payload hands the router into an in-app path:
+ * same-origin absolute URLs, bare `?query` and bare `#hash`.
+ */
+export declare function normalizeNavigationTarget(target: string, current: {
+    origin: string;
+    pathname: string;
+    search: string;
+}): string;
+/** Maps `params['*']` of the `admin/*` splat onto Next's `segments` shape. */
+export declare function toAdminParams(params: Record<string, string | undefined>): Record<string, string | string[]>;

package/dist/client/navigation.js

@@ -0,0 +1,31 @@
+/**
+ * Turns the targets Payload hands the router into an in-app path:
+ * same-origin absolute URLs, bare `?query` and bare `#hash`.
+ */
+export function normalizeNavigationTarget(target, current) {
+    if (/^https?:\/\//.test(target)) {
+        const url = new URL(target);
+        return url.origin === current.origin ? `${url.pathname}${url.search}${url.hash}` : target;
+    }
+    if (target.startsWith('?')) {
+        return `${current.pathname}${target}`;
+    }
+    if (target.startsWith('#')) {
+        return `${current.pathname}${current.search}${target}`;
+    }
+    return target;
+}
+/** Maps `params['*']` of the `admin/*` splat onto Next's `segments` shape. */
+export function toAdminParams(params) {
+    const adapted = {};
+    for (const [key, value] of Object.entries(params)) {
+        if (value !== undefined) {
+            adapted[key] = value;
+        }
+    }
+    if (typeof params['*'] === 'string') {
+        adapted.segments = params['*'].split('/').filter(Boolean);
+    }
+    return adapted;
+}
+//# sourceMappingURL=navigation.js.map

package/dist/client/navigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.js","sourceRoot":"","sources":["../../src/client/navigation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAAc,EACd,OAA6D;IAE7D,IAAI,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAChC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAA;QAC3B,OAAO,GAAG,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAA;IAC3F,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,GAAG,OAAO,CAAC,QAAQ,GAAG,MAAM,EAAE,CAAA;IACvC,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,GAAG,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,EAAE,CAAA;IACxD,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,aAAa,CAC3B,MAA0C;IAE1C,MAAM,OAAO,GAAsC,EAAE,CAAA;IACrD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;QACtB,CAAC;IACH,CAAC;IACD,IAAI,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAC3D,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/exports/client.d.ts

@@ -0,0 +1,2 @@
+export { PayloadRootProviders, type PayloadRootProvidersProps, type PayloadServerFunction, } from '../client/PayloadRootProviders.tsx';
+export { ReactRouterAdapter } from '../client/RouterAdapter.tsx';

package/dist/exports/client.js

@@ -0,0 +1,3 @@
+export { PayloadRootProviders, } from "../client/PayloadRootProviders.js";
+export { ReactRouterAdapter } from "../client/RouterAdapter.js";
+//# sourceMappingURL=client.js.map

package/dist/exports/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/exports/client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,GAGrB,MAAM,mCAAoC,CAAA;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA6B,CAAA"}

package/dist/exports/server.d.ts

@@ -0,0 +1,10 @@
+export { AdminPage, type AdminPageData, type AdminPageMeta, loadAdminPage, type LoadAdminPageArgs } from '../server/adminPage.tsx';
+export { login, logout, refresh } from '../server/auth.ts';
+export { getRequestI18n, initAdminContext, type ReactRouterInitAdminContextArgs, } from '../server/initAdminContext.ts';
+export { PayloadAdminLayout, type PayloadAdminLayoutProps } from '../server/layout.tsx';
+export { payloadMiddleware } from '../server/middleware.ts';
+export { getRequest } from '../server/requestStore.ts';
+export { createAPIRoute, handleAPIRoute } from '../server/rest.ts';
+export { serializeCookie } from '../server/cookies.ts';
+export { createPageRenderServerAdapter, type PageNavIntent, reactRouterServerAdapter, } from '../server/serverAdapter.ts';
+export { handleServerFunctions } from '../server/serverFunctions.ts';

package/dist/exports/server.js

@@ -0,0 +1,11 @@
+export { AdminPage, loadAdminPage } from "../server/adminPage.js";
+export { login, logout, refresh } from "../server/auth.js";
+export { getRequestI18n, initAdminContext, } from "../server/initAdminContext.js";
+export { PayloadAdminLayout } from "../server/layout.js";
+export { payloadMiddleware } from "../server/middleware.js";
+export { getRequest } from "../server/requestStore.js";
+export { createAPIRoute, handleAPIRoute } from "../server/rest.js";
+export { serializeCookie } from "../server/cookies.js";
+export { createPageRenderServerAdapter, reactRouterServerAdapter, } from "../server/serverAdapter.js";
+export { handleServerFunctions } from "../server/serverFunctions.js";
+//# sourceMappingURL=server.js.map

package/dist/exports/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/exports/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAA0C,aAAa,EAA0B,MAAM,wBAAyB,CAAA;AAClI,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAC1D,OAAO,EACL,cAAc,EACd,gBAAgB,GAEjB,MAAM,+BAA+B,CAAA;AACtC,OAAO,EAAE,kBAAkB,EAAgC,MAAM,qBAAsB,CAAA;AACvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AACtD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EACL,6BAA6B,EAE7B,wBAAwB,GACzB,MAAM,4BAA4B,CAAA;AACnC,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA"}

package/dist/exports/vite.d.ts

@@ -0,0 +1 @@
+export { payload, type PayloadVitePluginOptions } from '../vite/index.ts';

package/dist/exports/vite.js

@@ -0,0 +1,2 @@
+export { payload } from "../vite/index.js";
+//# sourceMappingURL=vite.js.map

package/dist/exports/vite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.js","sourceRoot":"","sources":["../../src/exports/vite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAiC,MAAM,kBAAkB,CAAA"}

package/dist/server/adminPage.d.ts

@@ -0,0 +1,50 @@
+import type { ImportMap, SanitizedConfig } from 'payload';
+import type { ReactNode } from 'react';
+import { data } from 'react-router';
+export type LoadAdminPageArgs = {
+    config: Promise<SanitizedConfig> | SanitizedConfig;
+    importMap: ImportMap;
+    request: Request;
+    /** `params['*']` of the `admin/*` splat route: the path after `/admin/`. */
+    splat?: string;
+};
+export type AdminPageData = {
+    /** Plain-string page metadata, rendered as `<title>` / `<meta>` by {@link AdminPage}. */
+    meta: AdminPageMeta;
+    /** The rendered admin view, ready to be returned from a server component. */
+    page: ReactNode;
+};
+export type AdminPageMeta = {
+    description?: string;
+    title?: string;
+};
+/**
+ * Loads one admin page for the `admin/*` splat route. Call it from the route
+ * `loader` and render the result with {@link AdminPage}:
+ *
+ * ```tsx
+ * export const loader = ({ params, request }: Route.LoaderArgs) =>
+ *   loadAdminPage({ config, importMap, request, splat: params['*'] })
+ *
+ * export function ServerComponent({ loaderData }: Route.ComponentProps) {
+ *   return <AdminPage {...loaderData} />
+ * }
+ * ```
+ *
+ * Navigation becomes React Router primitives: a redirect is thrown as
+ * `redirect()`, and an unknown or forbidden page returns Payload's not-found
+ * view (with the admin chrome) under an HTTP 404.
+ */
+export declare function loadAdminPage({ config: configInput, importMap, request, splat, }: LoadAdminPageArgs): Promise<AdminPageData | ReturnType<typeof data<AdminPageData>>>;
+/**
+ * Renders a page loaded by {@link loadAdminPage}, with its `<title>` hoisted by React.
+ *
+ * `page` is typed `unknown` on purpose: React Router's generated route types
+ * describe loader data as if it were turbo-stream serialized, which mangles
+ * `ReactNode`. In RSC mode loader data travels as Flight, so the element arrives
+ * intact and can be passed straight through: `<AdminPage {...loaderData} />`.
+ */
+export declare function AdminPage({ meta, page }: {
+    meta: AdminPageMeta;
+    page: unknown;
+}): import("react/jsx-runtime").JSX.Element;