@prenta/admin 0.92.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Actuate Media
+
+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

@@ -0,0 +1,35 @@
+# @prenta/admin
+
+The React admin UI for [Prenta CMS](https://github.com/actuate-media/prenta):
+page/post section editors, media library, forms inbox, SEO tools, settings, and
+the setup wizard — mounted in your app via a single component.
+
+```bash
+npm install @prenta/admin
+```
+
+## Usage
+
+```tsx
+import { AdminRoot } from '@prenta/admin'
+import '@prenta/admin/styles'
+;<AdminRoot
+  basePath="/admin"
+  config={cmsConfig}
+  session={session}
+  // Optional: render custom section types in the editor canvas
+  sectionRenderers={{ 'my-custom-type': MyCanvasRenderer }}
+/>
+```
+
+All styles are scoped under `.prenta-admin` so they never leak into your
+site's CSS.
+
+## Release notes
+
+See [CHANGELOG.md](./CHANGELOG.md) (shipped with the package) or the
+[GitHub releases](https://github.com/actuate-media/prenta/releases).
+
+## License
+
+MIT

package/design-system/README.md

@@ -0,0 +1,53 @@
+# PrentaCMS Admin Design System
+
+Version **1.0** — canonical tokens for `@prenta/admin` and downstream consumer apps.
+
+## Token files (handoff)
+
+| File                           | Purpose                                                                |
+| ------------------------------ | ---------------------------------------------------------------------- |
+| `tokens.json`                  | W3C Design Tokens format — Style Dictionary / CI pipelines             |
+| `tokens.css`                   | CSS custom properties on `:root` + `[data-theme="dark"]`               |
+| `tokens.scss`                  | Sass maps + `acms-css-vars` mixin (runtime theming)                    |
+| `tokens.tailwind.cjs`          | Tailwind **v3** preset — `presets: [require('…/tokens.tailwind.cjs')]` |
+| `PrentaCMS Design System.html` | Browsable reference (keep with handoff zip; not published to npm)      |
+
+All exports default to **runtime theming** (CSS var references). Static hex fallbacks are documented in `tokens.tailwind.cjs` comments and `tokens.scss` maps.
+
+## How the admin package consumes tokens
+
+The published admin UI does **not** import `tokens.css` directly. It uses a scoped adapter:
+
+| Layer        | File                                | Role                                                         |
+| ------------ | ----------------------------------- | ------------------------------------------------------------ |
+| Raw tokens   | `src/styles/prenta-tokens.css`      | `--bg`, `--acc`, etc. under `.prenta-admin`                  |
+| Dark mode    | `.prenta-admin.dark` + `data-theme` | `ThemeProvider` sets both on the scoped admin root           |
+| Semantic map | `src/styles/theme.css`              | Tailwind v4 `@theme` aliases (`--primary`, `--sidebar-*`, …) |
+| Primitives   | `src/components/ui/*`               | Input, Card, Toggle aligned to HTML reference                |
+
+### Intentional differences from the handoff
+
+1. **Dark mode selector** — Handoff targets `[data-theme="dark"]` on `<html>`. Admin sets `data-theme` on `.prenta-admin` (scoped) and toggles `.dark` for Tailwind v4.
+2. **Default font** — Handoff `tokens.css` lists DM Sans. Admin defaults to **system-ui**; DM Sans remains selectable in Appearance.
+3. **Tailwind version** — Admin builds with **Tailwind v4** (`@theme inline` in `theme.css`). The `.cjs` preset targets Tailwind v3 consumer apps.
+
+## npm exports
+
+```ts
+import '@prenta/admin/design-system/tokens.css'
+// presets: [require('@prenta/admin/design-system/tokens.tailwind.cjs')]
+```
+
+## Governance (subagency review)
+
+When the design team or a subagency updates the system:
+
+1. Open `PrentaCMS Design System.html` from the handoff zip and spot-check components.
+2. Replace files in this folder from the handoff; diff `tokens.json` values against the previous version.
+3. Sync changed values into `src/styles/prenta-tokens.css` (scoped runtime copy).
+4. Update `src/styles/theme.css` semantic mappings if Tailwind aliases change.
+5. Update shared primitives (`Input`, `Card`, `Toggle`, …) when component specs change.
+6. Run `pnpm --filter @prenta/admin build:css` and verify light + dark admin chrome.
+7. Add a `@prenta/admin` changeset.
+
+Accent colors in **Appearance → Accent** map from `tokens.json` → `accentOptions` and `@prenta/core` (`appearance/theme-tokens.ts`).

package/design-system/tokens.css

@@ -0,0 +1,114 @@
+/* ============================================================
+   PrentaCMS — Design Tokens
+   Version 1.0 · Generated for developer handoff
+   ------------------------------------------------------------
+   Drop this file in and reference the CSS custom properties.
+   Light theme is the default (:root). Dark theme activates
+   via [data-theme="dark"] on the <html> element.
+   ============================================================ */
+
+:root {
+  /* ── Surfaces ─────────────────────────────────────────── */
+  --bg: #f5f4fa; /* app background            */
+  --sb: #ffffff; /* sidebar / topbar surface  */
+  --card: #ffffff; /* card / panel surface      */
+  --bdr: #e8e6f2; /* hairline border           */
+
+  /* ── Text ─────────────────────────────────────────────── */
+  --txt: #1a1827; /* primary text              */
+  --sub: #6b6878; /* secondary text            */
+  --muted: #b0adbe; /* tertiary / placeholder    */
+
+  /* ── Accent (brand purple) ────────────────────────────── */
+  --acc: #7c3aed; /* accent / interactive      */
+  --acc-l: #ede9fe; /* accent tint (hover/active)*/
+  --acc-m: #c4b5fd; /* accent mid (focus ring)   */
+
+  /* ── Semantic ─────────────────────────────────────────── */
+  --suc: #059669;
+  --suc-l: #ecfdf5; /* success */
+  --warn: #d97706;
+  --warn-l: #fffbeb; /* warning */
+  --err: #dc2626;
+  --err-l: #fef2f2; /* error   */
+  --info: #0891b2;
+  --info-l: #e0f7fa; /* info    */
+
+  /* ── AI gradient ──────────────────────────────────────── */
+  --ai1: #7c3aed;
+  --ai2: #c026d3;
+  --ai-soft: linear-gradient(135deg, rgba(124, 58, 237, 0.09), rgba(192, 38, 211, 0.07));
+
+  /* ── Dimensions ───────────────────────────────────────── */
+  --sbw: 224px; /* sidebar width (expanded)  */
+  --sbw-col: 60px; /* sidebar width (collapsed) */
+  --tbh: 56px; /* topbar height             */
+  --r: 10px; /* base radius (cards)       */
+  --r-control: 8px; /* buttons, inputs           */
+  --r-sm: 6px; /* badges, tags              */
+  --r-pill: 99px; /* toggles, progress         */
+
+  /* ── Motion ───────────────────────────────────────────── */
+  --motion-fast: 0.12s;
+  --motion-base: 0.18s;
+  --motion-layout: 0.22s cubic-bezier(0.4, 0, 0.2, 1);
+
+  /* ── Elevation ────────────────────────────────────────── */
+  --shd: 0 1px 2px rgba(0, 0, 0, 0.05), 0 1px 4px rgba(0, 0, 0, 0.04);
+  --shd2: 0 4px 16px rgba(0, 0, 0, 0.1);
+}
+
+[data-theme='dark'] {
+  /* ── Surfaces ─────────────────────────────────────────── */
+  --bg: #0d0c18;
+  --sb: #141222;
+  --card: #1c1a2e;
+  --bdr: #2c2a42;
+
+  /* ── Text ─────────────────────────────────────────────── */
+  --txt: #eae8f5;
+  --sub: #8e8ba8;
+  --muted: #504e68;
+
+  /* ── Accent ───────────────────────────────────────────── */
+  --acc: #9d71f0;
+  --acc-l: #231950;
+  --acc-m: #5e3eaa;
+
+  /* ── Semantic ─────────────────────────────────────────── */
+  --suc: #10b981;
+  --suc-l: #022c22;
+  --warn: #fbbf24;
+  --warn-l: #1a1000;
+  --err: #f87171;
+  --err-l: #200808;
+  --info: #38bdf8;
+  --info-l: #0a2838;
+
+  /* ── AI gradient ──────────────────────────────────────── */
+  --ai1: #7c3aed;
+  --ai2: #c026d3;
+  --ai-soft: linear-gradient(135deg, rgba(157, 113, 240, 0.16), rgba(192, 38, 211, 0.12));
+
+  /* ── Elevation ────────────────────────────────────────── */
+  --shd: 0 1px 2px rgba(0, 0, 0, 0.3), 0 1px 4px rgba(0, 0, 0, 0.2);
+  --shd2: 0 4px 20px rgba(0, 0, 0, 0.45);
+}
+
+/* ============================================================
+   Type — DM Sans (UI) + DM Mono (code / tokens)
+   Load via:
+   https://fonts.googleapis.com/css2?family=DM+Sans:opsz,wght@9..40,400;9..40,500;9..40,600;9..40,700&family=DM+Mono:wght@400;500&display=swap
+   ============================================================ */
+:root {
+  --font-sans: 'DM Sans', system-ui, -apple-system, sans-serif;
+  --font-mono: 'DM Mono', ui-monospace, 'SFMono-Regular', monospace;
+
+  /* Type scale (px) */
+  --fs-page: 21px; /* page title      · 700 · -0.5px */
+  --fs-card: 14px; /* card title      · 600          */
+  --fs-body: 13px; /* body / control  · 450          */
+  --fs-sub: 12px; /* secondary       · 500          */
+  --fs-hint: 11.5px; /* hint / meta     · 450          */
+  --fs-label: 10px; /* section label   · 600 · UPPER  */
+}

package/design-system/tokens.json

@@ -0,0 +1,149 @@
+{
+  "$schema": "https://design-tokens.github.io/community-group/format/",
+  "name": "PrentaCMS",
+  "version": "1.0.0",
+  "description": "Design tokens for the PrentaCMS admin interface. Two themes: light (default) and dark.",
+  "color": {
+    "light": {
+      "surface": {
+        "bg": { "value": "#F5F4FA", "comment": "App background" },
+        "sb": { "value": "#FFFFFF", "comment": "Sidebar / topbar surface" },
+        "card": { "value": "#FFFFFF", "comment": "Card / panel surface" },
+        "bdr": { "value": "#E8E6F2", "comment": "Hairline border" }
+      },
+      "text": {
+        "txt": { "value": "#1A1827", "comment": "Primary text" },
+        "sub": { "value": "#6B6878", "comment": "Secondary text" },
+        "muted": { "value": "#B0ADBE", "comment": "Tertiary / placeholder" }
+      },
+      "accent": {
+        "acc": { "value": "#7C3AED", "comment": "Accent / interactive" },
+        "acc-l": { "value": "#EDE9FE", "comment": "Accent tint (hover/active bg)" },
+        "acc-m": { "value": "#C4B5FD", "comment": "Accent mid (focus ring)" }
+      },
+      "semantic": {
+        "suc": { "value": "#059669" },
+        "suc-l": { "value": "#ECFDF5" },
+        "warn": { "value": "#D97706" },
+        "warn-l": { "value": "#FFFBEB" },
+        "err": { "value": "#DC2626" },
+        "err-l": { "value": "#FEF2F2" },
+        "info": { "value": "#0891B2" },
+        "info-l": { "value": "#E0F7FA" }
+      },
+      "ai": {
+        "ai1": { "value": "#7C3AED" },
+        "ai2": { "value": "#C026D3" }
+      }
+    },
+    "dark": {
+      "surface": {
+        "bg": { "value": "#0D0C18" },
+        "sb": { "value": "#141222" },
+        "card": { "value": "#1C1A2E" },
+        "bdr": { "value": "#2C2A42" }
+      },
+      "text": {
+        "txt": { "value": "#EAE8F5" },
+        "sub": { "value": "#8E8BA8" },
+        "muted": { "value": "#504E68" }
+      },
+      "accent": {
+        "acc": { "value": "#9D71F0" },
+        "acc-l": { "value": "#231950" },
+        "acc-m": { "value": "#5E3EAA" }
+      },
+      "semantic": {
+        "suc": { "value": "#10B981" },
+        "suc-l": { "value": "#022C22" },
+        "warn": { "value": "#FBBF24" },
+        "warn-l": { "value": "#1A1000" },
+        "err": { "value": "#F87171" },
+        "err-l": { "value": "#200808" },
+        "info": { "value": "#38BDF8" },
+        "info-l": { "value": "#0A2838" }
+      }
+    }
+  },
+  "accentOptions": {
+    "comment": "Selectable admin accent colors (Appearance settings). All swap into --acc.",
+    "purple": { "value": "#7C3AED" },
+    "blue": { "value": "#2563EB" },
+    "teal": { "value": "#0D9488" },
+    "pink": { "value": "#DB2777" },
+    "orange": { "value": "#EA580C" }
+  },
+  "font": {
+    "family": {
+      "sans": {
+        "value": "'DM Sans', system-ui, -apple-system, sans-serif",
+        "comment": "UI text"
+      },
+      "mono": {
+        "value": "'DM Mono', ui-monospace, monospace",
+        "comment": "Code, tokens, keys"
+      }
+    },
+    "size": {
+      "page": {
+        "value": "21px",
+        "weight": 700,
+        "letterSpacing": "-0.5px",
+        "comment": "Page title"
+      },
+      "card": {
+        "value": "14px",
+        "weight": 600,
+        "comment": "Card / section title"
+      },
+      "body": {
+        "value": "13px",
+        "weight": 450,
+        "comment": "Body, controls, table cells"
+      },
+      "sub": { "value": "12px", "weight": 500, "comment": "Secondary / captions" },
+      "hint": { "value": "11.5px", "weight": 450, "comment": "Hints, metadata" },
+      "label": {
+        "value": "10px",
+        "weight": 600,
+        "letterSpacing": "0.8px",
+        "textTransform": "uppercase",
+        "comment": "Section labels"
+      }
+    }
+  },
+  "dimension": {
+    "sidebarWidth": { "value": "224px" },
+    "sidebarWidthCollapsed": { "value": "60px" },
+    "topbarHeight": { "value": "56px" },
+    "radius": { "value": "10px", "comment": "Base card radius" },
+    "radiusControl": { "value": "8px", "comment": "Buttons, inputs" },
+    "radiusSmall": { "value": "6px", "comment": "Badges, tags" },
+    "radiusPill": { "value": "99px", "comment": "Toggles, progress bars" }
+  },
+  "elevation": {
+    "light": {
+      "shd": {
+        "value": "0 1px 2px rgba(0,0,0,.05), 0 1px 4px rgba(0,0,0,.04)",
+        "comment": "Card resting"
+      },
+      "shd2": {
+        "value": "0 4px 16px rgba(0,0,0,.1)",
+        "comment": "Popovers, modals, hover"
+      }
+    },
+    "dark": {
+      "shd": { "value": "0 1px 2px rgba(0,0,0,.3), 0 1px 4px rgba(0,0,0,.2)" },
+      "shd2": { "value": "0 4px 20px rgba(0,0,0,.45)" }
+    }
+  },
+  "motion": {
+    "fast": { "value": "0.12s", "comment": "Hover / color transitions" },
+    "base": { "value": "0.18s", "comment": "Toggles, modal-in" },
+    "layout": {
+      "value": "0.22s",
+      "easing": "cubic-bezier(.4,0,.2,1)",
+      "comment": "Sidebar collapse"
+    }
+  }
+}

package/design-system/tokens.scss

@@ -0,0 +1,108 @@
+// ============================================================
+// PrentaCMS — SCSS Design Tokens
+// Version 1.0 · Developer handoff
+// ------------------------------------------------------------
+// Two ways to consume:
+//   1. Use the Sass maps + $acms-css-vars mixin to emit the same
+//      CSS custom properties as tokens.css (recommended — keeps
+//      runtime theming via [data-theme]).
+//   2. Reference the raw $acms-* Sass variables directly at
+//      build time if you don't need runtime theme switching.
+// ============================================================
+
+// ── Type ─────────────────────────────────────────────────────
+$acms-font-sans: ('DM Sans', system-ui, -apple-system, sans-serif);
+$acms-font-mono: ('DM Mono', ui-monospace, 'SFMono-Regular', monospace);
+
+// Type scale (name: (size, weight, letter-spacing))
+$acms-type: (
+  page: (21px, 700, -0.5px),
+  card: (14px, 600, 0),
+  body: (13px, 450, 0),
+  sub: (12px, 500, 0),
+  hint: (11.5px, 450, 0),
+  label: (10px, 600, 0.8px),
+);
+
+// ── Dimensions ───────────────────────────────────────────────
+$acms-sidebar-width: 224px;
+$acms-sidebar-width-collapsed: 60px;
+$acms-topbar-height: 56px;
+$acms-radius: 10px; // cards
+$acms-radius-control: 8px; // buttons, inputs
+$acms-radius-small: 6px; // badges, tags
+$acms-radius-pill: 99px; // toggles, progress
+
+// ── Motion ───────────────────────────────────────────────────
+$acms-motion-fast: 0.12s;
+$acms-motion-base: 0.18s;
+$acms-motion-layout: 0.22s;
+$acms-ease-layout: cubic-bezier(0.4, 0, 0.2, 1);
+
+// ── Accent options (Appearance setting) ──────────────────────
+$acms-accents: (
+  purple: #7c3aed,
+  // default
+  blue: #2563eb,
+  teal: #0d9488,
+  pink: #db2777,
+  orange: #ea580c,
+);
+
+// ── Theme maps ───────────────────────────────────────────────
+$acms-light: (
+  bg: #f5f4fa,
+  sb: #ffffff,
+  card: #ffffff,
+  bdr: #e8e6f2,
+  txt: #1a1827,
+  sub: #6b6878,
+  muted: #b0adbe,
+  acc: #7c3aed,
+  acc-l: #ede9fe,
+  acc-m: #c4b5fd,
+  suc: #059669,
+  suc-l: #ecfdf5,
+  warn: #d97706,
+  warn-l: #fffbeb,
+  err: #dc2626,
+  err-l: #fef2f2,
+  info: #0891b2,
+  info-l: #e0f7fa,
+  ai1: #7c3aed,
+  ai2: #c026d3,
+  shd: (0 1px 2px rgba(0, 0, 0, 0.05), 0 1px 4px rgba(0, 0, 0, 0.04)),
+  shd2: (0 4px 16px rgba(0, 0, 0, 0.1)),
+);
+
+$acms-dark: (
+  bg: #0d0c18,
+  sb: #141222,
+  card: #1c1a2e,
+  bdr: #2c2a42,
+  txt: #eae8f5,
+  sub: #8e8ba8,
+  muted: #504e68,
+  acc: #9d71f0,
+  acc-l: #231950,
+  acc-m: #5e3eaa,
+  suc: #10b981,
+  suc-l: #022c22,
+  warn: #fbbf24,
+  warn-l: #1a1000,
+  err: #f87171,
+  err-l: #200808,
+  info: #38bdf8,
+  info-l: #0a2838,
+  ai1: #7c3aed,
+  ai2: #c026d3,
+  shd: (0 1px 2px rgba(0, 0, 0, 0.3), 0 1px 4px rgba(0, 0, 0, 0.2)),
+  shd2: (0 4px 20px rgba(0, 0, 0, 0.45)),
+);
+
+// Emit a theme map as CSS custom properties (--name).
+@mixin acms-css-vars($theme) {
+  @each $name, $value in $theme {
+    --#{$name}: #{$value};
+  }
+}

package/design-system/tokens.tailwind.cjs

@@ -0,0 +1,80 @@
+/**
+ * PrentaCMS — Tailwind token preset (CommonJS for tailwind.config.js)
+ * Version 1.0 · Developer handoff
+ *
+ * Runtime theming: include tokens.css, then preset colors resolve via CSS vars.
+ * Dark mode: `darkMode: ['selector', '[data-theme="dark"]']` on `<html>`.
+ *
+ * Admin note: `@prenta/admin` uses Tailwind v4 + scoped `.prenta-admin.dark`
+ * instead of `[data-theme]` — see design-system/README.md.
+ */
+
+const v =
+  (name) =>
+  ({ opacityValue } = {}) =>
+    opacityValue === undefined
+      ? `var(${name})`
+      : `color-mix(in srgb, var(${name}) ${opacityValue * 100}%, transparent)`
+
+/** @type {import('tailwindcss').Config} */
+module.exports = {
+  darkMode: ['selector', '[data-theme="dark"]'],
+  theme: {
+    extend: {
+      colors: {
+        bg: v('--bg'),
+        sb: v('--sb'),
+        card: v('--card'),
+        bdr: v('--bdr'),
+        txt: v('--txt'),
+        sub: v('--sub'),
+        muted: v('--muted'),
+        acc: { DEFAULT: v('--acc'), light: v('--acc-l'), mid: v('--acc-m') },
+        suc: { DEFAULT: v('--suc'), light: v('--suc-l') },
+        warn: { DEFAULT: v('--warn'), light: v('--warn-l') },
+        err: { DEFAULT: v('--err'), light: v('--err-l') },
+        info: { DEFAULT: v('--info'), light: v('--info-l') },
+        ai1: v('--ai1'),
+        ai2: v('--ai2'),
+      },
+      fontFamily: {
+        sans: ['DM Sans', 'system-ui', '-apple-system', 'sans-serif'],
+        mono: ['DM Mono', 'ui-monospace', 'monospace'],
+      },
+      fontSize: {
+        page: ['21px', { letterSpacing: '-0.5px', fontWeight: '700' }],
+        card: ['14px', { fontWeight: '600' }],
+        body: ['13px', { fontWeight: '450' }],
+        sub: ['12px', { fontWeight: '500' }],
+        hint: ['11.5px', { fontWeight: '450' }],
+        label: ['10px', { letterSpacing: '0.8px', fontWeight: '600' }],
+      },
+      borderRadius: {
+        DEFAULT: '10px',
+        control: '8px',
+        badge: '6px',
+        pill: '99px',
+      },
+      boxShadow: {
+        card: 'var(--shd)',
+        pop: 'var(--shd2)',
+      },
+      width: { sidebar: '224px', 'sidebar-col': '60px' },
+      height: { topbar: '56px' },
+      spacing: { topbar: '56px', sidebar: '224px' },
+      transitionTimingFunction: {
+        layout: 'cubic-bezier(.4, 0, .2, 1)',
+      },
+      transitionDuration: {
+        fast: '120ms',
+        base: '180ms',
+        layout: '220ms',
+      },
+      backgroundImage: {
+        ai: 'linear-gradient(135deg, var(--ai1), var(--ai2))',
+        'ai-soft': 'var(--ai-soft)',
+      },
+    },
+  },
+  plugins: [],
+}

package/dist/AdminRoot.d.ts

@@ -0,0 +1,60 @@
+import { type AdminSectionRendererMap } from './views/page-editor/sections/index.js';
+export interface AdminRootProps {
+    config: any;
+    session: any;
+    basePath?: string;
+    initialPath?: string;
+    /**
+     * Split-login mode: the URL path where the unauthenticated auth screens
+     * (login, setup wizard, forgot/reset password) are mounted via `LoginRoot`,
+     * e.g. `/securelogin`. When set (and different from `basePath`), signed-out
+     * visitors to the admin mount see a 404 lookalike instead of a login form —
+     * the admin's existence isn't advertised at the well-known `/admin` path.
+     * Keep in sync with `config.admin.loginPath` so middleware guards and
+     * emailed reset/invite links agree on the location.
+     */
+    loginPath?: string;
+    setupRequired?: boolean;
+    onSetupComplete?: (data: {
+        name: string;
+        email: string;
+        password: string;
+    }) => Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    onLogin?: (email: string, password: string, captchaToken?: string) => Promise<{
+        success: boolean;
+        error?: string;
+        requiresTOTP?: boolean;
+        mfaPendingToken?: string;
+    }>;
+    /** Completes the TOTP second-factor step for accounts with MFA enabled. */
+    onVerifyTotp?: (mfaPendingToken: string, code: string) => Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * Clears the consumer-held session (e.g. `setSession(null)`) after the admin
+     * has revoked the server-side session. Server revocation + cookie clearing is
+     * handled inside the admin, so consumers only need to reset their local state.
+     */
+    onLogout?: () => void | Promise<void>;
+    captchaConfig?: {
+        provider: 'recaptcha' | 'turnstile' | 'none';
+        siteKey: string | null;
+    };
+    /**
+     * Canvas renderers for custom section types, keyed by section-type id.
+     * When provided, the page/post editor canvas and the eye preview render
+     * these instead of the structural placeholder. The signature mirrors
+     * `SectionRenderer` from `@prenta/sections-react`, so you can pass
+     * the same components you register for the public site (as long as they
+     * are client-safe).
+     */
+    sectionRenderers?: AdminSectionRendererMap;
+    /** Browser Sentry DSN for admin error reporting (e.g. `NEXT_PUBLIC_SENTRY_DSN`). */
+    sentryDsn?: string;
+}
+export declare function AdminRoot(props: AdminRootProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=AdminRoot.d.ts.map

package/dist/AdminRoot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdminRoot.d.ts","sourceRoot":"","sources":["../src/AdminRoot.tsx"],"names":[],"mappings":"AA8CA,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,uCAAuC,CAAA;AAe9C,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,GAAG,CAAA;IACX,OAAO,EAAE,GAAG,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE;QACvB,IAAI,EAAE,MAAM,CAAA;QACZ,KAAK,EAAE,MAAM,CAAA;QACb,QAAQ,EAAE,MAAM,CAAA;KACjB,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACnD,OAAO,CAAC,EAAE,CACR,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM,KAClB,OAAO,CAAC;QACX,OAAO,EAAE,OAAO,CAAA;QAChB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,YAAY,CAAC,EAAE,OAAO,CAAA;QACtB,eAAe,CAAC,EAAE,MAAM,CAAA;KACzB,CAAC,CAAA;IACF,2EAA2E;IAC3E,YAAY,CAAC,EAAE,CACb,eAAe,EAAE,MAAM,EACvB,IAAI,EAAE,MAAM,KACT,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAClD;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,aAAa,CAAC,EAAE;QAAE,QAAQ,EAAE,WAAW,GAAG,WAAW,GAAG,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAA;IACxF;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE,uBAAuB,CAAA;IAC1C,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAyyBD,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,2CAoB9C"}