@questpie/admin 1.1.1 → 2.0.0

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

@@ -0,0 +1,70 @@
+import { AdminBuilder } from "./admin-builder.mjs";
+import { Questpie } from "questpie";
+
+//#region src/client/builder/registry.d.ts
+
+/**
+ * Admin Type Registry for module augmentation.
+ *
+ * @deprecated Use `createTypedHooks<AppCMS>()` instead for new projects.
+ * Module augmentation is still supported for backwards compatibility.
+ *
+ * Legacy usage (still works but not recommended):
+ * @example
+ * ```ts
+ * // In your admin.ts after creating the admin config:
+ * export const admin = qa()
+ *   .use(coreAdminModule)
+ *   .collections({ barbers, services })
+ *
+ * declare module "@questpie/admin" {
+ *   interface AdminTypeRegistry {
+ *     cms: AppCMS
+ *     admin: typeof admin
+ *   }
+ * }
+ * ```
+ *
+ * New recommended pattern:
+ * @example
+ * ```ts
+ * import type { AppCMS } from './server/cms';
+ * import { createTypedHooks } from '@questpie/admin/client';
+ *
+ * export const {
+ *   useCollectionList,
+ *   useCollectionItem,
+ *   useGlobal,
+ * } = createTypedHooks<AppCMS>();
+ * ```
+ */
+interface AdminTypeRegistry {}
+/**
+ * Extract the CMS type from AdminTypeRegistry if augmented, otherwise unknown.
+ */
+type RegisteredCMS = AdminTypeRegistry extends {
+  cms: infer T;
+} ? T extends Questpie<any> ? T : unknown : unknown;
+/**
+ * Extract the Admin config type from AdminTypeRegistry if augmented, otherwise unknown.
+ */
+type RegisteredAdmin = AdminTypeRegistry extends {
+  admin: infer T;
+} ? T extends AdminBuilder<any> ? T : unknown : unknown;
+/**
+ * Extract collection names from registered CMS.
+ * Falls back to string if CMS is not registered.
+ */
+type RegisteredCollectionNames = RegisteredCMS extends Questpie<infer TConfig> ? keyof TConfig["collections"] & string : string;
+/**
+ * Extract global names from registered CMS.
+ * Falls back to string if CMS is not registered.
+ */
+type RegisteredGlobalNames = RegisteredCMS extends Questpie<infer TConfig> ? keyof TConfig["globals"] & string : string;
+/**
+ * Check if the registry has been augmented with a CMS type.
+ */
+type IsRegistered = RegisteredCMS extends unknown ? RegisteredCMS extends Questpie<any> ? true : false : false;
+//#endregion
+export { AdminTypeRegistry, IsRegistered, RegisteredAdmin, RegisteredCMS, RegisteredCollectionNames, RegisteredGlobalNames };
+//# sourceMappingURL=registry.d.mts.map

package/dist/client/builder/registry.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.mts","names":[],"sources":["../../../src/client/builder/registry.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAmEiB,iBAAA;;;;KAoBL,aAAA,GAAgB;;cACd;;;;KAQF,eAAA,GAAkB;;cAChB;;;;;KASF,yBAAA,GACV,sBAAsB,gCACZ;;;;;KAOA,qBAAA,GACV,sBAAsB,gCACZ;;;;KAMA,YAAA,GAAe,gCACvB,sBAAsB"}

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

@@ -0,0 +1,2 @@
+import "./action-types.mjs";
+import "./field-types.mjs";

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

@@ -0,0 +1,142 @@
+import { buildPrefillUrl } from "../../hooks/use-prefill-params.mjs";
+
+//#region src/client/builder/types/action-registry.ts
+/**
+* Create a "Create" action
+*/
+function createCreateAction(opts) {
+	return {
+		id: "create",
+		label: "Create",
+		icon: {
+			type: "icon",
+			props: { name: "ph:plus" }
+		},
+		variant: "default",
+		handler: {
+			type: "navigate",
+			path: "create"
+		},
+		...opts
+	};
+}
+/**
+* Create a "Duplicate" action (bulk action, shows only when 1 item selected)
+*/
+function createDuplicateAction(opts) {
+	return {
+		id: "duplicate",
+		label: "Duplicate",
+		icon: {
+			type: "icon",
+			props: { name: "ph:copy" }
+		},
+		variant: "ghost",
+		visible: (ctx) => {
+			if (Array.isArray(ctx.item)) return ctx.item.length === 1;
+			return !!ctx.item;
+		},
+		handler: {
+			type: "custom",
+			fn: async (ctx) => {
+				const item = Array.isArray(ctx.item) ? ctx.item[0] : ctx.item;
+				if (!item) return;
+				const { id, createdAt, updatedAt, ...data } = item;
+				const prefillUrl = buildPrefillUrl(`${ctx.helpers.basePath}/collections/${ctx.collection}/create`, data);
+				ctx.helpers.navigate(prefillUrl);
+			}
+		},
+		...opts
+	};
+}
+/**
+* Create a "Delete Many" (bulk delete) action
+*
+* Note: The actual deletion is handled by BulkActionToolbar via onBulkDelete callback.
+* This action definition just configures the UI and confirmation.
+*/
+function createDeleteManyAction(opts) {
+	return {
+		id: "deleteMany",
+		label: "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",
+			destructive: true
+		},
+		handler: {
+			type: "custom",
+			fn: async () => {}
+		},
+		...opts
+	};
+}
+/**
+* Create a "Delete" action for single item (form view)
+*/
+function createDeleteAction(opts) {
+	return {
+		id: "delete",
+		label: "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",
+			destructive: true
+		},
+		handler: {
+			type: "api",
+			endpoint: "{id}",
+			method: "DELETE"
+		},
+		...opts
+	};
+}
+/**
+* Get default header actions for a collection
+*/
+function getDefaultHeaderActions() {
+	return {
+		primary: [createCreateAction()],
+		secondary: []
+	};
+}
+/**
+* Get default bulk actions for a collection
+*/
+function getDefaultBulkActions() {
+	return [createDeleteManyAction(), createDuplicateAction()];
+}
+/**
+* Get default form actions for a collection (edit view)
+*/
+function getDefaultFormActions() {
+	return {
+		primary: [],
+		secondary: [createDuplicateAction(), createDeleteAction()]
+	};
+}
+/**
+* Get complete default actions config
+*/
+function getDefaultActionsConfig() {
+	return {
+		header: getDefaultHeaderActions(),
+		bulk: getDefaultBulkActions()
+	};
+}
+
+//#endregion
+export { getDefaultActionsConfig, getDefaultFormActions };
+//# sourceMappingURL=action-registry.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"action-registry.mjs","names":[],"sources":["../../../../src/client/builder/types/action-registry.ts"],"sourcesContent":["/**\n * Action Registry\n *\n * Provides built-in action factories and the action registry proxy\n * for type-safe action configuration in collection builders.\n */\n\nimport type { ComponentReference } from \"#questpie/admin/server\";\nimport { buildPrefillUrl } from \"../../hooks/use-prefill-params\";\nimport type { FormViewActionsConfig } from \"./field-types\";\nimport type {\n  ActionContext,\n  ActionDefinition,\n  ActionsConfig,\n  HeaderActionsConfig,\n} from \"./action-types\";\n\n// ============================================================================\n// Action Registry Proxy Type\n// ============================================================================\n\n/**\n * Proxy type for building actions with autocomplete\n */\nexport interface ActionRegistryProxy<TItem = any> {\n  /**\n   * Create action - navigates to create page (header action)\n   */\n  create(opts?: Partial<ActionDefinition<TItem>>): ActionDefinition<TItem>;\n\n  /**\n   * Duplicate action - creates a copy of the selected item\n   * For bulk: shows only when 1 item selected\n   * For form: always visible\n   */\n  duplicate(opts?: Partial<ActionDefinition<TItem>>): ActionDefinition<TItem>;\n\n  /**\n   * Delete action - deletes single item with confirmation (form action)\n   */\n  delete(opts?: Partial<ActionDefinition<TItem>>): ActionDefinition<TItem>;\n\n  /**\n   * Delete many action - bulk delete selected items\n   */\n  deleteMany(opts?: Partial<ActionDefinition<TItem>>): ActionDefinition<TItem>;\n\n  /**\n   * Custom action - define a fully custom action\n   */\n  action(def: ActionDefinition<TItem>): ActionDefinition<TItem>;\n}\n\n// ============================================================================\n// Built-in Action Factories\n// ============================================================================\n\n/**\n * Create a \"Create\" action\n */\nfunction createCreateAction<TItem>(\n  opts?: Partial<ActionDefinition<TItem>>,\n): ActionDefinition<TItem> {\n  return {\n    id: \"create\",\n    label: \"Create\",\n    icon: {\n      type: \"icon\",\n      props: { name: \"ph:plus\" },\n    } satisfies ComponentReference,\n    variant: \"default\",\n    handler: {\n      type: \"navigate\",\n      path: \"create\",\n    },\n    ...opts,\n  };\n}\n\n/**\n * Create a \"Duplicate\" action (bulk action, shows only when 1 item selected)\n */\nfunction createDuplicateAction<TItem>(\n  opts?: Partial<ActionDefinition<TItem>>,\n): ActionDefinition<TItem> {\n  return {\n    id: \"duplicate\",\n    label: \"Duplicate\",\n    icon: {\n      type: \"icon\",\n      props: { name: \"ph:copy\" },\n    } satisfies ComponentReference,\n    variant: \"ghost\",\n    // Default visibility: only show when exactly 1 item selected\n    visible: (ctx) => {\n      // For bulk context, ctx.item is an array\n      if (Array.isArray(ctx.item)) {\n        return ctx.item.length === 1;\n      }\n      // For form context, ctx.item is a single item\n      return !!ctx.item;\n    },\n    handler: {\n      type: \"custom\",\n      fn: async (ctx: ActionContext<TItem>) => {\n        // Get the item - either single item or first from array\n        const item = Array.isArray(ctx.item) ? ctx.item[0] : ctx.item;\n        if (!item) return;\n\n        // Clone the item, removing id and timestamps\n        const { id, createdAt, updatedAt, ...data } = item as any;\n\n        // Navigate to create page with prefilled data\n        const createPath = `${ctx.helpers.basePath}/collections/${ctx.collection}/create`;\n        const prefillUrl = buildPrefillUrl(createPath, data);\n        ctx.helpers.navigate(prefillUrl);\n      },\n    },\n    ...opts,\n  };\n}\n\n/**\n * Create a \"Delete Many\" (bulk delete) action\n *\n * Note: The actual deletion is handled by BulkActionToolbar via onBulkDelete callback.\n * This action definition just configures the UI and confirmation.\n */\nfunction createDeleteManyAction<TItem>(\n  opts?: Partial<ActionDefinition<TItem>>,\n): ActionDefinition<TItem> {\n  return {\n    id: \"deleteMany\",\n    label: \"Delete Selected\",\n    icon: {\n      type: \"icon\",\n      props: { name: \"ph:trash\" },\n    } satisfies ComponentReference,\n    variant: \"destructive\",\n    confirmation: {\n      title: \"Delete selected items?\",\n      description:\n        \"This action cannot be undone. All selected items will be permanently deleted.\",\n      confirmLabel: \"Delete All\",\n      destructive: true,\n    },\n    handler: {\n      // Handler is a no-op as deletion is handled by BulkActionToolbar\n      // when it detects action.id === \"deleteMany\" and calls onBulkDelete\n      type: \"custom\",\n      fn: async () => {\n        // No-op: actual deletion handled by BulkActionToolbar.onBulkDelete\n      },\n    },\n    ...opts,\n  };\n}\n\n/**\n * Create a \"Delete\" action for single item (form view)\n */\nfunction createDeleteAction<TItem>(\n  opts?: Partial<ActionDefinition<TItem>>,\n): ActionDefinition<TItem> {\n  return {\n    id: \"delete\",\n    label: \"Delete\",\n    icon: {\n      type: \"icon\",\n      props: { name: \"ph:trash\" },\n    } satisfies ComponentReference,\n    variant: \"destructive\",\n    confirmation: {\n      title: \"Delete item?\",\n      description:\n        \"This action cannot be undone. The item will be permanently deleted.\",\n      confirmLabel: \"Delete\",\n      destructive: true,\n    },\n    handler: {\n      type: \"api\",\n      endpoint: \"{id}\",\n      method: \"DELETE\",\n    },\n    ...opts,\n  };\n}\n\n// ============================================================================\n// Create Action Registry Proxy\n// ============================================================================\n\n/**\n * Creates an action registry proxy for type-safe action building\n */\nexport function createActionRegistryProxy<\n  TItem = any,\n>(): ActionRegistryProxy<TItem> {\n  return {\n    create: (opts) => createCreateAction<TItem>(opts),\n    duplicate: (opts) => createDuplicateAction<TItem>(opts),\n    delete: (opts) => createDeleteAction<TItem>(opts),\n    deleteMany: (opts) => createDeleteManyAction<TItem>(opts),\n    action: (def) => def,\n  };\n}\n\n// ============================================================================\n// Default Actions\n// ============================================================================\n\n/**\n * Get default header actions for a collection\n */\nexport function getDefaultHeaderActions<\n  TItem = any,\n>(): HeaderActionsConfig<TItem> {\n  return {\n    primary: [createCreateAction<TItem>()],\n    secondary: [],\n  };\n}\n\n/**\n * Get default bulk actions for a collection\n */\nexport function getDefaultBulkActions<\n  TItem = any,\n>(): ActionDefinition<TItem>[] {\n  return [createDeleteManyAction<TItem>(), createDuplicateAction<TItem>()];\n}\n\n/**\n * Get default form actions for a collection (edit view)\n */\nexport function getDefaultFormActions<\n  TItem = any,\n>(): FormViewActionsConfig<TItem> {\n  return {\n    primary: [],\n    secondary: [createDuplicateAction<TItem>(), createDeleteAction<TItem>()],\n  };\n}\n\n/**\n * Get complete default actions config\n */\nexport function getDefaultActionsConfig<TItem = any>(): ActionsConfig<TItem> {\n  return {\n    header: getDefaultHeaderActions<TItem>(),\n    bulk: getDefaultBulkActions<TItem>(),\n  };\n}\n"],"mappings":";;;;;;AA4DA,SAAS,mBACP,MACyB;AACzB,QAAO;EACL,IAAI;EACJ,OAAO;EACP,MAAM;GACJ,MAAM;GACN,OAAO,EAAE,MAAM,WAAW;GAC3B;EACD,SAAS;EACT,SAAS;GACP,MAAM;GACN,MAAM;GACP;EACD,GAAG;EACJ;;;;;AAMH,SAAS,sBACP,MACyB;AACzB,QAAO;EACL,IAAI;EACJ,OAAO;EACP,MAAM;GACJ,MAAM;GACN,OAAO,EAAE,MAAM,WAAW;GAC3B;EACD,SAAS;EAET,UAAU,QAAQ;AAEhB,OAAI,MAAM,QAAQ,IAAI,KAAK,CACzB,QAAO,IAAI,KAAK,WAAW;AAG7B,UAAO,CAAC,CAAC,IAAI;;EAEf,SAAS;GACP,MAAM;GACN,IAAI,OAAO,QAA8B;IAEvC,MAAM,OAAO,MAAM,QAAQ,IAAI,KAAK,GAAG,IAAI,KAAK,KAAK,IAAI;AACzD,QAAI,CAAC,KAAM;IAGX,MAAM,EAAE,IAAI,WAAW,WAAW,GAAG,SAAS;IAI9C,MAAM,aAAa,gBADA,GAAG,IAAI,QAAQ,SAAS,eAAe,IAAI,WAAW,UAC1B,KAAK;AACpD,QAAI,QAAQ,SAAS,WAAW;;GAEnC;EACD,GAAG;EACJ;;;;;;;;AASH,SAAS,uBACP,MACyB;AACzB,QAAO;EACL,IAAI;EACJ,OAAO;EACP,MAAM;GACJ,MAAM;GACN,OAAO,EAAE,MAAM,YAAY;GAC5B;EACD,SAAS;EACT,cAAc;GACZ,OAAO;GACP,aACE;GACF,cAAc;GACd,aAAa;GACd;EACD,SAAS;GAGP,MAAM;GACN,IAAI,YAAY;GAGjB;EACD,GAAG;EACJ;;;;;AAMH,SAAS,mBACP,MACyB;AACzB,QAAO;EACL,IAAI;EACJ,OAAO;EACP,MAAM;GACJ,MAAM;GACN,OAAO,EAAE,MAAM,YAAY;GAC5B;EACD,SAAS;EACT,cAAc;GACZ,OAAO;GACP,aACE;GACF,cAAc;GACd,aAAa;GACd;EACD,SAAS;GACP,MAAM;GACN,UAAU;GACV,QAAQ;GACT;EACD,GAAG;EACJ;;;;;AA6BH,SAAgB,0BAEgB;AAC9B,QAAO;EACL,SAAS,CAAC,oBAA2B,CAAC;EACtC,WAAW,EAAE;EACd;;;;;AAMH,SAAgB,wBAEe;AAC7B,QAAO,CAAC,wBAA+B,EAAE,uBAA8B,CAAC;;;;;AAM1E,SAAgB,wBAEkB;AAChC,QAAO;EACL,SAAS,EAAE;EACX,WAAW,CAAC,uBAA8B,EAAE,oBAA2B,CAAC;EACzE;;;;;AAMH,SAAgB,0BAA6D;AAC3E,QAAO;EACL,QAAQ,yBAAgC;EACxC,MAAM,uBAA8B;EACrC"}

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

@@ -0,0 +1,253 @@
+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";
+
+//#region src/client/builder/types/action-types.d.ts
+
+/**
+ * Action helpers provided to action handlers
+ */
+interface ActionHelpers {
+  /** Navigate to a path */
+  navigate: (path: string) => void;
+  /** Show toast notification */
+  toast: {
+    success: (message: string) => void;
+    error: (message: string) => void;
+    info: (message: string) => void;
+    warning: (message: string) => void;
+  };
+  /**
+   * Translate a message key
+   * @param key - Translation key
+   * @param params - Interpolation parameters
+   */
+  t: (key: string, params?: Record<string, unknown>) => string;
+  /**
+   * Invalidate collection queries (triggers refetch)
+   * @param collection - Collection name (defaults to current collection)
+   */
+  invalidateCollection: (collection?: string) => Promise<void>;
+  /**
+   * Invalidate a specific item query
+   * @param id - Item ID
+   * @param collection - Collection name (defaults to current collection)
+   */
+  invalidateItem: (id: string, collection?: string) => Promise<void>;
+  /**
+   * Invalidate all CMS queries
+   */
+  invalidateAll: () => Promise<void>;
+  /**
+   * Refresh the current view/data (alias for invalidateCollection)
+   * @deprecated Use invalidateCollection() instead for clarity
+   */
+  refresh: () => void;
+  /** Close the current dialog */
+  closeDialog: () => void;
+  /** Base path for admin routes */
+  basePath: string;
+}
+/**
+ * Query client interface for advanced query operations
+ */
+interface ActionQueryClient {
+  /** Invalidate queries matching the filter */
+  invalidateQueries: (filters: {
+    queryKey?: readonly unknown[];
+  }) => Promise<void>;
+  /** Refetch queries matching the filter */
+  refetchQueries: (filters: {
+    queryKey?: readonly unknown[];
+  }) => Promise<void>;
+  /** Reset queries matching the filter */
+  resetQueries: (filters: {
+    queryKey?: readonly unknown[];
+  }) => Promise<void>;
+}
+/**
+ * Context provided to action handlers and callbacks
+ */
+interface ActionContext<TItem = any> {
+  /** Item(s) being acted upon - single item for form actions, array for bulk */
+  item?: TItem;
+  /** Multiple items (for bulk actions) */
+  items?: TItem[];
+  /** Collection name */
+  collection: string;
+  /** Action helpers */
+  helpers: ActionHelpers;
+  /** Query client for advanced cache operations */
+  queryClient: ActionQueryClient;
+  /** Auth client for authentication operations (signUp, signIn, etc.) */
+  authClient?: any | null;
+}
+/**
+ * Navigate handler - navigates to a path
+ */
+interface NavigateHandler<TItem = any> {
+  type: "navigate";
+  /** Path to navigate to (can be a function for dynamic paths) */
+  path: string | ((item: TItem) => string);
+}
+/**
+ * Props for dialog components
+ */
+interface ActionDialogProps<TItem = any> {
+  /** Item being acted upon */
+  item?: TItem;
+  /** Multiple items for bulk actions */
+  items?: TItem[];
+  /** Collection name */
+  collection: string;
+  /** Close the dialog */
+  onClose: () => void;
+  /** Success callback */
+  onSuccess?: () => void;
+}
+/**
+ * Dialog handler - opens a dialog component
+ */
+interface DialogHandler<TItem = any> {
+  type: "dialog";
+  /** Component to render in the dialog */
+  component: MaybeLazyComponent<ActionDialogProps<TItem>>;
+}
+/**
+ * Form handler configuration
+ *
+ * Uses FieldDefinition from the admin builder for full field system support.
+ * Fields are validated automatically using buildValidationSchema.
+ */
+interface ActionFormConfig<TItem = any> {
+  /** Dialog title */
+  title: I18nText;
+  /** Dialog description */
+  description?: I18nText;
+  /** Form fields using FieldDefinition */
+  fields: Record<string, FieldDefinition>;
+  /** Default values */
+  defaultValues?: Record<string, any>;
+  /** Submit handler */
+  onSubmit: (data: Record<string, any>, ctx: ActionContext<TItem>) => void | Promise<void>;
+  /** Submit button label */
+  submitLabel?: I18nText;
+  /** Cancel button label */
+  cancelLabel?: I18nText;
+  /** Dialog width */
+  width?: "sm" | "md" | "lg" | "xl";
+}
+/**
+ * Form handler - opens a form dialog
+ */
+interface FormHandler<TItem = any> {
+  type: "form";
+  /** Form configuration */
+  config: ActionFormConfig<TItem>;
+}
+/**
+ * API handler - calls an API endpoint
+ */
+interface ApiHandler {
+  type: "api";
+  /** Endpoint path (can include {id} placeholder) */
+  endpoint: string;
+  /** HTTP method */
+  method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+  /** Request body factory */
+  body?: (ctx: ActionContext) => Record<string, any>;
+}
+/**
+ * Custom handler - runs arbitrary code
+ */
+interface CustomHandler<TItem = any> {
+  type: "custom";
+  /** Handler function */
+  fn: (ctx: ActionContext<TItem>) => void | Promise<void>;
+}
+/**
+ * Server handler - executes action on the server via API.
+ * Used for server-defined actions where the handler runs server-side.
+ */
+interface ServerHandler {
+  type: "server";
+  /** Server action ID (matches ServerActionDefinition.id) */
+  actionId: string;
+  /** Collection name for the action endpoint */
+  collection: string;
+}
+/**
+ * Union of all action handler types
+ */
+type ActionHandler<TItem = any> = NavigateHandler<TItem> | DialogHandler<TItem> | FormHandler<TItem> | ApiHandler | CustomHandler<TItem> | ServerHandler;
+/**
+ * Confirmation dialog configuration
+ */
+interface ConfirmationConfig {
+  /** Dialog title */
+  title: string;
+  /** Dialog description */
+  description?: string;
+  /** Confirm button label */
+  confirmLabel?: string;
+  /** Cancel button label */
+  cancelLabel?: string;
+  /** Use destructive styling */
+  destructive?: boolean;
+}
+/**
+ * Button variant types (matching shadcn button variants)
+ */
+type ActionVariant = "default" | "destructive" | "outline" | "secondary" | "ghost" | "link";
+/**
+ * Complete action definition
+ */
+interface ActionDefinition<TItem = any> {
+  /** Unique action identifier */
+  id: string;
+  /** Display label */
+  label: I18nText;
+  /** Icon component or server-defined component reference */
+  icon?: IconComponent | ComponentReference;
+  /** Button variant */
+  variant?: ActionVariant;
+  /** Whether action is visible (static or dynamic) */
+  visible?: boolean | ((ctx: ActionContext<TItem>) => boolean);
+  /** Whether action is disabled (static or dynamic) */
+  disabled?: boolean | ((ctx: ActionContext<TItem>) => boolean);
+  /** Action handler */
+  handler: ActionHandler<TItem>;
+  /** 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

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

@@ -0,0 +1 @@
+{"version":3,"file":"action-types.d.mts","names":[],"sources":["../../../../src/client/builder/types/action-types.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAoEA;;;AAQgE,UArD/C,aAAA,CAqD+C;EAAO;EAMtD,QAAA,EAAA,CAAA,IAAA,EAAa,MAAA,EAAA,GAAA,IAAA;EAErB;EAEC,KAAA,EAAA;IAIC,OAAA,EAAA,CAAA,OAAA,EAAA,MAAA,EAAA,GAAA,IAAA;IAEI,KAAA,EAAA,CAAA,OAAA,EAAA,MAAA,EAAA,GAAA,IAAA;IAAiB,IAAA,EAAA,CAAA,OAAA,EAAA,MAAA,EAAA,GAAA,IAAA;IAYf,OAAA,EAAA,CAAA,OAAe,EAAA,MAAA,EAAA,GAAA,IAGP;EAMR,CAAA;EAgBA;;;;;EAYA,CAAA,EAAA,CAAA,GAAA,EAAA,MAAA,EAAA,MAAgB,CAAA,EAvGL,MAuGK,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,GAAA,MAAA;EAExB;;;;EAMS,oBAAA,EAAA,CAAA,UAAA,CAAA,EAAA,MAAA,EAAA,GA1G+B,OA0G/B,CAAA,IAAA,CAAA;EAGR;;;;;EAMM,cAAA,EAAA,CAAA,EAAA,EAAA,MAAA,EAAA,UAAA,CAAA,EAAA,MAAA,EAAA,GA7GuC,OA6GvC,CAAA,IAAA,CAAA;EAAQ;AAQxB;AASA;EAaiB,aAAA,EAAA,GAAa,GAvIP,OAuIO,CAAA,IAAA,CAAA;EAGJ;;;;EAOT,OAAA,EAAA,GAAA,GAAA,IAAa;EAWlB;EACQ,WAAA,EAAA,GAAA,GAAA,IAAA;EAAhB;EACc,QAAA,EAAA,MAAA;;;;;AAGA,UAlJD,iBAAA,CAkJC;EAAd;EACA,iBAAA,EAAA,CAAA,OAAA,EAAA;IAAa,QAAA,CAAA,EAAA,SAAA,OAAA,EAAA;EASA,CAAA,EAAA,GAxJT,OAwJS,CAAA,IAAA,CAAA;EAoBL;EAWK,cAAA,EAAA,CAAA,OAAgB,EAAA;IAIxB,QAAA,CAAA,EAAA,SAAA,OAAA,EAAA;EAEA,CAAA,EAAA,GA3LyD,OA2LzD,CAAA,IAAA,CAAA;EAAgB;EAEb,YAAA,EAAA,CAAA,OAAA,EAAA;IAE+B,QAAA,CAAA,EAAA,SAAA,OAAA,EAAA;EAAd,CAAA,EAAA,GA7LmC,OA6LnC,CAAA,IAAA,CAAA;;;;;AAMZ,UA7LA,aA6LA,CAAA,QAAA,GAAA,CAAA,CAAA;EAAkB;EAkBlB,IAAA,CAAA,EA7MR,KA6MQ;EAEY;EAAjB,KAAA,CAAA,EA7MF,KA6ME,EAAA;EAEmB;EAAjB,UAAA,EAAA,MAAA;EAAgB;EAMb,OAAA,EAjNN,aAiNmB;EAEC;EAApB,WAAA,EAjNI,iBAiNJ;EAEe;EAAjB,UAAA,CAAA,EAAA,GAAA,GAAA,IAAA;;;;;UAvMQ;;;yBAGQ;;;;;UAMR;;SAER;;UAEC;;;;;;;;;;;UAYO;;;aAGJ,mBAAmB,kBAAkB;;;;;;;;UASjC;;SAER;;gBAEO;;UAEN,eAAe;;kBAEP;;mBAGR,0BACD,cAAc,kBACT;;gBAEE;;gBAEA;;;;;;;UAQC;;;UAGP,iBAAiB;;;;;UAMV,UAAA;;;;;;;eAOF,kBAAkB;;;;;UAMhB;;;YAGL,cAAc,kBAAkB;;;;;;UAO3B,aAAA;;;;;;;;;;KAWL,6BACR,gBAAgB,SAChB,cAAc,SACd,YAAY,SACZ,aACA,cAAc,SACd;;;;UASa,kBAAA;;;;;;;;;;;;;;;KAoBL,aAAA;;;;UAWK;;;;SAIR;;SAEA,gBAAgB;;YAEb;;6BAEiB,cAAc;;8BAEb,cAAc;;WAEjC,cAAc;;iBAER;;;;;;;;;;;;;UAkBA;;YAEL,iBAAiB;;cAEf,iBAAiB;;;;;UAMd;;WAEN,oBAAoB;;SAEtB,iBAAiB"}

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

@@ -0,0 +1,199 @@
+import { I18nText } from "../../i18n/types.mjs";
+import { IconComponent, MaybeLazyComponent } from "./common.mjs";
+import { ComponentReference } from "../../../server/augmentation.mjs";
+import "../../../server/index.mjs";
+import { ActionsConfig } from "./action-types.mjs";
+import "./field-types.mjs";
+import { FieldDefinition } from "../field/field.mjs";
+import { AdminBuilder } from "../admin-builder.mjs";
+
+//#region src/client/builder/types/collection-types.d.ts
+
+/**
+ * Column configuration for list views
+ * Can be a simple field name or detailed config object
+ */
+type ColumnConfig<TFieldNames extends string = string> = TFieldNames | ColumnConfigObject<TFieldNames>;
+/**
+ * Detailed column configuration object
+ */
+interface ColumnConfigObject<TFieldNames extends string = string> {
+  /**
+   * Field name to display
+   */
+  field: TFieldNames;
+  /**
+   * Custom header label (defaults to field label)
+   */
+  header?: string;
+  /**
+   * Column width (CSS value like "200px", "20%", etc.)
+   */
+  width?: string | number;
+  /**
+   * Minimum column width
+   */
+  minWidth?: string | number;
+  /**
+   * Maximum column width
+   */
+  maxWidth?: string | number;
+  /**
+   * Enable sorting for this column
+   * @default true
+   */
+  sortable?: boolean;
+  /**
+   * Custom cell renderer component
+   * Overrides the field's default cell component
+   */
+  cell?: MaybeLazyComponent;
+  /**
+   * Column visibility
+   * Can be a boolean or function for conditional visibility
+   */
+  visible?: boolean | ((row: any) => boolean);
+  /**
+   * Custom CSS class for column cells
+   */
+  className?: string;
+  /**
+   * Text alignment
+   */
+  align?: "left" | "center" | "right";
+}
+/**
+ * List view configuration
+ */
+interface ListViewConfig<TFieldNames extends string = string> {
+  /**
+   * Columns to display (field names or column configs)
+   */
+  columns?: ColumnConfig<TFieldNames>[];
+  /**
+   * Relations to include in query
+   */
+  with?: string[];
+  /**
+   * Default sort
+   */
+  defaultSort?: {
+    field: TFieldNames;
+    direction: "asc" | "desc";
+  };
+  /**
+   * Enable search
+   * @default true
+   */
+  searchable?: boolean;
+  /**
+   * Searchable fields (defaults to all text-like fields)
+   */
+  searchFields?: TFieldNames[];
+  /**
+   * Enable row selection
+   * @default false
+   */
+  selectable?: boolean;
+  /**
+   * Enable pagination
+   * @default true
+   */
+  paginated?: boolean;
+  /**
+   * Enable realtime invalidation for list queries.
+   * Falls back to AdminProvider realtime config when undefined.
+   */
+  realtime?: boolean;
+  /**
+   * Default page size
+   * @default 25
+   */
+  pageSize?: number;
+  /**
+   * Available page size options
+   * @default [10, 25, 50, 100]
+   */
+  pageSizeOptions?: number[];
+  /**
+   * Actions configuration for list view
+   */
+  actions?: ActionsConfig;
+}
+/**
+ * Preview configuration for live preview in form view
+ */
+interface PreviewConfig {
+  /**
+   * URL builder function that returns preview URL for current form values
+   * @param values - Current form values
+   * @param locale - Current content locale
+   * @returns Preview URL string
+   */
+  url: (values: Record<string, unknown>, locale: string) => string;
+  /**
+   * Whether preview is enabled (default: true)
+   */
+  enabled?: boolean;
+  /**
+   * Position of the preview panel (default: "right")
+   */
+  position?: "right" | "bottom";
+  /**
+   * Default width/height percentage of preview panel (default: 50)
+   */
+  defaultWidth?: number;
+  /**
+   * Minimum width/height percentage (default: 30)
+   */
+  minWidth?: number;
+  /**
+   * Maximum width/height percentage (default: 70)
+   */
+  maxWidth?: number;
+}
+/**
+ * Autosave configuration for form view
+ */
+interface AutoSaveConfig {
+  /**
+   * Whether autosave is enabled
+   * @default false
+   */
+  enabled?: boolean;
+  /**
+   * Debounce delay in milliseconds before autosave triggers
+   * @default 500 (0.5s as specified)
+   */
+  debounce?: number;
+  /**
+   * Show autosave status indicator in form header
+   * @default true
+   */
+  indicator?: boolean;
+  /**
+   * Warn user before navigating away with unsaved changes
+   * @default true
+   */
+  preventNavigation?: boolean;
+}
+/**
+ * Collection builder state - internal state during building
+ */
+interface CollectionBuilderState<TAdminApp extends AdminBuilder<any> = AdminBuilder<any>> {
+  readonly name: string;
+  readonly "~adminApp": TAdminApp;
+  /** Display label - supports inline translations */
+  readonly label?: I18nText;
+  /** Description - supports inline translations */
+  readonly description?: I18nText;
+  readonly icon?: IconComponent | ComponentReference;
+  readonly fields?: Record<string, FieldDefinition<any, any>>;
+  readonly list?: any;
+  readonly form?: any;
+  readonly preview?: PreviewConfig;
+  readonly autoSave?: AutoSaveConfig;
+}
+//#endregion
+export { AutoSaveConfig, CollectionBuilderState, ColumnConfig, ColumnConfigObject, ListViewConfig, PreviewConfig };
+//# sourceMappingURL=collection-types.d.mts.map