@questpie/admin 2.0.0 → 3.0.1

package/dist/client/builder/types/action-registry.mjs

@@ -7,7 +7,10 @@ import { buildPrefillUrl } from "../../hooks/use-prefill-params.mjs";
 function createCreateAction(opts) {
 	return {
 		id: "create",
-		label: "Create",
+		label: {
+			key: "action.create",
+			fallback: "Create"
+		},
 		icon: {
 			type: "icon",
 			props: { name: "ph:plus" }
@@ -26,7 +29,10 @@ function createCreateAction(opts) {
 function createDuplicateAction(opts) {
 	return {
 		id: "duplicate",
-		label: "Duplicate",
+		label: {
+			key: "action.duplicate",
+			fallback: "Duplicate"
+		},
 		icon: {
 			type: "icon",
 			props: { name: "ph:copy" }
@@ -58,16 +64,28 @@ function createDuplicateAction(opts) {
 function createDeleteManyAction(opts) {
 	return {
 		id: "deleteMany",
-		label: "Delete Selected",
+		label: {
+			key: "action.deleteSelected",
+			fallback: "Delete Selected"
+		},
 		icon: {
 			type: "icon",
 			props: { name: "ph:trash" }
 		},
 		variant: "destructive",
 		confirmation: {
-			title: "Delete selected items?",
-			description: "This action cannot be undone. All selected items will be permanently deleted.",
-			confirmLabel: "Delete All",
+			title: {
+				key: "confirm.deleteSelectedTitle",
+				fallback: "Delete selected items?"
+			},
+			description: {
+				key: "confirm.deleteSelectedDescription",
+				fallback: "This action cannot be undone. All selected items will be permanently deleted."
+			},
+			confirmLabel: {
+				key: "confirm.deleteAll",
+				fallback: "Delete All"
+			},
 			destructive: true
 		},
 		handler: {
@@ -78,21 +96,116 @@ function createDeleteManyAction(opts) {
 	};
 }
 /**
+* Create a "Restore" action for a single soft-deleted item
+*/
+function createRestoreAction(opts) {
+	return {
+		id: "restore",
+		label: {
+			key: "action.restore",
+			fallback: "Restore"
+		},
+		icon: {
+			type: "icon",
+			props: { name: "ph:arrow-counter-clockwise" }
+		},
+		variant: "secondary",
+		visible: (ctx) => {
+			const item = ctx.item;
+			if (Array.isArray(item)) return false;
+			return !!item?.deletedAt;
+		},
+		confirmation: {
+			title: {
+				key: "confirm.restoreItemTitle",
+				fallback: "Restore item?"
+			},
+			description: {
+				key: "confirm.restoreItemDescription",
+				fallback: "This item will become visible in normal list views again."
+			},
+			confirmLabel: {
+				key: "action.restore",
+				fallback: "Restore"
+			},
+			destructive: false
+		},
+		handler: {
+			type: "api",
+			endpoint: "{id}/restore",
+			method: "POST"
+		},
+		...opts
+	};
+}
+/**
+* Create a "Restore Many" (bulk restore) action
+*/
+function createRestoreManyAction(opts) {
+	return {
+		id: "restoreMany",
+		label: {
+			key: "action.restoreSelected",
+			fallback: "Restore Selected"
+		},
+		icon: {
+			type: "icon",
+			props: { name: "ph:arrow-counter-clockwise" }
+		},
+		variant: "secondary",
+		visible: (ctx) => {
+			return (Array.isArray(ctx.item) ? ctx.item : []).some((item) => !!item?.deletedAt);
+		},
+		confirmation: {
+			title: {
+				key: "confirm.restoreSelectedTitle",
+				fallback: "Restore selected items?"
+			},
+			description: {
+				key: "confirm.restoreSelectedDescription",
+				fallback: "Selected items will be restored and visible again."
+			},
+			confirmLabel: {
+				key: "confirm.restoreAll",
+				fallback: "Restore All"
+			},
+			destructive: false
+		},
+		handler: {
+			type: "custom",
+			fn: async () => {}
+		},
+		...opts
+	};
+}
+/**
 * Create a "Delete" action for single item (form view)
 */
 function createDeleteAction(opts) {
 	return {
 		id: "delete",
-		label: "Delete",
+		label: {
+			key: "action.delete",
+			fallback: "Delete"
+		},
 		icon: {
 			type: "icon",
 			props: { name: "ph:trash" }
 		},
 		variant: "destructive",
 		confirmation: {
-			title: "Delete item?",
-			description: "This action cannot be undone. The item will be permanently deleted.",
-			confirmLabel: "Delete",
+			title: {
+				key: "confirm.deleteItemTitle",
+				fallback: "Delete item?"
+			},
+			description: {
+				key: "confirm.deleteItemDescription",
+				fallback: "This action cannot be undone. The item will be permanently deleted."
+			},
+			confirmLabel: {
+				key: "action.delete",
+				fallback: "Delete"
+			},
 			destructive: true
 		},
 		handler: {
@@ -104,6 +217,20 @@ function createDeleteAction(opts) {
 	};
 }
 /**
+* Creates an action registry proxy for type-safe action building
+*/
+function createActionRegistryProxy() {
+	return {
+		create: (opts) => createCreateAction(opts),
+		duplicate: (opts) => createDuplicateAction(opts),
+		delete: (opts) => createDeleteAction(opts),
+		deleteMany: (opts) => createDeleteManyAction(opts),
+		restore: (opts) => createRestoreAction(opts),
+		restoreMany: (opts) => createRestoreManyAction(opts),
+		action: (def) => def
+	};
+}
+/**
 * Get default header actions for a collection
 */
 function getDefaultHeaderActions() {
@@ -116,7 +243,11 @@ function getDefaultHeaderActions() {
 * Get default bulk actions for a collection
 */
 function getDefaultBulkActions() {
-	return [createDeleteManyAction(), createDuplicateAction()];
+	return [
+		createDeleteManyAction(),
+		createRestoreManyAction(),
+		createDuplicateAction()
+	];
 }
 /**
 * Get default form actions for a collection (edit view)
@@ -124,7 +255,11 @@ function getDefaultBulkActions() {
 function getDefaultFormActions() {
 	return {
 		primary: [],
-		secondary: [createDuplicateAction(), createDeleteAction()]
+		secondary: [
+			createDuplicateAction(),
+			createRestoreAction(),
+			createDeleteAction()
+		]
 	};
 }
 /**
@@ -138,5 +273,4 @@ function getDefaultActionsConfig() {
 }
 
 //#endregion
-export { getDefaultActionsConfig, getDefaultFormActions };
-//# sourceMappingURL=action-registry.mjs.map
+export { createActionRegistryProxy, getDefaultActionsConfig, getDefaultFormActions };

package/dist/client/builder/types/action-types.d.mts

@@ -1,8 +1,8 @@
 import { I18nText } from "../../i18n/types.mjs";
 import { IconComponent, MaybeLazyComponent } from "./common.mjs";
-import { ComponentReference } from "../../../server/augmentation.mjs";
-import "../../../server/index.mjs";
 import { FieldDefinition } from "../field/field.mjs";
+import { ComponentReference } from "../../../server/augmentation/common.mjs";
+import "../../../server/augmentation.mjs";
 
 //#region src/client/builder/types/action-types.d.ts
 
@@ -37,7 +37,7 @@ interface ActionHelpers {
    */
   invalidateItem: (id: string, collection?: string) => Promise<void>;
   /**
-   * Invalidate all CMS queries
+   * Invalidate all queries
    */
   invalidateAll: () => Promise<void>;
   /**
@@ -187,13 +187,13 @@ type ActionHandler<TItem = any> = NavigateHandler<TItem> | DialogHandler<TItem>
  */
 interface ConfirmationConfig {
   /** Dialog title */
-  title: string;
+  title: I18nText;
   /** Dialog description */
-  description?: string;
+  description?: I18nText;
   /** Confirm button label */
-  confirmLabel?: string;
+  confirmLabel?: I18nText;
   /** Cancel button label */
-  cancelLabel?: string;
+  cancelLabel?: I18nText;
   /** Use destructive styling */
   destructive?: boolean;
 }
@@ -222,32 +222,5 @@ interface ActionDefinition<TItem = any> {
   /** Confirmation dialog before executing */
   confirmation?: ConfirmationConfig;
 }
-/**
- * Header actions configuration with primary/secondary split
- *
- * @example
- * ```ts
- * header: {
- *   primary: [a.create()],           // Shown as buttons
- *   secondary: [a.action({...})],    // Shown in dropdown menu
- * }
- * ```
- */
-interface HeaderActionsConfig<TItem = any> {
-  /** Actions shown as buttons */
-  primary?: ActionDefinition<TItem>[];
-  /** Actions shown in dropdown menu */
-  secondary?: ActionDefinition<TItem>[];
-}
-/**
- * Collection actions configuration for list views
- */
-interface ActionsConfig<TItem = any> {
-  /** Actions displayed in the header area (create, import, etc.) */
-  header?: HeaderActionsConfig<TItem>;
-  /** Actions for bulk operations on selected items (deleteMany, duplicate, etc.) */
-  bulk?: ActionDefinition<TItem>[];
-}
 //#endregion
-export { ActionContext, ActionDefinition, ActionDialogProps, ActionFormConfig, ActionHandler, ActionHelpers, ActionVariant, ActionsConfig, ApiHandler, ConfirmationConfig, CustomHandler, DialogHandler, FormHandler, HeaderActionsConfig, NavigateHandler };
-//# sourceMappingURL=action-types.d.mts.map
+export { ActionDefinition };

package/dist/client/builder/types/collection-types.mjs

@@ -7,5 +7,4 @@ function normalizeColumnConfig(column) {
 }
 
 //#endregion
-export { normalizeColumnConfig };
-//# sourceMappingURL=collection-types.mjs.map
+export { normalizeColumnConfig };

package/dist/client/builder/types/common.d.mts

@@ -1,5 +1,5 @@
 import { I18nText } from "../../i18n/types.mjs";
-import * as React$1 from "react";
+import * as React from "react";
 
 //#region src/client/builder/types/common.d.ts
 
@@ -11,14 +11,14 @@ type DynamicI18nText = I18nText | ((values: Record<string, any>) => I18nText);
  * Component that can be lazy-loaded or direct
  * Supports React.lazy, dynamic imports, and direct components
  */
-type MaybeLazyComponent<TProps = any> = React$1.LazyExoticComponent<React$1.ComponentType<TProps>> | (() => Promise<{
-  default: React$1.ComponentType<TProps>;
-}>) | React$1.ComponentType<TProps>;
+type MaybeLazyComponent<TProps = any> = React.LazyExoticComponent<React.ComponentType<TProps>> | (() => Promise<{
+  default: React.ComponentType<TProps>;
+}>) | React.ComponentType<TProps>;
 /**
  * Icon component type
  * Icons are always synchronous - no lazy loading needed for small SVGs
  */
-type IconComponent = React$1.ComponentType<React$1.SVGProps<SVGSVGElement> & {
+type IconComponent = React.ComponentType<React.SVGProps<SVGSVGElement> & {
   className?: string;
 }>;
 /**
@@ -42,19 +42,5 @@ type BaseFieldProps = {
   control?: any;
   className?: string;
 };
-/**
- * Base field props for builder config (supports I18nText)
- * These are resolved to plain strings at runtime before passing to components
- */
-type BaseFieldConfigProps = {
-  /** Field label - supports inline translations and dynamic resolvers */
-  label?: DynamicI18nText;
-  /** Field description - supports inline translations and dynamic resolvers */
-  description?: DynamicI18nText;
-  /** Field placeholder - supports inline translations and dynamic resolvers */
-  placeholder?: DynamicI18nText;
-  required?: boolean;
-};
 //#endregion
-export { BaseFieldConfigProps, BaseFieldProps, DynamicI18nText, IconComponent, MaybeLazyComponent };
-//# sourceMappingURL=common.d.mts.map
+export { BaseFieldProps, DynamicI18nText, IconComponent, MaybeLazyComponent };

package/dist/client/builder/types/field-types.d.mts

@@ -1,7 +1,7 @@
 import { I18nText } from "../../i18n/types.mjs";
 import { BaseFieldProps, DynamicI18nText, IconComponent, MaybeLazyComponent } from "./common.mjs";
-import { ComponentReference } from "../../../server/augmentation.mjs";
-import "../../../server/index.mjs";
+import { ComponentReference } from "../../../server/augmentation/common.mjs";
+import "../../../server/augmentation.mjs";
 import { ActionDefinition } from "./action-types.mjs";
 import { z } from "zod";
 
@@ -537,7 +537,7 @@ interface FormSidebarConfig<TData = any> {
  *
  * @example
  * ```ts
- * .form(({ v, f }) => v.form({
+ * .form(({ v, f }) => v.collectionForm({
  *   sidebar: {
  *     position: 'right',
  *     fields: [f.status, f.publishedAt]
@@ -589,5 +589,4 @@ interface ComponentRegistry {
   custom?: Record<string, MaybeLazyComponent<any>>;
 }
 //#endregion
-export { ArrayFieldConfig, ComponentRegistry, EmbeddedFieldConfig, FieldComponentProps, FieldHookContext, FieldLayoutItem, FieldUIConfig, FieldValidationConfig, FormSidebarConfig, FormViewConfig, LayoutMode, RelationFieldConfig, RichTextConfig, SectionLayout, SelectOption, TabConfig, TabsLayout, WrapperMode };
-//# sourceMappingURL=field-types.d.mts.map
+export { ComponentRegistry, FieldComponentProps, FieldLayoutItem, FormSidebarConfig, FormViewConfig, SectionLayout, TabConfig, TabsLayout };

package/dist/client/builder/types/field-types.mjs

@@ -15,5 +15,4 @@ function getFieldName(item) {
 }
 
 //#endregion
-export { getFieldName, isFieldReference };
-//# sourceMappingURL=field-types.mjs.map
+export { getFieldName, isFieldReference };

package/dist/client/builder/types/ui-config.d.mts

@@ -1,7 +1,6 @@
-import "../../i18n/types.mjs";
 import { DynamicI18nText, IconComponent } from "./common.mjs";
-import { ComponentReference } from "../../../server/augmentation.mjs";
-import "../../../server/index.mjs";
+import { ComponentReference } from "../../../server/augmentation/common.mjs";
+import "../../../server/augmentation.mjs";
 import { WidgetConfig } from "./widget-types.mjs";
 
 //#region src/client/builder/types/ui-config.d.ts
@@ -156,5 +155,4 @@ interface LocaleConfig {
   supported?: string[];
 }
 //#endregion
-export { DashboardAction, DashboardConfig, DashboardLayoutItem, DashboardSection, DashboardTabConfig, DashboardTabs, LocaleConfig };
-//# sourceMappingURL=ui-config.d.mts.map
+export { DashboardAction, DashboardConfig, DashboardLayoutItem, DashboardSection, DashboardTabConfig, DashboardTabs, LocaleConfig };

package/dist/client/builder/types/widget-types.d.mts

@@ -1,8 +1,8 @@
 import { I18nText } from "../../i18n/types.mjs";
 import { IconComponent, MaybeLazyComponent } from "./common.mjs";
-import { ComponentReference } from "../../../server/augmentation.mjs";
-import "../../../server/index.mjs";
-import * as React$1 from "react";
+import { ComponentReference } from "../../../server/augmentation/common.mjs";
+import "../../../server/augmentation.mjs";
+import * as React from "react";
 
 //#region src/client/builder/types/widget-types.d.ts
 
@@ -77,11 +77,11 @@ interface BaseWidgetConfig {
    */
   className?: string;
   /**
-   * Indicates server has a fetchFn for this widget (set by getAdminConfig).
-   * When true, the widget fetches data via the fetchWidgetData RPC endpoint
-   * instead of calling a client-side fetchFn.
+   * Indicates server has a loader for this widget (set by getAdminConfig).
+   * When true, the widget loads data via the fetchWidgetData RPC endpoint
+   * instead of calling a client-side loader.
    */
-  hasFetchFn?: boolean;
+  hasLoader?: boolean;
 }
 /**
  * Date filter presets for time-based filtering
@@ -218,7 +218,7 @@ interface ValueWidgetTrend {
   icon?: IconComponent | ComponentReference;
 }
 /**
- * Result returned by fetchFn
+ * Result returned by loader
  */
 interface ValueWidgetResult {
   /** Main value to display */
@@ -248,7 +248,7 @@ interface ValueWidgetResult {
  * ```tsx
  * {
  *   type: "value",
- *   fetchFn: async (client) => {
+ *   loader: async (client) => {
  *     const count = await client.collections.appointments.count({
  *       where: { status: "pending" }
  *     });
@@ -270,9 +270,9 @@ interface ValueWidgetConfig extends BaseWidgetConfig {
   /**
    * Async function to fetch and transform data.
    * Receives the Questpie client and returns widget display data.
-   * Optional when hasFetchFn is true (server provides the data).
+   * Optional when hasLoader is true (server provides the data).
    */
-  fetchFn?: (client: any) => Promise<ValueWidgetResult>;
+  loader?: (client: any) => Promise<ValueWidgetResult>;
   /**
    * Refresh interval in milliseconds
    * If set, the widget will refetch data at this interval
@@ -292,7 +292,7 @@ interface TableWidgetColumnConfig {
   /** Text alignment */
   align?: "left" | "center" | "right";
   /** Custom cell renderer (overrides field's cell) */
-  render?: (value: any, row: any) => React$1.ReactNode;
+  render?: (value: any, row: any) => React.ReactNode;
 }
 /**
  * Table column - can be a simple field key string or full config object
@@ -393,7 +393,7 @@ interface TimelineItem {
  *   type: "timeline",
  *   id: "recent-activity",
  *   title: "Recent Activity",
- *   fetchFn: async (client) => {
+ *   loader: async (client) => {
  *     const activities = await client.collections.activities.findMany({
  *       limit: 10,
  *       orderBy: { createdAt: "desc" }
@@ -411,8 +411,8 @@ interface TimelineItem {
  */
 interface TimelineWidgetConfig extends BaseWidgetConfig {
   type: "timeline";
-  /** Async function to fetch timeline items. Optional when hasFetchFn is true. */
-  fetchFn?: (client: any) => Promise<TimelineItem[]>;
+  /** Async function to fetch timeline items. Optional when hasLoader is true. */
+  loader?: (client: any) => Promise<TimelineItem[]>;
   /** Max items to show */
   maxItems?: number;
   /** Show timestamps */
@@ -431,7 +431,7 @@ interface TimelineWidgetConfig extends BaseWidgetConfig {
  *   type: "progress",
  *   id: "monthly-sales",
  *   title: "Monthly Sales Goal",
- *   fetchFn: async (client) => ({
+ *   loader: async (client) => ({
  *     current: 75000,
  *     target: 100000,
  *     label: "$75,000 / $100,000"
@@ -441,8 +441,8 @@ interface TimelineWidgetConfig extends BaseWidgetConfig {
  */
 interface ProgressWidgetConfig extends BaseWidgetConfig {
   type: "progress";
-  /** Async function to fetch progress data. Optional when hasFetchFn is true. */
-  fetchFn?: (client: any) => Promise<{
+  /** Async function to fetch progress data. Optional when hasLoader is true. */
+  loader?: (client: any) => Promise<{
     current: number;
     target: number;
     label?: string;
@@ -559,5 +559,4 @@ interface WidgetAction {
   variant?: "default" | "primary" | "secondary" | "destructive";
 }
 //#endregion
-export { AnyWidgetConfig, BaseWidgetConfig, ChartWidgetConfig, CustomWidgetConfig, DateFilterConfig, GenericWidgetConfig, ProgressWidgetConfig, QuickActionItem, QuickActionsWidgetConfig, RecentItemsWidgetConfig, StatsWidgetConfig, TableWidgetColumn, TableWidgetColumnConfig, TableWidgetConfig, TimelineItem, TimelineWidgetConfig, ValueWidgetClassNames, ValueWidgetConfig, ValueWidgetResult, ValueWidgetTrend, WidgetAction, WidgetCardVariant, WidgetComponentProps, WidgetConfig, WidgetDataSource };
-//# sourceMappingURL=widget-types.d.mts.map
+export { AnyWidgetConfig, BaseWidgetConfig, ChartWidgetConfig, CustomWidgetConfig, ProgressWidgetConfig, QuickActionsWidgetConfig, RecentItemsWidgetConfig, StatsWidgetConfig, TableWidgetConfig, TimelineWidgetConfig, ValueWidgetConfig, WidgetAction, WidgetCardVariant, WidgetComponentProps, WidgetConfig };

package/dist/client/builder/validation.d.mts

@@ -1,3 +1,33 @@
-import { ZodBuildContext } from "./field/field.mjs";
-import "./proxies.mjs";
-import { z } from "zod";
+import { FieldInstance } from "./field/field.mjs";
+import { z } from "zod";
+
+//#region src/client/builder/validation.d.ts
+
+type FieldsMap = Record<string, FieldInstance>;
+interface BuildContext {
+  buildSchema: (fieldDef: FieldInstance) => z.ZodTypeAny;
+}
+/**
+ * Build a Zod schema from a single field's metadata.
+ *
+ * Resolution order:
+ * 1. FIELD_VALIDATORS[type] — special-case fields (email, select, date, relation, etc.)
+ * 2. Generic — resolveBaseType() + applyConstraints() (text, number, boolean, etc.)
+ */
+declare function buildZodFromIntrospection(fieldDef: FieldInstance, ctx: BuildContext): z.ZodTypeAny;
+/**
+ * Build a Zod object schema from a map of field instances.
+ */
+declare function buildValidationSchema(fields: FieldsMap): z.ZodObject<Record<string, z.ZodTypeAny>>;
+/**
+ * Create a Zod validation schema from admin field config.
+ *
+ * @example
+ * ```tsx
+ * const schema = createFormSchema(fieldInstances);
+ * const form = useForm({ resolver: zodResolver(schema) });
+ * ```
+ */
+declare function createFormSchema(fields: FieldsMap): z.ZodTypeAny;
+//#endregion
+export { buildValidationSchema, buildZodFromIntrospection, createFormSchema };