convex-cms 0.0.11-alpha.4 → 0.0.16-alpha.0

package/README.md

@@ -3,7 +3,7 @@
 [![npm version](https://badge.fury.io/js/convex-cms.svg)](https://www.npmjs.com/package/convex-cms)
 [![License: Apache-2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
 
-> **Alpha (v0.0.10)** Actively developed. APIs & docs may change. [Report issues](https://github.com/obkaro/convex-cms/issues).
+> **Alpha** Actively developed. APIs & docs may change. [Report issues](https://github.com/obkaro/convex-cms/issues).
 
 A headless CMS built as a [Convex Component](https://docs.convex.dev/components). Content management that runs inside your Convex app.
 
@@ -113,6 +113,12 @@ Leverage included features or extend and customize within your own convex functi
 - **Content locking.** Prevent concurrent edit conflicts
 - **Soft delete & trash.** Configurable retention with restore
 
+### User Management
+- **Built-in Users page.** List, invite, and manage CMS users from the admin UI
+- **Auto-registration.** Users are registered automatically on first CMS access
+- **First-user bootstrap.** First user gets admin role — no CLI setup needed
+- **Custom roles.** Define app-specific roles (e.g., "kitchen") alongside built-in ones
+
 ### Integration
 - **RBAC.** 4 built-in roles + custom roles with fine-grained permissions
 - **Multi-locale.** Content localization with fallback chains
@@ -128,7 +134,7 @@ Leverage included features or extend and customize within your own convex functi
 - **Pre-built React interface.** CLI mode for development, embeddable for production
 - **Visual content editing.** Rich text, media picker, reference selector
 
-## Admin UI Modes
+## Admin UI
 
 | Mode | Command | Best For |
 |------|---------|----------|
@@ -137,30 +143,23 @@ Leverage included features or extend and customize within your own convex functi
 
 Both modes call the same functions from your `convex/admin.ts`.
 
-### Embedding with Theme Modes
+### Embedding
 
-When embedding CmsAdmin in your React app, you can control how it handles CSS variables:
+Two requirements for the embed to render correctly:
 
-```tsx
-// Isolated mode (default) - admin uses its own theme
-<CmsAdmin api={api.admin} auth={authConfig} themeMode="isolated" />
+**1. Tailwind source scanning** — the admin ships as `.tsx` source. Tailwind v4 doesn't scan `node_modules`, so add this to your CSS:
 
-// Inherit mode - admin inherits your app's CSS variables (for shadcn apps)
-<CmsAdmin api={api.admin} auth={authConfig} themeMode="inherit" />
+```css
+@source "../node_modules/convex-cms/admin/src/**/*.{ts,tsx}";
 ```
 
-| Mode | Behavior |
-|------|----------|
-| `isolated` | Admin defines all CSS variables, ignoring parent app styles |
-| `inherit` | Admin inherits parent's shadcn variables, only defines sidebar fallbacks |
+**2. Explicit height** — pass `className="h-screen"` (or calculated height if you have a header):
 
-```css
-/* your-app/src/index.css */
-@import "tailwindcss";
-@source "../node_modules/convex-cms/admin/dist/**/*.js";
+```tsx
+<CmsAdmin api={api.admin} auth={authConfig} className="h-screen" />
 ```
 
-This tells Tailwind to scan the admin's compiled JavaScript for utility classes.
+→ [Full embed setup with auth examples](./docs/guides/admin-ui-setup.md)
 
 
 
@@ -193,8 +192,9 @@ This tells Tailwind to scan the admin's compiled JavaScript for utility classes.
 
 ## Requirements
 
-- Convex ^1.17.0
+- Convex ^1.34.0
 - Node.js 18+
+- Tailwind CSS v4 (for embedded admin UI)
 
 
 

package/admin/README.md

@@ -0,0 +1,99 @@
+# Convex CMS Admin UI
+
+The Admin UI for Convex CMS, built with TanStack Start and React.
+
+## Getting Started
+
+### Prerequisites
+
+- Node.js 18+
+- A Convex account and project
+
+### Installation
+
+```bash
+cd admin
+pnpm install
+```
+
+### Development
+
+1. Start the Convex development server:
+
+```bash
+pnpm convex dev
+```
+
+This will generate the Convex API types and provide a `VITE_CONVEX_URL`.
+
+2. Create a `.env` file with your Convex URL:
+
+```bash
+cp .env.example .env
+# Edit .env with your VITE_CONVEX_URL from step 1
+```
+
+3. Start the development server:
+
+```bash
+pnpm dev:vite
+```
+
+Or run both Convex and Vite together:
+
+```bash
+pnpm dev
+```
+
+4. Open [http://localhost:3000](http://localhost:3000) in your browser.
+
+## Project Structure
+
+```
+admin/
+├── convex/                 # Convex configuration
+│   └── convex.config.ts    # CMS component integration
+├── src/
+│   ├── routes/             # TanStack Router routes
+│   │   ├── __root.tsx      # Root layout with Convex provider
+│   │   ├── index.tsx       # Dashboard page
+│   │   ├── content.tsx     # Content entries list
+│   │   ├── media.tsx       # Media library
+│   │   ├── content-types.tsx # Content type management
+│   │   └── settings.tsx    # CMS settings
+│   ├── components/         # Reusable React components
+│   ├── lib/                # Utilities and helpers
+│   │   └── convex.ts       # Convex client utilities
+│   ├── styles/             # CSS styles
+│   │   └── app.css         # Main stylesheet
+│   └── router.tsx          # Router configuration
+├── public/                 # Static assets
+├── vite.config.ts          # Vite + TanStack Start configuration
+├── tsconfig.json           # TypeScript configuration
+└── package.json            # Dependencies and scripts
+```
+
+## Available Scripts
+
+- `pnpm dev` - Start Convex and Vite development servers
+- `pnpm dev:vite` - Start only the Vite development server
+- `pnpm dev:convex` - Start only the Convex development server
+- `pnpm build` - Build for production
+- `pnpm preview` - Preview production build
+- `pnpm typecheck` - Run TypeScript type checking
+
+## Features
+
+- **Dashboard** - Overview of CMS status and quick navigation
+- **Content Management** - Browse and manage content entries
+- **Media Library** - Upload and organize media assets
+- **Content Types** - Define content schemas with custom fields
+- **Settings** - Configure CMS features and preferences
+
+## Technology Stack
+
+- [TanStack Start](https://tanstack.com/start) - Full-stack React framework
+- [TanStack Router](https://tanstack.com/router) - Type-safe routing
+- [Convex](https://convex.dev) - Real-time backend platform
+- [React 19](https://react.dev) - UI library
+- [Vite 7](https://vitejs.dev) - Build tool

package/admin/dist/types/admin/src/components/AdminLayout.d.ts

@@ -0,0 +1,7 @@
+import type { ReactNode } from "react";
+interface AdminLayoutProps {
+    children: ReactNode;
+}
+export declare function AdminLayout({ children }: AdminLayoutProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=AdminLayout.d.ts.map

package/admin/dist/types/admin/src/components/AdminLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdminLayout.d.ts","sourceRoot":"","sources":["../../../../../src/components/AdminLayout.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAMvC,UAAU,gBAAgB;IACxB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,wBAAgB,WAAW,CAAC,EAAE,QAAQ,EAAE,EAAE,gBAAgB,2CAmBzD"}

package/admin/dist/types/admin/src/components/BreakingChangesWarningDialog.d.ts

@@ -0,0 +1,11 @@
+interface BreakingChangesWarningDialogProps {
+    isOpen: boolean;
+    onClose: () => void;
+    breakingChanges: string[];
+    onForceUpdate: () => void;
+    onCancel: () => void;
+    isLoading: boolean;
+}
+export declare function BreakingChangesWarningDialog({ isOpen, onClose, breakingChanges, onForceUpdate, onCancel, isLoading, }: BreakingChangesWarningDialogProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=BreakingChangesWarningDialog.d.ts.map

package/admin/dist/types/admin/src/components/BreakingChangesWarningDialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BreakingChangesWarningDialog.d.ts","sourceRoot":"","sources":["../../../../../src/components/BreakingChangesWarningDialog.tsx"],"names":[],"mappings":"AAIA,UAAU,iCAAiC;IACzC,MAAM,EAAE,OAAO,CAAA;IACf,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,aAAa,EAAE,MAAM,IAAI,CAAA;IACzB,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,SAAS,EAAE,OAAO,CAAA;CACnB;AAED,wBAAgB,4BAA4B,CAAC,EAC3C,MAAM,EACN,OAAO,EACP,eAAe,EACf,aAAa,EACb,QAAQ,EACR,SAAS,GACV,EAAE,iCAAiC,2CA4DnC"}

package/admin/dist/types/admin/src/components/BulkActionBar.d.ts

@@ -0,0 +1,8 @@
+interface BulkActionBarProps {
+    selectedIds: string[];
+    onClearSelection: () => void;
+    onOperationComplete?: () => void;
+}
+export declare function BulkActionBar({ selectedIds, onClearSelection, onOperationComplete, }: BulkActionBarProps): import("react/jsx-runtime").JSX.Element | null;
+export {};
+//# sourceMappingURL=BulkActionBar.d.ts.map

package/admin/dist/types/admin/src/components/BulkActionBar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BulkActionBar.d.ts","sourceRoot":"","sources":["../../../../../src/components/BulkActionBar.tsx"],"names":[],"mappings":"AAUA,UAAU,kBAAkB;IAC1B,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,gBAAgB,EAAE,MAAM,IAAI,CAAA;IAC5B,mBAAmB,CAAC,EAAE,MAAM,IAAI,CAAA;CACjC;AAED,wBAAgB,aAAa,CAAC,EAC5B,WAAW,EACX,gBAAgB,EAChB,mBAAmB,GACpB,EAAE,kBAAkB,kDA0KpB"}

package/admin/dist/types/admin/src/components/BulkOperationModal.d.ts

@@ -0,0 +1,16 @@
+type BulkAction = 'publish' | 'unpublish' | 'delete' | 'archive';
+interface BulkOperationModalProps {
+    action: BulkAction;
+    count: number;
+    isProcessing: boolean;
+    result: {
+        succeeded: number;
+        failed: number;
+        errors?: string[];
+    } | null;
+    onConfirm: () => void;
+    onCancel: () => void;
+}
+export declare function BulkOperationModal({ action, count, isProcessing, result, onConfirm, onCancel, }: BulkOperationModalProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=BulkOperationModal.d.ts.map

package/admin/dist/types/admin/src/components/BulkOperationModal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BulkOperationModal.d.ts","sourceRoot":"","sources":["../../../../../src/components/BulkOperationModal.tsx"],"names":[],"mappings":"AAKA,KAAK,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAA;AAEhE,UAAU,uBAAuB;IAC/B,MAAM,EAAE,UAAU,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,EAAE,OAAO,CAAA;IACrB,MAAM,EAAE;QACN,SAAS,EAAE,MAAM,CAAA;QACjB,MAAM,EAAE,MAAM,CAAA;QACd,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAClB,GAAG,IAAI,CAAA;IACR,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,QAAQ,EAAE,MAAM,IAAI,CAAA;CACrB;AAyCD,wBAAgB,kBAAkB,CAAC,EACjC,MAAM,EACN,KAAK,EACL,YAAY,EACZ,MAAM,EACN,SAAS,EACT,QAAQ,GACT,EAAE,uBAAuB,2CA8GzB"}

package/admin/dist/types/admin/src/components/ContentEntryEditor.d.ts

@@ -0,0 +1,42 @@
+import type { FieldDefinition } from './fields/types';
+export interface ContentType {
+    _id: string;
+    name: string;
+    displayName: string;
+    description?: string;
+    fields: FieldDefinition[];
+    titleField?: string;
+    slugField?: string;
+    singleton?: boolean;
+    isActive: boolean;
+}
+export interface ContentEntry {
+    _id: string;
+    contentTypeName: string;
+    slug: string;
+    status: 'draft' | 'published' | 'scheduled' | 'archived';
+    data: Record<string, unknown>;
+    version: number;
+    scheduledPublishAt?: number;
+    firstPublishedAt?: number;
+    lastPublishedAt?: number;
+}
+interface ContentEntryEditorProps {
+    contentType: ContentType;
+    entry?: ContentEntry;
+    onSave?: (entry: ContentEntry) => void;
+    onCancel?: () => void;
+    onDelete?: () => void;
+    onNavigateToEntry?: (entryId: string) => void;
+    onNavigateToNewEntry?: () => void;
+    siblingEntries?: Array<{
+        _id: string;
+        title: string;
+    }>;
+    autosaveEnabled?: boolean;
+    autosaveInterval?: number;
+    canDelete?: boolean;
+}
+export declare function ContentEntryEditor({ contentType, entry, onSave, onCancel, onDelete, onNavigateToEntry, onNavigateToNewEntry, siblingEntries, autosaveEnabled, autosaveInterval, canDelete: canDeleteProp, }: ContentEntryEditorProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=ContentEntryEditor.d.ts.map

package/admin/dist/types/admin/src/components/ContentEntryEditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentEntryEditor.d.ts","sourceRoot":"","sources":["../../../../../src/components/ContentEntryEditor.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAc,MAAM,gBAAgB,CAAA;AAwFjE,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,eAAe,EAAE,CAAA;IACzB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,eAAe,EAAE,MAAM,CAAA;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,OAAO,GAAG,WAAW,GAAG,WAAW,GAAG,UAAU,CAAA;IACxD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,UAAU,uBAAuB;IAC/B,WAAW,EAAE,WAAW,CAAA;IACxB,KAAK,CAAC,EAAE,YAAY,CAAA;IACpB,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAA;IACtC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IACrB,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAC7C,oBAAoB,CAAC,EAAE,MAAM,IAAI,CAAA;IACjC,cAAc,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACtD,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAID,wBAAgB,kBAAkB,CAAC,EACjC,WAAW,EACX,KAAK,EACL,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,eAAsB,EACtB,gBAAwB,EACxB,SAAS,EAAE,aAAqB,GACjC,EAAE,uBAAuB,2CAonBzB"}

package/admin/dist/types/admin/src/components/ContentTypeFormModal.d.ts

@@ -0,0 +1,13 @@
+import type { ContentType } from "../lib/cmsExports";
+interface ContentTypeFormModalProps {
+    isOpen: boolean;
+    onClose: () => void;
+    onCreated?: (contentType: unknown) => void;
+    onUpdated?: (contentType: unknown) => void;
+    contentType?: (ContentType & {
+        source?: "code" | "database";
+    }) | null;
+}
+export declare function ContentTypeFormModal({ isOpen, onClose, onCreated, onUpdated, contentType, }: ContentTypeFormModalProps): import("react/jsx-runtime").JSX.Element | null;
+export {};
+//# sourceMappingURL=ContentTypeFormModal.d.ts.map

package/admin/dist/types/admin/src/components/ContentTypeFormModal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentTypeFormModal.d.ts","sourceRoot":"","sources":["../../../../../src/components/ContentTypeFormModal.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAa,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAiJhE,UAAU,yBAAyB;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,SAAS,CAAC,EAAE,CAAC,WAAW,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3C,SAAS,CAAC,EAAE,CAAC,WAAW,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3C,WAAW,CAAC,EAAE,CAAC,WAAW,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,CAAA;KAAE,CAAC,GAAG,IAAI,CAAC;CACtE;AAgBD,wBAAgB,oBAAoB,CAAC,EACpC,MAAM,EACN,OAAO,EACP,SAAS,EACT,SAAS,EACT,WAAW,GACX,EAAE,yBAAyB,kDAiyB3B"}

package/admin/dist/types/admin/src/components/ErrorBoundary.d.ts

@@ -0,0 +1,35 @@
+import { Component, type ReactNode, type ErrorInfo } from 'react';
+interface ErrorBoundaryProps {
+    /** Child components to render */
+    children: ReactNode;
+    /** Optional fallback UI to render on error */
+    fallback?: ReactNode;
+    /** Optional callback when an error is caught */
+    onError?: (error: Error, errorInfo: ErrorInfo) => void;
+    /** Optional title for the error state */
+    title?: string;
+}
+interface ErrorBoundaryState {
+    hasError: boolean;
+    error: Error | null;
+}
+/**
+ * ErrorBoundary catches JavaScript errors in child component trees
+ * and displays a fallback UI instead of crashing the whole app.
+ *
+ * Usage:
+ * ```tsx
+ * <ErrorBoundary fallback={<div>Something went wrong</div>}>
+ *   <MyComponent />
+ * </ErrorBoundary>
+ * ```
+ */
+export declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
+    constructor(props: ErrorBoundaryProps);
+    static getDerivedStateFromError(error: Error): ErrorBoundaryState;
+    componentDidCatch(error: Error, errorInfo: ErrorInfo): void;
+    handleRetry: () => void;
+    render(): ReactNode;
+}
+export {};
+//# sourceMappingURL=ErrorBoundary.d.ts.map

package/admin/dist/types/admin/src/components/ErrorBoundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorBoundary.d.ts","sourceRoot":"","sources":["../../../../../src/components/ErrorBoundary.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAElE,UAAU,kBAAkB;IAC1B,iCAAiC;IACjC,QAAQ,EAAE,SAAS,CAAC;IACpB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,gDAAgD;IAChD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;IACvD,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,aAAc,SAAQ,SAAS,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;gBACtE,KAAK,EAAE,kBAAkB;IAKrC,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,kBAAkB;IAIjE,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI;IAK3D,WAAW,QAAO,IAAI,CAEpB;IAEF,MAAM,IAAI,SAAS;CAkCpB"}

package/admin/dist/types/admin/src/components/ErrorState.d.ts

@@ -0,0 +1,52 @@
+import type { ReactNode } from 'react';
+interface ErrorStateProps {
+    /** The error to display */
+    error: Error | string | null | undefined;
+    /** Optional title for the error (defaults to "Something went wrong") */
+    title?: string;
+    /** Optional retry handler - shows a retry button when provided */
+    onRetry?: () => void;
+    /** Whether a retry is currently in progress */
+    isRetrying?: boolean;
+    /** Optional custom icon */
+    icon?: ReactNode;
+    /** Optional additional CSS class */
+    className?: string;
+}
+/**
+ * ErrorState displays a full-page or section error state with
+ * an icon, message, and optional retry button.
+ *
+ * Usage:
+ * ```tsx
+ * if (error) {
+ *   return <ErrorState error={error} onRetry={() => refetch()} />
+ * }
+ * ```
+ */
+export declare function ErrorState({ error, title, onRetry, isRetrying, icon, className, }: ErrorStateProps): import("react/jsx-runtime").JSX.Element;
+interface ErrorAlertProps {
+    /** The error to display */
+    error: Error | string | null | undefined;
+    /** Optional dismiss handler - shows a dismiss button when provided */
+    onDismiss?: () => void;
+    /** Optional retry handler - shows a retry button when provided */
+    onRetry?: () => void;
+    /** Whether a retry is currently in progress */
+    isRetrying?: boolean;
+    /** Variant of the alert (default: 'error') */
+    variant?: 'error' | 'warning';
+    /** Optional additional CSS class */
+    className?: string;
+}
+/**
+ * ErrorAlert displays an inline error alert with optional dismiss/retry actions.
+ *
+ * Usage:
+ * ```tsx
+ * {error && <ErrorAlert error={error} onDismiss={() => setError(null)} />}
+ * ```
+ */
+export declare function ErrorAlert({ error, onDismiss, onRetry, isRetrying, variant, className, }: ErrorAlertProps): import("react/jsx-runtime").JSX.Element | null;
+export {};
+//# sourceMappingURL=ErrorState.d.ts.map

package/admin/dist/types/admin/src/components/ErrorState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorState.d.ts","sourceRoot":"","sources":["../../../../../src/components/ErrorState.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,UAAU,eAAe;IACvB,2BAA2B;IAC3B,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACzC,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,2BAA2B;IAC3B,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,KAA8B,EAC9B,OAAO,EACP,UAAkB,EAClB,IAAI,EACJ,SAAc,GACf,EAAE,eAAe,2CA6BjB;AAED,UAAU,eAAe;IACvB,2BAA2B;IAC3B,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACzC,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,oCAAoC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,SAAS,EACT,OAAO,EACP,UAAkB,EAClB,OAAiB,EACjB,SAAc,GACf,EAAE,eAAe,kDAkDjB"}

package/admin/dist/types/admin/src/components/FieldGroupSection.d.ts

@@ -0,0 +1,23 @@
+import type { FieldDefinition, FieldError } from './fields/types';
+export interface FieldGroup {
+    name: string;
+    label: string;
+    fields: FieldDefinition[];
+}
+interface FieldGroupSectionProps {
+    group: FieldGroup;
+    formData: Record<string, unknown>;
+    fieldErrors: Record<string, FieldError | undefined>;
+    isSubmitting: boolean;
+    onFieldChange: (fieldName: string, value: unknown) => void;
+    initialOpen?: boolean;
+}
+export declare function FieldGroupSection({ group, formData, fieldErrors, isSubmitting, onFieldChange, initialOpen, }: FieldGroupSectionProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Groups fields by their `group` property.
+ * Fields without a group go into a "__default__" group.
+ * Groups appear in the order they're first encountered.
+ */
+export declare function groupFields(fields: FieldDefinition[]): FieldGroup[];
+export {};
+//# sourceMappingURL=FieldGroupSection.d.ts.map

package/admin/dist/types/admin/src/components/FieldGroupSection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldGroupSection.d.ts","sourceRoot":"","sources":["../../../../../src/components/FieldGroupSection.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAIjE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,eAAe,EAAE,CAAA;CAC1B;AAED,UAAU,sBAAsB;IAC9B,KAAK,EAAE,UAAU,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC,CAAA;IACnD,YAAY,EAAE,OAAO,CAAA;IACrB,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAC1D,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AA6CD,wBAAgB,iBAAiB,CAAC,EAChC,KAAK,EACL,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,aAAa,EACb,WAAmB,GACpB,EAAE,sBAAsB,2CAsExB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,UAAU,EAAE,CAwBnE"}

package/admin/dist/types/admin/src/components/Header.d.ts

@@ -0,0 +1,2 @@
+export declare function Header(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=Header.d.ts.map

package/admin/dist/types/admin/src/components/Header.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Header.d.ts","sourceRoot":"","sources":["../../../../../src/components/Header.tsx"],"names":[],"mappings":"AAgHA,wBAAgB,MAAM,4CA8LrB"}

package/admin/dist/types/admin/src/components/RouteGuard.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Route Guard Component
+ *
+ * Protects routes by checking authentication and permissions.
+ * Shows appropriate UI for loading, unauthenticated, and unauthorized states.
+ *
+ * @example
+ * ```tsx
+ * // Protect a route requiring authentication
+ * <RouteGuard>
+ *   <ProtectedContent />
+ * </RouteGuard>
+ *
+ * // Protect a route requiring specific permissions
+ * <RouteGuard
+ *   requiredPermission={{ resource: 'settings', action: 'manage' }}
+ * >
+ *   <SettingsPage />
+ * </RouteGuard>
+ *
+ * // Require a specific role
+ * <RouteGuard requiredRole="admin">
+ *   <AdminOnlyContent />
+ * </RouteGuard>
+ * ```
+ */
+import type { ReactNode } from 'react';
+import { type PermissionCheck } from '../contexts/AuthContext';
+import type { RoleName } from '../lib/cmsExports';
+export interface RouteGuardProps {
+    children: ReactNode;
+    /**
+     * Permission required to access this route.
+     * If not specified, only authentication is required.
+     */
+    requiredPermission?: PermissionCheck;
+    /**
+     * Role required to access this route.
+     * If not specified, any authenticated user with a role can access.
+     */
+    requiredRole?: RoleName | string;
+    /**
+     * Custom loading component.
+     */
+    loadingComponent?: ReactNode;
+    /**
+     * Custom unauthenticated component.
+     */
+    unauthenticatedComponent?: ReactNode;
+    /**
+     * Custom unauthorized component.
+     */
+    unauthorizedComponent?: ReactNode;
+    /**
+     * Callback when user is unauthenticated.
+     */
+    onUnauthenticated?: () => void;
+    /**
+     * Callback when user is unauthorized.
+     */
+    onUnauthorized?: () => void;
+}
+/**
+ * Route Guard Component
+ *
+ * Wraps protected content and handles authentication/authorization checks.
+ */
+export declare function RouteGuard({ children, requiredPermission, requiredRole, loadingComponent, unauthenticatedComponent, unauthorizedComponent, onUnauthenticated, onUnauthorized, }: RouteGuardProps): import("react/jsx-runtime").JSX.Element;
+export default RouteGuard;
+//# sourceMappingURL=RouteGuard.d.ts.map

package/admin/dist/types/admin/src/components/RouteGuard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouteGuard.d.ts","sourceRoot":"","sources":["../../../../../src/components/RouteGuard.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EAAW,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAOlD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,SAAS,CAAC;IACpB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,eAAe,CAAC;IACrC;;;OAGG;IACH,YAAY,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IACjC;;OAEG;IACH,gBAAgB,CAAC,EAAE,SAAS,CAAC;IAC7B;;OAEG;IACH,wBAAwB,CAAC,EAAE,SAAS,CAAC;IACrC;;OAEG;IACH,qBAAqB,CAAC,EAAE,SAAS,CAAC;IAClC;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC/B;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;CAC7B;AAiHD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,EACzB,QAAQ,EACR,kBAAkB,EAClB,YAAY,EACZ,gBAAgB,EAChB,wBAAwB,EACxB,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,GACf,EAAE,eAAe,2CAkEjB;AAED,eAAe,UAAU,CAAC"}

package/admin/dist/types/admin/src/components/SchemaDriftWarning.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Schema Drift Warning Component
+ *
+ * Displays a warning banner when code-defined content types
+ * are out of sync with the database schema.
+ */
+import type { CmsAdminApi } from "../embed/contexts/ApiContext";
+interface SchemaDriftWarningProps {
+    api: CmsAdminApi;
+}
+export declare function SchemaDriftWarning({ api }: SchemaDriftWarningProps): import("react/jsx-runtime").JSX.Element | null;
+export {};
+//# sourceMappingURL=SchemaDriftWarning.d.ts.map

package/admin/dist/types/admin/src/components/SchemaDriftWarning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaDriftWarning.d.ts","sourceRoot":"","sources":["../../../../../src/components/SchemaDriftWarning.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAWhE,UAAU,uBAAuB;IAChC,GAAG,EAAE,WAAW,CAAC;CACjB;AAED,wBAAgB,kBAAkB,CAAC,EAAE,GAAG,EAAE,EAAE,uBAAuB,kDAuGlE"}

package/admin/dist/types/admin/src/components/Sidebar.d.ts

@@ -0,0 +1,2 @@
+export declare function Sidebar(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=Sidebar.d.ts.map

package/admin/dist/types/admin/src/components/Sidebar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sidebar.d.ts","sourceRoot":"","sources":["../../../../../src/components/Sidebar.tsx"],"names":[],"mappings":"AA+BA,wBAAgB,OAAO,4CAyKtB"}

package/admin/dist/types/admin/src/components/TaxonomyEditor.d.ts

@@ -0,0 +1,19 @@
+interface Taxonomy {
+    _id: string;
+    name: string;
+    displayName: string;
+    description?: string;
+    isHierarchical: boolean;
+    allowInlineCreation: boolean;
+    isActive: boolean;
+    icon?: string;
+    sortOrder?: number;
+}
+interface TaxonomyEditorProps {
+    taxonomy?: Taxonomy | null;
+    onSave: () => void;
+    onCancel: () => void;
+}
+export declare function TaxonomyEditor({ taxonomy, onSave, onCancel, }: TaxonomyEditorProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=TaxonomyEditor.d.ts.map

package/admin/dist/types/admin/src/components/TaxonomyEditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TaxonomyEditor.d.ts","sourceRoot":"","sources":["../../../../../src/components/TaxonomyEditor.tsx"],"names":[],"mappings":"AAUA,UAAU,QAAQ;IAChB,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,cAAc,EAAE,OAAO,CAAA;IACvB,mBAAmB,EAAE,OAAO,CAAA;IAC5B,QAAQ,EAAE,OAAO,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAA;IAC1B,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,QAAQ,EAAE,MAAM,IAAI,CAAA;CACrB;AAED,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,MAAM,EACN,QAAQ,GACT,EAAE,mBAAmB,2CA4TrB"}

package/admin/dist/types/admin/src/components/TermTree.d.ts

@@ -0,0 +1,8 @@
+interface TermTreeProps {
+    taxonomyId: string;
+    isHierarchical: boolean;
+    allowInlineCreation: boolean;
+}
+export declare function TermTree({ taxonomyId, isHierarchical, allowInlineCreation, }: TermTreeProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=TermTree.d.ts.map

package/admin/dist/types/admin/src/components/TermTree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TermTree.d.ts","sourceRoot":"","sources":["../../../../../src/components/TermTree.tsx"],"names":[],"mappings":"AAyBA,UAAU,aAAa;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,cAAc,EAAE,OAAO,CAAA;IACvB,mBAAmB,EAAE,OAAO,CAAA;CAC7B;AAED,wBAAgB,QAAQ,CAAC,EACvB,UAAU,EACV,cAAc,EACd,mBAAmB,GACpB,EAAE,aAAa,2CA6Of"}

package/admin/dist/types/admin/src/components/UploadDropzone.d.ts

@@ -0,0 +1,20 @@
+import type { FunctionReference } from 'convex/server';
+export interface UploadDropzoneProps {
+    onUploadComplete: (files: UploadedFile[]) => void;
+    currentFolderId?: string;
+    generateUploadUrl: FunctionReference<'mutation'>;
+    createAsset: FunctionReference<'mutation'>;
+    maxFileSize?: number;
+    allowedMimeTypes?: string[];
+    maxConcurrentUploads?: number;
+    onClose?: () => void;
+    onError?: (error: string, filename: string) => void;
+}
+export interface UploadedFile {
+    filename: string;
+    storageId: string;
+    success: boolean;
+    error?: string;
+}
+export declare function UploadDropzone({ onUploadComplete, currentFolderId, generateUploadUrl, createAsset, maxFileSize, allowedMimeTypes, maxConcurrentUploads, onError, }: UploadDropzoneProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=UploadDropzone.d.ts.map

package/admin/dist/types/admin/src/components/UploadDropzone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UploadDropzone.d.ts","sourceRoot":"","sources":["../../../../../src/components/UploadDropzone.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAKtD,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,IAAI,CAAA;IACjD,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,iBAAiB,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAA;IAChD,WAAW,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAA;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC3B,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;CACpD;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAqBD,wBAAgB,cAAc,CAAC,EAC7B,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,gBAAqB,EACrB,oBAAwB,EACxB,OAAO,GACR,EAAE,mBAAmB,2CA8UrB"}

package/admin/dist/types/admin/src/components/VersionCompare.d.ts

@@ -0,0 +1,10 @@
+interface VersionCompareProps {
+    entryId: string;
+    fromVersion: number;
+    toVersion: number;
+    onClose: () => void;
+    onRollback: (version: number) => void;
+}
+export declare function VersionCompare({ entryId, fromVersion, toVersion, onClose, onRollback, }: VersionCompareProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=VersionCompare.d.ts.map

package/admin/dist/types/admin/src/components/VersionCompare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VersionCompare.d.ts","sourceRoot":"","sources":["../../../../../src/components/VersionCompare.tsx"],"names":[],"mappings":"AAQA,UAAU,mBAAmB;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACtC;AA4BD,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,WAAW,EACX,SAAS,EACT,OAAO,EACP,UAAU,GACX,EAAE,mBAAmB,2CA0MrB"}

package/admin/dist/types/admin/src/components/VersionHistory.d.ts

@@ -0,0 +1,9 @@
+interface VersionHistoryProps {
+    entryId: string;
+    currentVersion: number;
+    onRollbackComplete?: () => void;
+    onClose: () => void;
+}
+export declare function VersionHistory({ entryId, currentVersion, onRollbackComplete, onClose, }: VersionHistoryProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=VersionHistory.d.ts.map

package/admin/dist/types/admin/src/components/VersionHistory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VersionHistory.d.ts","sourceRoot":"","sources":["../../../../../src/components/VersionHistory.tsx"],"names":[],"mappings":"AAYA,UAAU,mBAAmB;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,MAAM,CAAA;IACtB,kBAAkB,CAAC,EAAE,MAAM,IAAI,CAAA;IAC/B,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AAaD,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,cAAc,EACd,kBAAkB,EAClB,OAAO,GACR,EAAE,mBAAmB,2CAoPrB"}