@questpie/admin 0.0.1 → 1.0.0

package/src/config/index.ts

@@ -1,1099 +0,0 @@
-import type { Questpie } from "questpie";
-import type { QuestpieClient } from "questpie/client";
-
-// ============================================================================
-// Base Types
-// ============================================================================
-
-/**
- * I18n text can be a string, translation key object, or function
- */
-export type I18nText =
-	| string
-	| { key: string; default?: string }
-	| ((ctx: AdminI18nContext) => string);
-
-/**
- * I18n context for translation and formatting
- */
-export type AdminI18nContext = {
-	locale: string;
-	dir: "ltr" | "rtl";
-	t: (key: string, vars?: Record<string, unknown>, fallback?: string) => string;
-	formatDate: (v: Date | string, opts?: Intl.DateTimeFormatOptions) => string;
-	formatNumber: (v: number, opts?: Intl.NumberFormatOptions) => string;
-};
-
-/**
- * Icon reference (component or icon name)
- */
-export type IconRef = React.ComponentType<{ className?: string }> | string;
-
-/**
- * Component reference (React component)
- */
-export type ComponentRef<TProps = any> = React.ComponentType<TProps>;
-
-/**
- * Dashboard widget configuration
- */
-export type DashboardWidget = {
-	/**
-	 * Widget ID
-	 */
-	id: string;
-
-	/**
-	 * Widget type (for built-in widgets) or component (for custom)
-	 */
-	type?: "stats" | "chart" | "recent-items" | "quick-actions" | "custom";
-
-	/**
-	 * Custom component
-	 */
-	component?: ComponentRef;
-
-	/**
-	 * Widget title
-	 */
-	title?: string;
-
-	/**
-	 * Widget description
-	 */
-	description?: string;
-
-	/**
-	 * Grid position
-	 */
-	position?: {
-		x: number;
-		y: number;
-		w: number; // width in grid units
-		h: number; // height in grid units
-	};
-
-	/**
-	 * Widget configuration (varies by type)
-	 */
-	config?: any;
-};
-
-/**
- * Dashboard configuration
- */
-export type DashboardConfig = {
-	/**
-	 * Dashboard title
-	 */
-	title?: string;
-
-	/**
-	 * Dashboard description
-	 */
-	description?: string;
-
-	/**
-	 * Widgets to display
-	 */
-	widgets?: DashboardWidget[];
-
-	/**
-	 * Grid columns (default: 12)
-	 */
-	columns?: number;
-
-	/**
-	 * Row height in pixels (default: 80)
-	 */
-	rowHeight?: number;
-
-	/**
-	 * Allow users to customize layout
-	 */
-	customizable?: boolean;
-
-	/**
-	 * Custom dashboard component (overrides widgets)
-	 */
-	component?: ComponentRef;
-};
-
-/**
- * Custom page configuration
- */
-export type CustomPageConfig = {
-	/**
-	 * Page ID (used in routing)
-	 */
-	id: string;
-
-	/**
-	 * Page label (shown in sidebar)
-	 */
-	label: string;
-
-	/**
-	 * Icon
-	 */
-	icon?: IconRef;
-
-	/**
-	 * Page path (e.g., "/admin/settings")
-	 */
-	path: string;
-
-	/**
-	 * Page component
-	 */
-	component: ComponentRef;
-
-	/**
-	 * Show in sidebar navigation
-	 */
-	showInNav?: boolean;
-
-	/**
-	 * Navigation group
-	 */
-	group?: string;
-
-	/**
-	 * Navigation order
-	 */
-	order?: number;
-
-	/**
-	 * Required permissions
-	 */
-	permissions?: string[];
-};
-
-/**
- * Admin app configuration
- */
-export type AdminAppConfig = {
-	brand?: {
-		name?: I18nText;
-		logo?: ComponentRef;
-		homeRoute?: string;
-	};
-	locales?: {
-		default: string;
-		available: string[];
-	};
-	preview?: {
-		enabled?: boolean;
-		route?: string;
-	};
-	debug?: {
-		showQueryDevtools?: boolean;
-		showRouterDevtools?: boolean;
-	};
-	/**
-	 * Dashboard configuration
-	 */
-	dashboard?: DashboardConfig;
-
-	/**
-	 * Custom pages
-	 */
-	pages?: CustomPageConfig[];
-};
-
-/**
- * List view configuration
- */
-export type ListConfig = {
-	/**
-	 * Columns to display by default
-	 */
-	defaultColumns?: string[];
-
-	/**
-	 * Default sort configuration
-	 */
-	defaultSort?: {
-		field: string;
-		direction: "asc" | "desc";
-	};
-
-	/**
-	 * Relations to eager-load with the list
-	 */
-	with?: string[];
-
-	/**
-	 * Items per page
-	 */
-	pageSize?: number;
-
-	/**
-	 * Enable search
-	 */
-	searchable?: boolean;
-
-	/**
-	 * Searchable fields
-	 */
-	searchFields?: string[];
-};
-
-/**
- * Layout types for sections
- */
-export type SectionLayout =
-	| "auto" // Automatic vertical stack
-	| "columns" // Multi-column layout
-	| "grid" // CSS grid layout
-	| "inline"; // Horizontal inline layout
-
-/**
- * Field layout configuration
- */
-export type FieldLayout = {
-	/**
-	 * Field name
-	 */
-	field: string;
-
-	/**
-	 * Column span (e.g., "1", "2", "full", "1/2", "2/3")
-	 */
-	span?: string | number;
-
-	/**
-	 * Row span
-	 */
-	rowSpan?: number;
-
-	/**
-	 * Custom width (e.g., "200px", "50%", "auto")
-	 */
-	width?: string;
-};
-
-/**
- * Section configuration
- */
-export type SectionConfig = {
-	/**
-	 * Section title
-	 */
-	title?: string;
-
-	/**
-	 * Section description
-	 */
-	description?: string;
-
-	/**
-	 * Fields in this section (simple array or advanced layout)
-	 */
-	fields: string[] | FieldLayout[];
-
-	/**
-	 * Layout type
-	 */
-	layout?: SectionLayout;
-
-	/**
-	 * Number of columns (for "columns" layout)
-	 */
-	columns?: number;
-
-	/**
-	 * Grid configuration (for "grid" layout)
-	 */
-	grid?: {
-		/**
-		 * Number of columns in grid
-		 */
-		columns: number;
-
-		/**
-		 * Gap between items (in tailwind spacing units)
-		 */
-		gap?: number;
-
-		/**
-		 * Responsive breakpoints
-		 */
-		responsive?: {
-			sm?: number; // columns at sm breakpoint
-			md?: number; // columns at md breakpoint
-			lg?: number; // columns at lg breakpoint
-		};
-	};
-
-	/**
-	 * Is collapsible
-	 */
-	collapsible?: boolean;
-
-	/**
-	 * Default open state (if collapsible)
-	 */
-	defaultOpen?: boolean;
-
-	/**
-	 * Conditional visibility
-	 */
-	visible?: boolean | ((values: any) => boolean);
-
-	/**
-	 * Custom CSS class
-	 */
-	className?: string;
-};
-
-/**
- * Tab configuration
- */
-export type TabConfig = {
-	/**
-	 * Tab ID
-	 */
-	id: string;
-
-	/**
-	 * Tab label
-	 */
-	label: string;
-
-	/**
-	 * Icon (optional)
-	 */
-	icon?: string;
-
-	/**
-	 * Sections within this tab
-	 */
-	sections?: SectionConfig[];
-
-	/**
-	 * Or simple field list
-	 */
-	fields?: string[];
-
-	/**
-	 * Conditional visibility
-	 */
-	visible?: boolean | ((values: any) => boolean);
-};
-
-/**
- * Edit/Create form configuration
- */
-export type EditConfig = {
-	/**
-	 * Field order and visibility (auto-detected if not specified)
-	 */
-	fields?: string[];
-
-	/**
-	 * Fields to exclude from form
-	 */
-	exclude?: string[];
-
-	/**
-	 * Group fields into sections
-	 */
-	sections?: SectionConfig[];
-
-	/**
-	 * Organize into tabs
-	 */
-	tabs?: TabConfig[];
-
-	/**
-	 * Sidebar fields (meta info)
-	 */
-	sidebar?: {
-		/**
-		 * Fields to show in sidebar
-		 */
-		fields: string[];
-
-		/**
-		 * Sidebar position
-		 */
-		position?: "right" | "left";
-
-		/**
-		 * Sidebar width
-		 */
-		width?: string;
-	};
-
-	/**
-	 * Main content layout (when sidebar is present)
-	 */
-	layout?: "full" | "with-sidebar";
-
-	/**
-	 * Show version history
-	 */
-	showVersionHistory?: boolean;
-
-	/**
-	 * Enable draft mode
-	 */
-	enableDrafts?: boolean;
-};
-
-/**
- * Field configuration
- */
-export type FieldConfig = {
-	/**
-	 * Field label
-	 */
-	label?: string;
-
-	/**
-	 * Field description
-	 */
-	description?: string;
-
-	/**
-	 * Placeholder text
-	 */
-	placeholder?: string;
-
-	/**
-	 * Helper text
-	 */
-	helperText?: string;
-
-	/**
-	 * Custom component (from registry or inline)
-	 */
-	component?: string | React.ComponentType<any>;
-
-	/**
-	 * Conditional visibility
-	 */
-	visible?: boolean | ((values: any) => boolean);
-
-	/**
-	 * Hide field entirely
-	 */
-	hidden?: boolean;
-
-	/**
-	 * Conditional readonly
-	 */
-	readOnly?: boolean | ((values: any) => boolean);
-
-	/**
-	 * Conditional disabled
-	 */
-	disabled?: boolean | ((values: any) => boolean);
-
-	/**
-	 * Field type override
-	 */
-	type?: string;
-
-	/**
-	 * Localized (i18n) field
-	 */
-	localized?: boolean;
-
-	/**
-	 * Is required
-	 */
-	required?: boolean | ((values: any) => boolean);
-
-	/**
-	 * Options for select/enum fields
-	 */
-	options?:
-		| Array<{ label: string; value: any }>
-		| ((values: any) => Array<{ label: string; value: any }>);
-
-	/**
-	 * Array field configuration
-	 */
-	array?: {
-		/**
-		 * Item type
-		 */
-		itemType?: "text" | "number" | "email" | "textarea" | "select";
-
-		/**
-		 * Options for select items
-		 */
-		options?: Array<{ label: string; value: any }>;
-
-		/**
-		 * Enable ordering
-		 */
-		orderable?: boolean;
-
-		/**
-		 * Minimum number of items
-		 */
-		minItems?: number;
-
-		/**
-		 * Maximum number of items
-		 */
-		maxItems?: number;
-
-		/**
-		 * Placeholder for item input
-		 */
-		placeholder?: string;
-	};
-
-	/**
-	 * Rich text editor configuration
-	 */
-	richText?: {
-		/**
-		 * Output format
-		 */
-		outputFormat?: "json" | "html" | "markdown";
-
-		/**
-		 * Enable image uploads
-		 */
-		enableImages?: boolean;
-
-		/**
-		 * Max character limit
-		 */
-		maxCharacters?: number;
-
-		/**
-		 * Show character count
-		 */
-		showCharacterCount?: boolean;
-
-		/**
-		 * Custom Tiptap extensions
-		 */
-		extensions?: any[];
-
-		/**
-		 * Feature toggles
-		 */
-		features?: {
-			toolbar?: boolean;
-			bubbleMenu?: boolean;
-			slashCommands?: boolean;
-			history?: boolean;
-			heading?: boolean;
-			bold?: boolean;
-			italic?: boolean;
-			underline?: boolean;
-			strike?: boolean;
-			code?: boolean;
-			codeBlock?: boolean;
-			blockquote?: boolean;
-			bulletList?: boolean;
-			orderedList?: boolean;
-			horizontalRule?: boolean;
-			align?: boolean;
-			link?: boolean;
-			image?: boolean;
-			table?: boolean;
-			tableControls?: boolean;
-			characterCount?: boolean;
-		};
-
-		/**
-		 * Image upload handler
-		 */
-		onImageUpload?: (file: File) => Promise<string>;
-	};
-
-	/**
-	 * Relation field configuration
-	 */
-	relation?: {
-		/**
-		 * Target collection name
-		 */
-		targetCollection: string;
-
-		/**
-		 * Mode: picker (multiple), inline, create
-		 */
-		mode?: "picker" | "inline" | "create";
-
-		/**
-		 * Filter options based on form values
-		 */
-		filter?: (values: any) => any;
-
-		/**
-		 * Enable drag-and-drop ordering (for multiple relations)
-		 */
-		orderable?: boolean;
-	};
-
-	/**
-	 * Embedded collection configuration
-	 */
-	embedded?: {
-		/**
-		 * Collection to embed
-		 */
-		collection: string;
-
-		/**
-		 * Enable drag-and-drop ordering
-		 */
-		orderable?: boolean;
-
-		/**
-		 * Display mode
-		 */
-		mode?: "inline" | "modal" | "drawer";
-
-		/**
-		 * Row label
-		 */
-		rowLabel?: (item: any) => string;
-	};
-
-	/**
-	 * List view configuration for this field
-	 */
-	list?: {
-		/**
-		 * Custom cell renderer
-		 */
-		renderCell?: string | React.ComponentType<any>;
-
-		/**
-		 * Column width
-		 */
-		width?: number;
-
-		/**
-		 * Is sortable
-		 */
-		sortable?: boolean;
-	};
-
-	/**
-	 * Validation function
-	 */
-	validate?: (value: any, values: any) => string | undefined;
-};
-
-/**
- * Admin collection configuration (UI only)
- */
-export type AdminCollectionConfig<
-	CMS extends Questpie<any>,
-	K extends keyof CMS["config"]["collections"],
-> = {
-	label?: I18nText;
-	description?: I18nText;
-	icon?: IconRef;
-	group?: string;
-
-	/**
-	 * List view configuration
-	 */
-	list?: ListConfig;
-
-	/**
-	 * Edit/Create form configuration
-	 */
-	edit?: EditConfig;
-
-	/**
-	 * Field-specific overrides
-	 */
-	fields?: Record<string, FieldConfig>;
-
-	/**
-	 * Enable versioning for this collection
-	 */
-	versioned?: boolean;
-
-	/**
-	 * Enable audit logging
-	 */
-	auditLog?:
-		| boolean
-		| {
-				/**
-				 * Fields to track
-				 */
-				fields?: string[];
-
-				/**
-				 * Track who made changes
-				 */
-				trackUser?: boolean;
-
-				/**
-				 * Retention period (in days)
-				 */
-				retentionDays?: number;
-		  };
-};
-
-/**
- * Admin collections map (key = collection name)
- */
-export type AdminCollectionMap<CMS extends Questpie<any>> = {
-	[K in keyof CMS["config"]["collections"]]?: AdminCollectionConfig<CMS, K>;
-};
-
-/**
- * Complete admin configuration
- */
-export type AdminConfig<CMS extends Questpie<any>> = {
-	app: AdminAppConfig;
-	collections?: AdminCollectionMap<CMS>;
-};
-
-/**
- * Define admin configuration with type inference
- *
- * @example
- * ```ts
- * import { defineAdminConfig } from '@questpie/admin/config'
- * import type { cms } from './server/cms'
- *
- * export const admin = defineAdminConfig<typeof cms>()({
- *   app: {
- *     brand: { name: "My CMS" }
- *   },
- *   collections: {
- *     posts: {
- *       label: "Posts",
- *       icon: "posts"
- *     }
- *   }
- * })
- * ```
- */
-export const defineAdminConfig =
-	<CMS extends Questpie<any>>() =>
-	<TConfig extends AdminConfig<CMS>>(config: TConfig): TConfig => {
-		return config;
-	};
-
-/**
- * Define a single collection config (for modular configs)
- *
- * @example
- * ```ts
- * // collections/posts.admin.ts
- * import { defineCollectionConfig } from '@questpie/admin/config'
- * import type { cms } from '../server/cms'
- *
- * export const postsAdminConfig = defineCollectionConfig<typeof cms, "posts">()({
- *   label: "Blog Posts",
- *   icon: "article",
- *   list: {
- *     defaultColumns: ["title", "status", "createdAt"],
- *   },
- *   edit: {
- *     sections: [
- *       { title: "Content", fields: ["title", "content"] },
- *       { title: "Settings", fields: ["status", "publishedAt"] },
- *     ],
- *   },
- * })
- * ```
- */
-export const defineCollectionConfig =
-	<CMS extends Questpie<any>, K extends keyof CMS["config"]["collections"]>() =>
-	<TConfig extends AdminCollectionConfig<CMS, K>>(config: TConfig): TConfig => {
-		return config;
-	};
-
-/**
- * Merge multiple admin configs into one
- *
- * @example
- * ```ts
- * const admin = defineAdminConfig<typeof cms>()(
- *   mergeAdminConfigs([
- *     baseConfig,
- *     postsConfig,
- *     productsConfig,
- *   ])
- * )
- * ```
- */
-export function mergeAdminConfigs<CMS extends Questpie<any>>(
-	configs: Partial<AdminConfig<CMS>>[],
-): AdminConfig<CMS> {
-	const result: AdminConfig<CMS> = { app: {} };
-	for (const config of configs) {
-		if (config.app) {
-			result.app = { ...result.app, ...config.app };
-		}
-		if (config.collections) {
-			result.collections = {
-				...result.collections,
-				...config.collections,
-			} as AdminCollectionMap<CMS>;
-		}
-	}
-	return result;
-}
-
-/**
- * Define app config separately
- *
- * @example
- * ```ts
- * export const appConfig = defineAppConfig({
- *   brand: { name: "My CMS" },
- *   locales: { default: "en", available: ["en", "sk"] },
- * })
- * ```
- */
-export const defineAppConfig = <TConfig extends AdminAppConfig>(
-	config: TConfig,
-): TConfig => {
-	return config;
-};
-
-/**
- * Define dashboard config
- *
- * @example
- * ```ts
- * export const dashboardConfig = defineDashboardConfig({
- *   widgets: [
- *     { id: "stats", type: "stats", position: { x: 0, y: 0, w: 4, h: 2 } },
- *   ],
- * })
- * ```
- */
-export const defineDashboardConfig = <TConfig extends DashboardConfig>(
-	config: TConfig,
-): TConfig => {
-	return config;
-};
-
-// ============================================================================
-// Views Configuration
-// ============================================================================
-
-/**
- * Props for auth layout view
- */
-export type AuthLayoutViewProps = {
-	title: string;
-	description?: string;
-	logo?: React.ReactNode;
-	footer?: React.ReactNode;
-	children: React.ReactNode;
-	className?: string;
-};
-
-/**
- * Props for login form view
- */
-export type LoginFormViewProps = {
-	onSubmit: (values: {
-		email: string;
-		password: string;
-		rememberMe?: boolean;
-	}) => Promise<void>;
-	onSignUpClick?: () => void;
-	onForgotPasswordClick?: () => void;
-	showRememberMe?: boolean;
-	showSignUp?: boolean;
-	showForgotPassword?: boolean;
-	defaultValues?: { email?: string; password?: string; rememberMe?: boolean };
-	className?: string;
-	error?: string | null;
-};
-
-/**
- * Props for forgot password form view
- */
-export type ForgotPasswordFormViewProps = {
-	onSubmit: (values: { email: string }) => Promise<void>;
-	onBackToLoginClick?: () => void;
-	defaultValues?: { email?: string };
-	className?: string;
-	error?: string | null;
-};
-
-/**
- * Props for reset password form view
- */
-export type ResetPasswordFormViewProps = {
-	token: string;
-	onSubmit: (values: {
-		password: string;
-		confirmPassword: string;
-		token: string;
-	}) => Promise<void>;
-	onBackToLoginClick?: () => void;
-	minPasswordLength?: number;
-	className?: string;
-	error?: string | null;
-};
-
-/**
- * Props for admin layout view
- */
-export type AdminLayoutViewProps = {
-	children: React.ReactNode;
-	sidebar?: React.ReactNode;
-	header?: React.ReactNode;
-	className?: string;
-};
-
-/**
- * Props for admin sidebar view
- */
-export type AdminSidebarViewProps = {
-	collections?: Array<{
-		name: string;
-		label: string;
-		icon?: IconRef;
-		href: string;
-	}>;
-	globals?: Array<{
-		name: string;
-		label: string;
-		icon?: IconRef;
-		href: string;
-	}>;
-	customItems?: Array<{
-		id: string;
-		label: string;
-		icon?: IconRef;
-		href: string;
-		group?: string;
-	}>;
-	activeItem?: string;
-	onItemClick?: (item: string) => void;
-	collapsed?: boolean;
-	onCollapsedChange?: (collapsed: boolean) => void;
-};
-
-/**
- * Props for collection list view
- */
-export type CollectionListViewProps<TItem = any> = {
-	collection: string;
-	items: TItem[];
-	columns: Array<{
-		id: string;
-		header: string;
-		accessorKey?: string;
-		cell?: (item: TItem) => React.ReactNode;
-	}>;
-	isLoading?: boolean;
-	error?: Error | null;
-	onItemClick?: (item: TItem) => void;
-	onCreateClick?: () => void;
-	onDeleteClick?: (item: TItem) => void;
-	pagination?: {
-		page: number;
-		pageSize: number;
-		total: number;
-		onPageChange: (page: number) => void;
-	};
-	search?: {
-		value: string;
-		onChange: (value: string) => void;
-		placeholder?: string;
-	};
-};
-
-/**
- * Props for collection form view
- */
-export type CollectionFormViewProps<TItem = any> = {
-	collection: string;
-	item?: TItem | null;
-	isLoading?: boolean;
-	error?: Error | null;
-	onSubmit: (data: Partial<TItem>) => Promise<void>;
-	onCancel?: () => void;
-	onDelete?: () => void;
-	fields: React.ReactNode;
-	isCreate?: boolean;
-};
-
-/**
- * Props for locale switcher view
- */
-export type LocaleSwitcherViewProps = {
-	currentLocale: string;
-	availableLocales: string[];
-	onLocaleChange: (locale: string) => void;
-	disabled?: boolean;
-};
-
-/**
- * Props for version history view
- */
-export type VersionHistoryViewProps = {
-	versions: Array<{
-		id: string;
-		createdAt: Date;
-		createdBy?: string;
-		changes?: string[];
-	}>;
-	currentVersionId?: string;
-	onVersionSelect?: (versionId: string) => void;
-	onVersionRestore?: (versionId: string) => void;
-	isLoading?: boolean;
-};
-
-/**
- * All view components registry type
- */
-export type AdminViewsConfig = {
-	// Auth views
-	AuthLayout?: ComponentRef<AuthLayoutViewProps>;
-	LoginForm?: ComponentRef<LoginFormViewProps>;
-	ForgotPasswordForm?: ComponentRef<ForgotPasswordFormViewProps>;
-	ResetPasswordForm?: ComponentRef<ResetPasswordFormViewProps>;
-
-	// Layout views
-	AdminLayout?: ComponentRef<AdminLayoutViewProps>;
-	AdminSidebar?: ComponentRef<AdminSidebarViewProps>;
-
-	// Collection views
-	CollectionList?: ComponentRef<CollectionListViewProps>;
-	CollectionForm?: ComponentRef<CollectionFormViewProps>;
-
-	// Utility views
-	LocaleSwitcher?: ComponentRef<LocaleSwitcherViewProps>;
-	VersionHistory?: ComponentRef<VersionHistoryViewProps>;
-
-	// Allow custom views
-	[key: string]: ComponentRef<any> | undefined;
-};
-
-/**
- * Define views configuration
- *
- * @example
- * ```ts
- * import { defineViewsConfig } from '@questpie/admin/config'
- * import { CustomLoginForm } from './components/CustomLoginForm'
- *
- * export const viewsConfig = defineViewsConfig({
- *   LoginForm: CustomLoginForm,
- *   // Override any default view
- * })
- * ```
- */
-export const defineViewsConfig = <TConfig extends AdminViewsConfig>(
-	config: TConfig,
-): TConfig => {
-	return config;
-};