@nextlyhq/plugin-form-builder 0.0.2-alpha.7 → 0.0.2-alpha.71

package/dist/index.d.ts

@@ -1,28 +1,15 @@
-import * as nextly from 'nextly';
-import { PluginDefinition, CollectionConfig, PluginContext } from 'nextly';
-import { R as ResolvedFormBuilderConfig, F as FormBuilderPluginOptions, a as FormConfig, b as FormSettings, c as FormNotifications, C as CheckboxFormField, D as DateFormField, E as EmailFormField, d as FileFormField, H as HiddenFormField, N as NumberFormField, P as PhoneFormField, e as RadioFormField, S as SelectFormField, T as TextFormField, f as TextareaFormField, g as TimeFormField, U as UrlFormField, h as ConditionalLogic, i as FormField, j as SubmissionDocument, k as FormDocument, W as WebhookEvent } from './index-C0kBvYjm.js';
-export { B as BaseFormField, l as ConditionalLogicCondition, m as EmailConfig, n as FieldBlockConfig, o as FormAccess, p as FormFieldType, q as FormHookContext, r as FormHooks, s as FormSubmission, t as SubmissionDetailProps, u as SubmissionListProps, V as ValidationRules, v as WebhookConfig, w as isCheckboxFormField, x as isEmailFormField, y as isFileFormField, z as isFormField, A as isFormFieldType, G as isSelectFormField, I as isTextFormField } from './index-C0kBvYjm.js';
-import { z } from 'zod';
-import 'react';
-
-/**
- * Form Builder Plugin
- *
- * Visual form builder with drag-and-drop UI, submission management,
- * email notifications, and spam protection.
- *
- * @module plugin
- * @since 0.1.0
- */
-
+import { A as RadioFormField, B as isEmailFormField, C as FormNotificationItem, D as HiddenFormField, E as FormSubmission, F as TextareaFormField, G as isSelectFormField, H as isFormField, I as TimeFormField, K as isTextFormField, L as UrlFormField, M as SelectFormField, N as SubmissionDocument, O as NumberFormField, P as TextFormField, R as ValidationRules, S as FormNotification, T as FormSettings, U as isFormFieldType, V as isFileFormField, W as isKnownFormField, _ as FormField, a as ConditionalLogic, b as FormHookContext, c as DateFormField, d as FieldBlockConfig, f as FileFormField, g as FormDocument, h as FormConfig, i as CheckboxFormField, j as ResolvedFormBuilderConfig, k as PhoneFormField, l as EmailConfig, m as FormBuilderPluginOptions, n as BUILT_IN_FORM_FIELD_TYPES, o as ConditionalLogicCondition, p as FormAccess, r as BaseFormField, s as CustomFormField, t as AnyFormField, u as EmailFormField, v as FormFieldType, w as FormNotifications, x as FormHooks, y as FormFieldTypeId, z as isCheckboxFormField } from "./types-BHReIA0j.js";
+import { PluginDefinition } from "@nextlyhq/plugin-sdk";
+import { CollectionConfig, PluginContext } from "nextly";
+import { z } from "zod";
 type NextlyPlugin = PluginDefinition;
 interface FormBuilderPluginResult {
-    /** Plugin definition — pass to `defineConfig({ plugins: [...] })`. */
-    plugin: NextlyPlugin;
-    /** Forms & Submissions collections (also auto-added by the plugin). */
-    collections: CollectionConfig[];
-    /** Resolved configuration with all defaults applied. */
-    config: ResolvedFormBuilderConfig;
+  /** Plugin definition — pass to `defineConfig({ plugins: [...] })`. */
+  plugin: NextlyPlugin;
+  /** Forms & Submissions collections (also auto-added by the plugin). */
+  collections: CollectionConfig[];
+  /** Resolved configuration with all defaults applied. */
+  config: ResolvedFormBuilderConfig;
 }
 /**
  * Create a Form Builder plugin instance.
@@ -51,41 +38,16 @@ interface FormBuilderPluginResult {
  * });
  * ```
  */
-declare function formBuilder(options?: FormBuilderPluginOptions): FormBuilderPluginResult;
+export declare function formBuilder(options?: FormBuilderPluginOptions): FormBuilderPluginResult;
 /**
  * Retrieve the resolved Form Builder config from a Nextly plugin context.
  */
-declare function getFormBuilderConfig(nextly: unknown): ResolvedFormBuilderConfig | undefined;
-
-/**
- * Form Configuration Validator
- *
- * Provides comprehensive validation for form configurations including:
- * - Slug validation (format, reserved names)
- * - Field name validation (format, duplicates)
- * - Field-specific validation (select/radio options, min/max constraints)
- * - Conditional logic validation
- * - Nested field validation
- *
- * @module config/validate-form
- * @since 1.0.0
- *
- * @example
- * ```typescript
- * import { validateFormConfig } from '@nextly/plugin-form-builder';
- *
- * const result = validateFormConfig(config);
- * if (!result.valid) {
- *   console.error('Validation errors:', result.errors);
- * }
- * ```
- */
-
+export declare function getFormBuilderConfig(nextly: unknown): ResolvedFormBuilderConfig | undefined;
 /**
  * Error codes for form validation failures.
  * Used for programmatic error handling.
  */
-type FormValidationErrorCode = "SLUG_REQUIRED" | "SLUG_INVALID_TYPE" | "SLUG_TOO_SHORT" | "SLUG_TOO_LONG" | "SLUG_INVALID_FORMAT" | "SLUG_RESERVED" | "FIELDS_REQUIRED" | "FIELDS_INVALID_TYPE" | "FIELDS_EMPTY" | "FIELD_NAME_REQUIRED" | "FIELD_NAME_INVALID_FORMAT" | "FIELD_NAME_DUPLICATE" | "FIELD_TYPE_REQUIRED" | "FIELD_TYPE_INVALID" | "FIELD_LABEL_REQUIRED" | "OPTIONS_REQUIRED" | "OPTIONS_EMPTY" | "MIN_GREATER_THAN_MAX" | "MIN_LENGTH_GREATER_THAN_MAX" | "FILE_MAX_SIZE_INVALID" | "CONDITIONS_REQUIRED" | "CONDITION_FIELD_REQUIRED" | "CONDITION_COMPARISON_REQUIRED" | "SETTINGS_INVALID_TYPE" | "REDIRECT_URL_REQUIRED" | "ACCESS_INVALID_TYPE" | "ACCESS_FUNCTION_INVALID";
+type FormValidationErrorCode = "SLUG_REQUIRED" | "SLUG_INVALID_TYPE" | "SLUG_TOO_SHORT" | "SLUG_TOO_LONG" | "SLUG_INVALID_FORMAT" | "SLUG_RESERVED" | "FIELDS_REQUIRED" | "FIELDS_INVALID_TYPE" | "FIELDS_EMPTY" | "FIELD_NAME_REQUIRED" | "FIELD_NAME_INVALID_FORMAT" | "FIELD_NAME_DUPLICATE" | "FIELD_TYPE_REQUIRED" | "FIELD_TYPE_INVALID" | "FIELD_LABEL_REQUIRED" | "OPTIONS_REQUIRED" | "OPTIONS_EMPTY" | "MIN_GREATER_THAN_MAX" | "MIN_LENGTH_GREATER_THAN_MAX" | "FILE_MAX_SIZE_INVALID" | "CONDITIONS_REQUIRED" | "CONDITION_FIELD_REQUIRED" | "CONDITION_COMPARISON_REQUIRED" | "SETTINGS_INVALID_TYPE" | "REDIRECT_URL_REQUIRED" | "REDIRECT_PAGE_REQUIRED" | "ACCESS_INVALID_TYPE" | "ACCESS_FUNCTION_INVALID";
 /**
  * A single validation error with path and context.
  *
@@ -99,38 +61,38 @@ type FormValidationErrorCode = "SLUG_REQUIRED" | "SLUG_INVALID_TYPE" | "SLUG_TOO
  * ```
  */
 interface FormValidationError {
-    /**
-     * Dot-notation path to the invalid property.
-     * @example 'slug', 'fields.0.name', 'fields.email.options'
-     */
-    path: string;
-    /**
-     * Human-readable error message.
-     */
-    message: string;
-    /**
-     * Machine-readable error code for programmatic handling.
-     */
-    code: FormValidationErrorCode;
+  /**
+   * Dot-notation path to the invalid property.
+   * @example 'slug', 'fields.0.name', 'fields.email.options'
+   */
+  path: string;
+  /**
+   * Human-readable error message.
+   */
+  message: string;
+  /**
+   * Machine-readable error code for programmatic handling.
+   */
+  code: FormValidationErrorCode;
 }
 /**
  * Result of form config validation.
  */
 interface FormValidationResult {
-    /**
-     * Whether the configuration is valid.
-     */
-    valid: boolean;
-    /**
-     * Array of validation errors (empty if valid).
-     */
-    errors: FormValidationError[];
+  /**
+   * Whether the configuration is valid.
+   */
+  valid: boolean;
+  /**
+   * Array of validation errors (empty if valid).
+   */
+  errors: FormValidationError[];
 }
 /**
  * Reserved form slugs that cannot be used.
  * These are used by the system or have special meaning.
  */
-declare const RESERVED_FORM_SLUGS: readonly ["api", "submit", "submissions", "export", "admin", "new", "create", "edit", "delete"];
+export declare const RESERVED_FORM_SLUGS: readonly ["api", "submit", "submissions", "export", "admin", "new", "create", "edit", "delete"];
 /**
  * Validates a complete form configuration.
  *
@@ -168,7 +130,7 @@ declare const RESERVED_FORM_SLUGS: readonly ["api", "submit", "submissions", "ex
  * }
  * ```
  */
-declare function validateFormConfig(config: FormConfig): FormValidationResult;
+export declare function validateFormConfig(config: FormConfig): FormValidationResult;
 /**
  * Throws an error if the form configuration is invalid.
  *
@@ -186,42 +148,15 @@ declare function validateFormConfig(config: FormConfig): FormValidationResult;
  * assertValidFormConfig(config);
  * ```
  */
-declare function assertValidFormConfig(config: FormConfig): void;
-
-/**
- * Form Configuration Defaults
- *
- * Applies default values to form configurations, ensuring all required
- * properties have sensible defaults while preserving user-specified values.
- *
- * @module config/defaults
- * @since 1.0.0
- *
- * @example
- * ```typescript
- * import { applyFormDefaults } from '@nextly/plugin-form-builder';
- *
- * const config = {
- *   slug: 'contact-form',
- *   fields: [
- *     { type: 'text', name: 'name', label: 'Name' },
- *     { type: 'email', name: 'email', label: 'Email' },
- *   ],
- * };
- *
- * const configWithDefaults = applyFormDefaults(config);
- * // configWithDefaults now has labels, settings, etc. with defaults applied
- * ```
- */
-
+export declare function assertValidFormConfig(config: FormConfig): void;
 /**
  * Default form settings.
  */
-declare const DEFAULT_FORM_SETTINGS: Required<Pick<FormSettings, "submitButtonText" | "confirmationType" | "successMessage" | "allowMultipleSubmissions">>;
+export declare const DEFAULT_FORM_SETTINGS: Required<Pick<FormSettings, "submitButtonText" | "confirmationType" | "successMessage" | "allowMultipleSubmissions">>;
 /**
  * Default notification settings.
  */
-declare const DEFAULT_NOTIFICATION_SETTINGS: Pick<FormNotifications, "enabled" | "replyTo">;
+export declare const DEFAULT_NOTIFICATION_SETTINGS: Pick<FormNotifications, "enabled" | "replyTo">;
 /**
  * Converts a slug to title case.
  *
@@ -234,7 +169,7 @@ declare const DEFAULT_NOTIFICATION_SETTINGS: Pick<FormNotifications, "enabled" |
  * toTitleCase('newsletter_signup'); // 'Newsletter Signup'
  * ```
  */
-declare function toTitleCase(str: string): string;
+export declare function toTitleCase(str: string): string;
 /**
  * Generates a plural form from a singular label.
  * Handles common English pluralization rules.
@@ -249,7 +184,7 @@ declare function toTitleCase(str: string): string;
  * pluralize('Quiz'); // 'Quizzes'
  * ```
  */
-declare function pluralize(singular: string): string;
+export declare function pluralize(singular: string): string;
 /**
  * Apply default values to form configuration.
  *
@@ -292,7 +227,7 @@ declare function pluralize(singular: string): string;
  * // }
  * ```
  */
-declare function applyFormDefaults(config: FormConfig): FormConfig;
+export declare function applyFormDefaults(config: FormConfig): FormConfig;
 /**
  * Apply default values to individual form field.
  *
@@ -311,11 +246,11 @@ declare function applyFormDefaults(config: FormConfig): FormConfig;
  * // { type: 'text', name: 'firstName', label: 'First Name', required: false }
  * ```
  */
-declare function applyFieldDefaults<T extends {
-    type: string;
-    name?: string;
-    label?: string;
-    required?: boolean;
+export declare function applyFieldDefaults<T extends {
+  type: string;
+  name?: string;
+  label?: string;
+  required?: boolean;
 }>(field: T): T;
 /**
  * Creates a complete form config with minimal input.
@@ -339,51 +274,13 @@ declare function applyFieldDefaults<T extends {
  * ]);
  * ```
  */
-declare function createFormConfig(slug: string, fields: FormConfig["fields"], options?: Partial<Omit<FormConfig, "slug" | "fields">>): FormConfig;
-
-/**
- * Form Field Helpers
- *
- * Convenient factory functions for creating form field configurations.
- * These helpers eliminate the need to manually specify the `type` property,
- * providing a cleaner, more ergonomic API for form definitions.
- *
- * @module config/field-helpers
- *
- * @example
- * ```typescript
- * import {
- *   text,
- *   email,
- *   select,
- *   checkbox,
- *   option,
- * } from '@nextly/plugin-form-builder';
- *
- * const contactFormFields = [
- *   text({ name: 'firstName', label: 'First Name', required: true }),
- *   text({ name: 'lastName', label: 'Last Name', required: true }),
- *   email({ name: 'email', label: 'Email Address', required: true }),
- *   select({
- *     name: 'subject',
- *     label: 'Subject',
- *     options: [
- *       option('General Inquiry'),
- *       option('Support Request'),
- *       option('Feedback'),
- *     ],
- *   }),
- *   checkbox({ name: 'subscribe', label: 'Subscribe to newsletter' }),
- * ];
- * ```
- */
-
+export declare function createFormConfig(slug: string, fields: FormConfig["fields"], options?: Partial<Omit<FormConfig, "slug" | "fields">>): FormConfig;
 /**
  * Option for select and radio fields.
  */
 interface FormFieldOption {
-    label: string;
-    value: string;
+  label: string;
+  value: string;
 }
 /**
  * Creates an option for select or radio fields.
@@ -415,7 +312,7 @@ interface FormFieldOption {
  * })
  * ```
  */
-declare const option: (label: string, value?: string) => FormFieldOption;
+export declare const option: (label: string, value?: string) => FormFieldOption;
 /**
  * Creates a text input field configuration.
  *
@@ -444,7 +341,7 @@ declare const option: (label: string, value?: string) => FormFieldOption;
  * })
  * ```
  */
-declare const text: (config: Omit<TextFormField, "type">) => TextFormField;
+export declare const text: (config: Omit<TextFormField, "type">) => TextFormField;
 /**
  * Creates an email input field configuration.
  *
@@ -463,11 +360,11 @@ declare const text: (config: Omit<TextFormField, "type">) => TextFormField;
  *   name: 'workEmail',
  *   label: 'Work Email',
  *   required: true,
- *   placeholder: 'you@company.com',
+ *   placeholder: 'you@nextly.local',
  * })
  * ```
  */
-declare const email: (config: Omit<EmailFormField, "type">) => EmailFormField;
+export declare const email: (config: Omit<EmailFormField, "type">) => EmailFormField;
 /**
  * Creates a phone input field configuration.
  *
@@ -490,7 +387,7 @@ declare const email: (config: Omit<EmailFormField, "type">) => EmailFormField;
  * })
  * ```
  */
-declare const phone: (config: Omit<PhoneFormField, "type">) => PhoneFormField;
+export declare const phone: (config: Omit<PhoneFormField, "type">) => PhoneFormField;
 /**
  * Creates a URL input field configuration.
  *
@@ -512,7 +409,7 @@ declare const phone: (config: Omit<PhoneFormField, "type">) => PhoneFormField;
  * })
  * ```
  */
-declare const url: (config: Omit<UrlFormField, "type">) => UrlFormField;
+export declare const url: (config: Omit<UrlFormField, "type">) => UrlFormField;
 /**
  * Creates a textarea field configuration.
  *
@@ -539,7 +436,7 @@ declare const url: (config: Omit<UrlFormField, "type">) => UrlFormField;
  * })
  * ```
  */
-declare const textarea: (config: Omit<TextareaFormField, "type">) => TextareaFormField;
+export declare const textarea: (config: Omit<TextareaFormField, "type">) => TextareaFormField;
 /**
  * Creates a number input field configuration.
  *
@@ -567,7 +464,7 @@ declare const textarea: (config: Omit<TextareaFormField, "type">) => TextareaFor
  * })
  * ```
  */
-declare const number: (config: Omit<NumberFormField, "type">) => NumberFormField;
+export declare const number: (config: Omit<NumberFormField, "type">) => NumberFormField;
 /**
  * Creates a select dropdown field configuration.
  *
@@ -604,7 +501,7 @@ declare const number: (config: Omit<NumberFormField, "type">) => NumberFormField
  * })
  * ```
  */
-declare const select: (config: Omit<SelectFormField, "type">) => SelectFormField;
+export declare const select: (config: Omit<SelectFormField, "type">) => SelectFormField;
 /**
  * Creates a single checkbox field configuration.
  *
@@ -630,7 +527,7 @@ declare const select: (config: Omit<SelectFormField, "type">) => SelectFormField
  * })
  * ```
  */
-declare const checkbox: (config: Omit<CheckboxFormField, "type">) => CheckboxFormField;
+export declare const checkbox: (config: Omit<CheckboxFormField, "type">) => CheckboxFormField;
 /**
  * Creates a radio group field configuration.
  *
@@ -654,7 +551,7 @@ declare const checkbox: (config: Omit<CheckboxFormField, "type">) => CheckboxFor
  * })
  * ```
  */
-declare const radio: (config: Omit<RadioFormField, "type">) => RadioFormField;
+export declare const radio: (config: Omit<RadioFormField, "type">) => RadioFormField;
 /**
  * Creates a file upload field configuration.
  *
@@ -685,7 +582,7 @@ declare const radio: (config: Omit<RadioFormField, "type">) => RadioFormField;
  * })
  * ```
  */
-declare const file: (config: Omit<FileFormField, "type">) => FileFormField;
+export declare const file: (config: Omit<FileFormField, "type">) => FileFormField;
 /**
  * Creates a date picker field configuration.
  *
@@ -709,7 +606,7 @@ declare const file: (config: Omit<FileFormField, "type">) => FileFormField;
  * })
  * ```
  */
-declare const date: (config: Omit<DateFormField, "type">) => DateFormField;
+export declare const date: (config: Omit<DateFormField, "type">) => DateFormField;
 /**
  * Creates a time picker field configuration.
  *
@@ -731,7 +628,7 @@ declare const date: (config: Omit<DateFormField, "type">) => DateFormField;
  * })
  * ```
  */
-declare const time: (config: Omit<TimeFormField, "type">) => TimeFormField;
+export declare const time: (config: Omit<TimeFormField, "type">) => TimeFormField;
 /**
  * Creates a hidden field configuration.
  *
@@ -751,37 +648,7 @@ declare const time: (config: Omit<TimeFormField, "type">) => TimeFormField;
  * hidden({ name: 'campaign', label: 'Campaign', defaultValue: 'summer-sale' })
  * ```
  */
-declare const hidden: (config: Omit<HiddenFormField, "type">) => HiddenFormField;
-
-/**
- * Conditional Logic Evaluator
- *
- * Evaluates conditional logic rules to determine field visibility in forms.
- * Used by the FormRenderer component to show/hide fields based on user input.
- *
- * @module utils/evaluate-conditions
- * @since 1.0.0
- *
- * @example
- * ```typescript
- * import { evaluateConditions } from '@nextly/plugin-form-builder';
- *
- * const conditionalLogic = {
- *   enabled: true,
- *   action: 'show',
- *   operator: 'AND',
- *   conditions: [
- *     { field: 'country', comparison: 'equals', value: 'US' },
- *     { field: 'age', comparison: 'greaterThan', value: 18 },
- *   ],
- * };
- *
- * const formData = { country: 'US', age: 25 };
- * const isVisible = evaluateConditions(conditionalLogic, formData);
- * // isVisible = true (all conditions met, action is 'show')
- * ```
- */
-
+export declare const hidden: (config: Omit<HiddenFormField, "type">) => HiddenFormField;
 /**
  * Comparison operators supported by the conditional logic system.
  */
@@ -847,31 +714,20 @@ type ComparisonOperator = "equals" | "notEquals" | "contains" | "isEmpty" | "isN
  * evaluateConditions(orLogic, { role: 'viewer' }); // false
  * ```
  */
-declare function evaluateConditions(logic: ConditionalLogic | undefined, formData: Record<string, unknown>): boolean;
+export declare function evaluateConditions(logic: ConditionalLogic | undefined, formData: Record<string, unknown>): boolean;
 /**
  * Checks if a comparison operator is valid.
  *
  * @param operator - The operator to check
  * @returns Whether the operator is valid
  */
-declare function isValidComparisonOperator(operator: string): operator is ComparisonOperator;
+export declare function isValidComparisonOperator(operator: string): operator is ComparisonOperator;
 /**
  * Gets the list of supported comparison operators.
  *
  * @returns Array of supported operator names
  */
-declare function getSupportedComparisonOperators(): ComparisonOperator[];
-
-/**
- * Dynamic Zod Schema Generator
- *
- * Converts FormField[] configuration to Zod validation schemas.
- * Supports all form field types with proper validation rules.
- *
- * @module utils/generate-schema
- * @since 0.1.0
- */
-
+export declare function getSupportedComparisonOperators(): ComparisonOperator[];
 /**
  * Generate a Zod validation schema from form field configuration.
  *
@@ -893,7 +749,7 @@ declare function getSupportedComparisonOperators(): ComparisonOperator[];
  * const result = schema.safeParse({ firstName: 'John', email: 'john@example.com', age: 25 });
  * ```
  */
-declare function generateZodSchema(fields: FormField[]): z.ZodObject<Record<string, z.ZodTypeAny>>;
+export declare function generateZodSchema(fields: AnyFormField[]): z.ZodObject<Record<string, z.ZodTypeAny>>;
 /**
  * Transform form data before validation.
  *
@@ -907,7 +763,7 @@ declare function generateZodSchema(fields: FormField[]): z.ZodObject<Record<stri
  * @param fields - Form field configurations
  * @returns Transformed data ready for validation
  */
-declare function transformFormData(data: Record<string, unknown>, fields: FormField[]): Record<string, unknown>;
+export declare function transformFormData(data: Record<string, unknown>, fields: AnyFormField[]): Record<string, unknown>;
 /**
  * Validate form data against a form's field configuration.
  *
@@ -928,92 +784,94 @@ declare function transformFormData(data: Record<string, unknown>, fields: FormFi
  * }
  * ```
  */
-declare function validateFormData(data: Record<string, unknown>, fields: FormField[]): z.SafeParseReturnType<Record<string, unknown>, Record<string, unknown>>;
+export declare function validateFormData(data: Record<string, unknown>, fields: AnyFormField[]): z.ZodSafeParseResult<Record<string, unknown>>;
 /**
  * Get validation errors as a flat object.
  *
  * @param result - Zod safe parse result
  * @returns Object mapping field names to error messages
  */
-declare function getValidationErrors(result: z.SafeParseReturnType<unknown, unknown>): Record<string, string>;
-
+/** A field that failed, with the machine code a wire error reports. */
+interface ValidationIssue {
+  path: string;
+  /** `REQUIRED` for an answer that is missing or empty, else `INVALID`. */
+  code: "REQUIRED" | "INVALID";
+  message: string;
+}
 /**
- * Export Formats Utilities
- *
- * Pure utility functions for exporting form submissions to CSV and JSON formats.
- * These functions generate formatted strings that can be used for file downloads
- * or API responses.
+ * The same failures as a field-to-message map.
  *
- * @module utils/export-formats
- * @since 0.1.0
+ * Derived from {@link getValidationIssues} rather than walking the issues a
+ * second time, so the two cannot disagree about which message belongs to a
+ * field or which failure won when one field had several.
  */
-
+export declare function getValidationErrors(result: z.ZodSafeParseResult<unknown>): Record<string, string>;
 /**
  * Options for CSV export.
  */
 interface CSVExportOptions {
-    /**
-     * Whether to include metadata columns (_id, _status, _submittedAt, etc.).
-     * @default true
-     */
-    includeMetadata?: boolean;
-    /**
-     * Delimiter character for CSV.
-     * @default ","
-     */
-    delimiter?: string;
-    /**
-     * Whether to include UTF-8 BOM for Excel compatibility.
-     * @default true
-     */
-    includeBOM?: boolean;
-    /**
-     * Date format for timestamps.
-     * @default "iso" (ISO 8601)
-     */
-    dateFormat?: "iso" | "locale";
+  /**
+   * Whether to include metadata columns (_id, _status, _submittedAt, etc.).
+   * @default true
+   */
+  includeMetadata?: boolean;
+  /**
+   * Delimiter character for CSV.
+   * @default ","
+   */
+  delimiter?: string;
+  /**
+   * Whether to include UTF-8 BOM for Excel compatibility.
+   * @default true
+   */
+  includeBOM?: boolean;
+  /**
+   * Date format for timestamps.
+   * @default "iso" (ISO 8601)
+   */
+  dateFormat?: "iso" | "locale";
 }
 /**
  * Options for JSON export.
  */
 interface JSONExportOptions {
-    /**
-     * Whether to include metadata in each submission.
-     * @default true
-     */
-    includeMetadata?: boolean;
-    /**
-     * Whether to include form definition in the export.
-     * @default true
-     */
-    includeFormDefinition?: boolean;
-    /**
-     * Number of spaces for indentation (0 for minified).
-     * @default 2
-     */
-    indent?: number;
+  /**
+   * Whether to include metadata in each submission.
+   * @default true
+   */
+  includeMetadata?: boolean;
+  /**
+   * Whether to include form definition in the export.
+   * @default true
+   */
+  includeFormDefinition?: boolean;
+  /**
+   * Number of spaces for indentation (0 for minified).
+   * @default 2
+   */
+  indent?: number;
 }
 /**
  * Exported JSON structure.
  */
 interface ExportedJSON {
-    /** Export metadata */
-    exportedAt: string;
-    /** Form information (if includeFormDefinition is true) */
-    form?: {
-        id: string;
-        name: string;
-        slug: string;
-        fields: Array<{
-            name: string;
-            label: string;
-            type: string;
-        }>;
-    };
-    /** Total number of submissions in export */
-    totalSubmissions: number;
-    /** Array of submission data */
-    submissions: Array<Record<string, unknown>>;
+  /** Export metadata */
+  exportedAt: string;
+  /** Form information (if includeFormDefinition is true) */
+  form?: {
+    id: string;
+    name: string;
+    slug: string;
+    fields: Array<{
+      name: string;
+      label: string;
+      type: string;
+    }>;
+  };
+  /** Total number of submissions in export */
+  totalSubmissions: number;
+  /** Array of submission data */
+  submissions: Array<Record<string, unknown>>;
 }
 /**
  * Format a field value for export based on field type.
@@ -1029,7 +887,7 @@ interface ExportedJSON {
  * formatExportValue(new Date(), { type: 'date' }); // "2024-01-15"
  * ```
  */
-declare function formatExportValue(value: unknown, field?: FormField): string;
+export declare function formatExportValue(value: unknown, field?: AnyFormField): string;
 /**
  * Export submissions to CSV format.
  *
@@ -1055,7 +913,7 @@ declare function formatExportValue(value: unknown, field?: FormField): string;
  * downloadFile(csv, 'submissions.csv', 'text/csv;charset=utf-8');
  * ```
  */
-declare function exportToCSV(submissions: SubmissionDocument[], form: FormDocument, options?: CSVExportOptions): string;
+export declare function exportToCSV(submissions: SubmissionDocument[], form: FormDocument, options?: CSVExportOptions): string;
 /**
  * Export submissions to JSON format.
  *
@@ -1082,7 +940,7 @@ declare function exportToCSV(submissions: SubmissionDocument[], form: FormDocume
  * downloadFile(json, 'submissions.json', 'application/json');
  * ```
  */
-declare function exportToJSON(submissions: SubmissionDocument[], form: FormDocument, options?: JSONExportOptions): string;
+export declare function exportToJSON(submissions: SubmissionDocument[], form: FormDocument, options?: JSONExportOptions): string;
 /**
  * Trigger a file download in the browser.
  *
@@ -1102,7 +960,7 @@ declare function exportToJSON(submissions: SubmissionDocument[], form: FormDocum
  * downloadFile(json, 'submissions.json', 'application/json');
  * ```
  */
-declare function downloadFile(content: string, filename: string, mimeType: string): void;
+export declare function downloadFile(content: string, filename: string, mimeType: string): void;
 /**
  * Generate a filename for export.
  *
@@ -1118,7 +976,7 @@ declare function downloadFile(content: string, filename: string, mimeType: strin
  * // Returns: "contact-form-submissions-2024-01-15.csv"
  * ```
  */
-declare function generateExportFilename(formSlug: string, format: "csv" | "json"): string;
+export declare function generateExportFilename(formSlug: string, format: "csv" | "json"): string;
 /**
  * Export submissions and trigger browser download.
  *
@@ -1138,57 +996,151 @@ declare function generateExportFilename(formSlug: string, format: "csv" | "json"
  * };
  * ```
  */
-declare function exportAndDownload(submissions: SubmissionDocument[], form: FormDocument, format: "csv" | "json", options?: CSVExportOptions | JSONExportOptions): void;
-
+export declare function exportAndDownload(submissions: SubmissionDocument[], form: FormDocument, format: "csv" | "json", options?: CSVExportOptions | JSONExportOptions): void;
+/**
+ * Options for submitting a form.
+ */
+interface SubmitFormOptions {
+  /** Form slug (URL-friendly identifier) */
+  formSlug: string;
+  /** Form submission data */
+  data: Record<string, unknown>;
+  /** Optional metadata about the submission */
+  metadata?: {
+    /** Submitter's IP address */
+    ipAddress?: string;
+    /** Submitter's user agent string */
+    userAgent?: string;
+  };
+  /**
+   * The HTTP request this submission arrived on.
+   *
+   * A route calling this helper is its own route, outside everything Nextly
+   * pins a request around, so nothing else can supply it. Without it the write
+   * reaches the submissions hooks looking like a seed or a job, and every rule
+   * scoped to a visitor stands down: the rate limit above all.
+   *
+   * The request rather than an address, because the core resolves the client
+   * from it under this deployment's proxy-trust settings. `metadata.ipAddress`
+   * is a string the caller chose, which is the right shape for the audit column
+   * it fills and the wrong shape for deciding who to throttle.
+   */
+  request?: Request;
+  /**
+   * Whose permissions the reads and the write are judged against.
+   *
+   * Defaults to `system`, so every existing caller behaves as before.
+   */
+  access?: SubmissionAccess;
+  /**
+   * The language the visitor submitted in.
+   *
+   * Decides which translation a picked redirect page is read in, and so which
+   * URL the visitor is sent to: a page whose slug is `thanks` in English and
+   * `merci` in French answered `/thanks` to everyone, because the target was
+   * read with no locale and the default answered. The built-in route takes it
+   * from `?locale=` on the submit URL, the same way core's own routes take a
+   * locale on the wire; a host route passes whatever it resolved for the page
+   * the form was on.
+   *
+   * A code that is not a configured locale reads as the default rather than
+   * failing the submission, which the collection services decide. Absent means
+   * the default, as it always has. The read wildcards (`all`, `*`) are not a
+   * language a visitor can have submitted in and are treated as absent: a read
+   * in "every language" answers a localized URL field with one value per
+   * language, which no URL pattern can be filled from.
+   */
+  locale?: string;
+}
 /**
- * Form Submission Handler
+ * How this submission reaches the collections it touches.
  *
- * Processes form submissions including validation, spam detection,
- * storage, and notification triggering.
+ * `system` is the default and is right for host code: the caller already
+ * decided, and there is no visitor whose permissions could be consulted.
  *
- * @module handlers/submit-form
- * @since 0.1.0
+ * `public` is for a route serving an anonymous visitor. It keeps the
+ * collection's configured `access` rules in force, so a host that closed
+ * submissions or restricted reading forms is obeyed rather than bypassed. The
+ * former core endpoint ran this way, and elevating a public route to `system`
+ * silently overrode that configuration.
  */
-
+type SubmissionAccess = {
+  as: "system";
+} | {
+  as: "public";
+};
 /**
- * Options for submitting a form.
+ * Why a submission ended the way it did.
+ *
+ * `success` alone cannot carry this. An HTTP route has to answer 404 for a slug
+ * nobody used, 409 for a form its author closed and 400 for data that did not
+ * validate, and a boolean plus a human sentence cannot tell those apart without
+ * matching on the sentence.
+ *
+ * `accepted` covers every ending a visitor is told succeeded, INCLUDING the two
+ * that are deliberately indistinguishable from success: a submission the
+ * honeypot flagged, and one the rate limiter refused. A caller must not try to
+ * separate them, which is why they do not appear here as their own names.
  */
-interface SubmitFormOptions {
-    /** Form slug (URL-friendly identifier) */
-    formSlug: string;
-    /** Form submission data */
-    data: Record<string, unknown>;
-    /** Optional metadata about the submission */
-    metadata?: {
-        /** Submitter's IP address */
-        ipAddress?: string;
-        /** Submitter's user agent string */
-        userAgent?: string;
-    };
-}
+type SubmitFormOutcome = "accepted" | "no-such-form" | "closed" | "invalid" | "duplicate" | "failed";
 /**
  * Result of form submission.
  */
 interface SubmitFormResult {
-    /** Whether the submission was successful */
-    success: boolean;
-    /** The created submission document (on success) */
-    submission?: SubmissionDocument;
-    /** Error message (on failure) */
-    error?: string;
-    /** Field-level validation errors */
-    validationErrors?: Record<string, string>;
-    /** Redirect URL (if form configured for redirect on success) */
-    redirect?: string;
+  /** Whether the submission was successful */
+  success: boolean;
+  /**
+   * Which ending this was, for a caller that has to map it to a status code.
+   *
+   * Required rather than optional, so a return path added later cannot omit it
+   * and leave the HTTP route guessing from the message text.
+   */
+  outcome: SubmitFormOutcome;
+  /** The created submission document (on success) */
+  submission?: SubmissionDocument;
+  /** Error message (on failure) */
+  error?: string;
+  /** Field-level validation errors */
+  validationErrors?: Record<string, string>;
+  /**
+   * The same failures with their machine codes, for a caller building an HTTP
+   * error. `validationErrors` above cannot carry one, so a route reading only
+   * that has to invent a code and reports every blank answer as `INVALID`.
+   */
+  validationIssues?: ValidationIssue[];
+  /** Redirect URL (if form configured for redirect on success) */
+  redirect?: string;
+  /**
+   * The error that ended a `failed` submission, kept rather than flattened.
+   *
+   * A collection can refuse a write for reasons its host chose: a
+   * `beforeValidate` hook throwing `NextlyError.validation`, a uniqueness
+   * conflict. Those carry their own status and field detail, and reporting them
+   * all as one internal error tells a visitor the server broke when in fact
+   * their submission was answered deliberately.
+   */
+  cause?: unknown;
+  /**
+   * The toast the form's author wrote for a successful submission.
+   *
+   * Carried on the result rather than read from the form again by whoever
+   * presents it: the HTTP route would otherwise have to fetch the form a second
+   * time purely to learn a string this function already had in hand, and a
+   * second read is a second chance to disagree about which form was submitted.
+   *
+   * Present on every `accepted` ending, including the ones a bot caused, so the
+   * message cannot be used to tell an accepted submission from a flagged one.
+   */
+  successMessage?: string;
 }
 /**
  * Context for the submission handler.
  */
 interface SubmitFormContext {
-    /** Plugin context with access to services */
-    pluginContext: PluginContext;
-    /** Resolved plugin configuration */
-    pluginConfig: ResolvedFormBuilderConfig;
+  /** Plugin context with access to services */
+  pluginContext: PluginContext;
+  /** Resolved plugin configuration */
+  pluginConfig: ResolvedFormBuilderConfig;
 }
 /**
  * Process a form submission.
@@ -1231,7 +1183,7 @@ interface SubmitFormContext {
  * }
  * ```
  */
-declare function submitForm(options: SubmitFormOptions, context: SubmitFormContext): Promise<SubmitFormResult>;
+export declare function submitForm(options: SubmitFormOptions, context: SubmitFormContext): Promise<SubmitFormResult>;
 /**
  * Validate form data without creating a submission.
  *
@@ -1255,9 +1207,9 @@ declare function submitForm(options: SubmitFormOptions, context: SubmitFormConte
  * }
  * ```
  */
-declare function validateSubmission(formSlug: string, data: Record<string, unknown>, context: SubmitFormContext): Promise<{
-    valid: boolean;
-    errors?: Record<string, string>;
+export declare function validateSubmission(formSlug: string, data: Record<string, unknown>, context: SubmitFormContext): Promise<{
+  valid: boolean;
+  errors?: Record<string, string>;
 }>;
 /**
  * Check if a form is accepting submissions.
@@ -1266,7 +1218,7 @@ declare function validateSubmission(formSlug: string, data: Record<string, unkno
  * @param context - Handler context
  * @returns Whether the form accepts submissions
  */
-declare function isFormAcceptingSubmissions(formSlug: string, context: SubmitFormContext): Promise<boolean>;
+export declare function isFormAcceptingSubmissions(formSlug: string, context: SubmitFormContext): Promise<boolean>;
 /**
  * Get submission statistics for a form.
  *
@@ -1278,72 +1230,62 @@ declare function isFormAcceptingSubmissions(formSlug: string, context: SubmitFor
  * @param context - Handler context
  * @returns Submission statistics
  */
-declare function getFormSubmissionStats(formSlug: string, context: SubmitFormContext): Promise<{
-    total: number;
-    new: number;
-    read: number;
-    archived: number;
+export declare function getFormSubmissionStats(formSlug: string, context: SubmitFormContext): Promise<{
+  total: number;
+  new: number;
+  read: number;
+  archived: number;
 } | null>;
-
-/**
- * Spam Detection
- *
- * Implements honeypot and rate limiting spam protection for form submissions.
- * Provides a pluggable approach to spam detection that can be extended.
- *
- * @module handlers/spam-detection
- * @since 0.1.0
- */
 /**
  * Configuration for spam detection.
  */
 interface SpamCheckConfig {
-    /**
-     * Enable honeypot field detection.
-     * When enabled, submissions with filled honeypot fields are marked as spam.
-     */
-    honeypot?: boolean;
-    /**
-     * Rate limiting configuration.
-     */
-    rateLimit?: {
-        /** Maximum submissions allowed per window */
-        maxSubmissions: number;
-        /** Time window in milliseconds */
-        windowMs: number;
-    };
-    /**
-     * reCAPTCHA configuration (for future implementation).
-     */
-    recaptcha?: {
-        enabled: boolean;
-        secretKey?: string;
-        scoreThreshold?: number;
-    };
+  /**
+   * Enable honeypot field detection.
+   * When enabled, submissions with filled honeypot fields are marked as spam.
+   */
+  honeypot?: boolean;
+  /**
+   * Rate limiting configuration.
+   */
+  rateLimit?: {
+    /** Maximum submissions allowed per window */
+    maxSubmissions: number;
+    /** Time window in milliseconds */
+    windowMs: number;
+  };
+  /**
+   * reCAPTCHA configuration (for future implementation).
+   */
+  recaptcha?: {
+    enabled: boolean;
+    secretKey?: string;
+    scoreThreshold?: number;
+  };
 }
 /**
  * Options for spam check.
  */
 interface SpamCheckOptions {
-    /** Form submission data */
-    data: Record<string, unknown>;
-    /** Submitter's IP address */
-    ipAddress?: string;
-    /** Form slug for rate limiting key */
-    formSlug: string;
-    /** Spam protection configuration */
-    config: SpamCheckConfig;
+  /** Form submission data */
+  data: Record<string, unknown>;
+  /** Submitter's IP address */
+  ipAddress?: string;
+  /** Form slug for rate limiting key */
+  formSlug: string;
+  /** Spam protection configuration */
+  config: SpamCheckConfig;
 }
 /**
  * Result of spam check.
  */
 interface SpamCheckResult {
-    /** Whether the submission is detected as spam */
-    isSpam: boolean;
-    /** Reason for spam detection (for logging, not exposed to user) */
-    reason?: "honeypot" | "rate_limit" | "recaptcha";
-    /** Additional details (for logging) */
-    details?: string;
+  /** Whether the submission is detected as spam */
+  isSpam: boolean;
+  /** Reason for spam detection (for logging, not exposed to user) */
+  reason?: "honeypot" | "rate_limit" | "recaptcha";
+  /** Additional details (for logging) */
+  details?: string;
 }
 /**
  * Check a form submission for spam indicators.
@@ -1374,196 +1316,7 @@ interface SpamCheckResult {
  * }
  * ```
  */
-declare function checkSpam(options: SpamCheckOptions): Promise<SpamCheckResult>;
-/**
- * Clean up expired rate limit entries.
- *
- * Call this periodically (e.g., every 5 minutes) to prevent
- * memory leaks from accumulated rate limit entries.
- *
- * @param maxAgeMs - Maximum age of entries to keep (default: 5 minutes)
- * @returns Number of entries removed
- *
- * @example
- * ```typescript
- * // Set up periodic cleanup
- * setInterval(() => {
- *   const removed = cleanupRateLimitStore();
- *   console.log(`Cleaned up ${removed} expired rate limit entries`);
- * }, 5 * 60 * 1000); // Every 5 minutes
- * ```
- */
-declare function cleanupRateLimitStore(maxAgeMs?: number): number;
-/**
- * Get the current size of the rate limit store.
- *
- * Useful for monitoring and debugging.
- *
- * @returns Number of entries in the store
- */
-declare function getRateLimitStoreSize(): number;
-/**
- * Clear all rate limit entries.
- *
- * Useful for testing or resetting state.
- */
-declare function clearRateLimitStore(): void;
-/**
- * Check if a specific IP/form is currently rate limited.
- *
- * @param ipAddress - IP address to check
- * @param formSlug - Form slug
- * @param config - Rate limit configuration
- * @returns Whether the IP is currently rate limited
- */
-declare function isRateLimited(ipAddress: string, formSlug: string, config: {
-    maxSubmissions: number;
-    windowMs: number;
-}): boolean;
-
-/**
- * Webhook Handler
- *
- * Triggers webhook notifications for form events.
- * Webhooks are fired asynchronously and do not block form submission.
- *
- * @module handlers/webhooks
- * @since 0.1.0
- */
-
-/**
- * Webhook payload sent to configured endpoints.
- */
-interface WebhookPayload {
-    /** Event type that triggered the webhook */
-    event: WebhookEvent;
-    /** ISO 8601 timestamp when the event occurred */
-    timestamp: string;
-    /** Form information */
-    form: {
-        id: string;
-        slug: string;
-        name: string;
-    };
-    /** Submission information (full data or minimal based on config) */
-    submission: SubmissionDocument | {
-        id: string;
-        submittedAt: Date;
-    };
-}
-/**
- * Options for triggering webhooks.
- */
-interface TriggerWebhooksOptions {
-    /** Event type */
-    event: WebhookEvent;
-    /** Form document */
-    form: FormDocument;
-    /** Submission document */
-    submission: SubmissionDocument;
-}
-/**
- * Result of a single webhook delivery attempt.
- */
-interface WebhookDeliveryResult {
-    /** Webhook URL */
-    url: string;
-    /** Whether the delivery was successful */
-    success: boolean;
-    /** HTTP status code (if request completed) */
-    statusCode?: number;
-    /** Error message (if delivery failed) */
-    error?: string;
-    /** Time taken in milliseconds */
-    durationMs: number;
-}
-/**
- * Result of triggering webhooks for an event.
- */
-interface TriggerWebhooksResult {
-    /** Number of webhooks triggered */
-    triggered: number;
-    /** Number of successful deliveries */
-    successful: number;
-    /** Number of failed deliveries */
-    failed: number;
-    /** Individual delivery results */
-    results: WebhookDeliveryResult[];
-}
-/**
- * Trigger webhooks for a form event.
- *
- * This function fires all matching webhooks asynchronously and does not
- * block form submission. Failed webhooks are logged but do not cause
- * submission failures.
- *
- * @param options - Trigger options
- * @returns Result of webhook triggering
- *
- * @example
- * ```typescript
- * // After creating a submission
- * const result = await triggerWebhooks({
- *   event: 'submission.created',
- *   form,
- *   submission,
- * });
- *
- * console.log(`Triggered ${result.triggered} webhooks`);
- * console.log(`Successful: ${result.successful}, Failed: ${result.failed}`);
- * ```
- */
-declare function triggerWebhooks(options: TriggerWebhooksOptions): Promise<TriggerWebhooksResult>;
-/**
- * Trigger webhooks without waiting for completion.
- *
- * This is the recommended way to call webhooks from submission handlers
- * as it doesn't block the response. Errors are logged but not thrown.
- *
- * @param options - Trigger options
- * @param logger - Optional logger for error reporting
- *
- * @example
- * ```typescript
- * // In submission handler - fire and forget
- * fireWebhooks(
- *   { event: 'submission.created', form, submission },
- *   pluginContext.infra.logger
- * );
- *
- * // Continue with response immediately
- * return { success: true, submission };
- * ```
- */
-declare function fireWebhooks(options: TriggerWebhooksOptions, logger?: {
-    info?: (message: string, data?: Record<string, unknown>) => void;
-    warn?: (message: string, data?: Record<string, unknown>) => void;
-    error?: (message: string, data?: Record<string, unknown>) => void;
-}): void;
-/**
- * Validate a webhook URL.
- *
- * @param url - URL to validate
- * @returns Whether the URL is valid for webhooks
- */
-declare function isValidWebhookUrl(url: string): boolean;
-/**
- * Get the list of supported webhook events.
- *
- * @returns Array of supported event types
- */
-declare function getSupportedWebhookEvents(): WebhookEvent[];
-
-/**
- * Forms Collection
- *
- * Stores form definitions created via Code-First or Schema Builder.
- * Each form contains field definitions, settings, notifications, and access control.
- *
- * @module collections/forms
- * @since 0.1.0
- */
-
+export declare function checkSpam(options: SpamCheckOptions): Promise<SpamCheckResult>;
 /**
  * Component path string format.
  * Format: `"package-name/path#ExportName"`
@@ -1573,69 +1326,43 @@ type ComponentPath = string;
  * Custom view configuration for replacing default admin views.
  */
 interface CollectionAdminViewConfig {
-    /** Component path to the custom view component */
-    Component: ComponentPath;
+  /** Component path to the custom view component */
+  Component: ComponentPath;
 }
 /**
  * Custom components configuration for collection admin UI.
  */
 interface CollectionAdminComponents {
-    views?: {
-        Edit?: CollectionAdminViewConfig;
-        List?: CollectionAdminViewConfig;
-    };
-    BeforeListTable?: ComponentPath;
-    AfterListTable?: ComponentPath;
-    BeforeEdit?: ComponentPath;
-    AfterEdit?: ComponentPath;
+  views?: {
+    Edit?: CollectionAdminViewConfig;
+    List?: CollectionAdminViewConfig;
+  };
+  BeforeListTable?: ComponentPath;
+  AfterListTable?: ComponentPath;
+  BeforeEdit?: ComponentPath;
+  AfterEdit?: ComponentPath;
 }
 /**
  * Extended CollectionConfig with custom admin components support.
  * This extends the base CollectionConfig to include the components property.
  */
 interface ExtendedCollectionConfig$1 extends Omit<CollectionConfig, "admin"> {
-    admin?: CollectionConfig["admin"] & {
-        /** Whether this collection is provided by a plugin */
-        isPlugin?: boolean;
-        components?: CollectionAdminComponents;
-    };
+  admin?: CollectionConfig["admin"] & {
+    /** Whether this collection is provided by a plugin */
+    isPlugin?: boolean;
+    components?: CollectionAdminComponents;
+  };
 }
-/**
- * Generate the Forms collection configuration.
- *
- * Creates a collection for storing form definitions with fields,
- * settings, notifications, and access control.
- *
- * @param pluginConfig - Resolved plugin configuration
- * @returns ExtendedCollectionConfig for the Forms collection (with custom admin components)
- *
- * @example
- * ```typescript
- * const formsCol = formsCollection(resolvedConfig);
- * // Returns a collection with slug "forms" (or custom slug from config)
- * ```
- */
-declare function formsCollection(pluginConfig: ResolvedFormBuilderConfig): ExtendedCollectionConfig$1;
-
-/**
- * Form Submissions Collection
- *
- * Stores form submission data from user-submitted forms.
- * Each submission contains the submitted data, metadata, and status.
- *
- * @module collections/submissions
- * @since 0.1.0
- */
-
+export declare function formsCollection(pluginConfig: ResolvedFormBuilderConfig): ExtendedCollectionConfig$1;
 /**
  * Extended CollectionConfig with isPlugin support.
  * This extends the base CollectionConfig to include the isPlugin property.
  */
 interface ExtendedCollectionConfig extends Omit<CollectionConfig, "admin"> {
-    admin?: CollectionConfig["admin"] & {
-        /** Whether this collection is provided by a plugin */
-        isPlugin?: boolean;
-    };
+  admin?: CollectionConfig["admin"] & {
+    /** Whether this collection is provided by a plugin */
+    isPlugin?: boolean;
+  };
 }
 /**
  * Generate the Form Submissions collection configuration.
@@ -1656,8 +1383,7 @@ interface ExtendedCollectionConfig extends Omit<CollectionConfig, "admin"> {
  * // Returns a collection with slug "form-submissions" (or custom slug from config)
  * ```
  */
-declare function submissionsCollection(pluginConfig: ResolvedFormBuilderConfig): ExtendedCollectionConfig;
-
-declare const formBuilderPlugin: nextly.PluginDefinition;
-
-export { type CSVExportOptions, CheckboxFormField, type ComparisonOperator, ConditionalLogic, DEFAULT_FORM_SETTINGS, DEFAULT_NOTIFICATION_SETTINGS, DateFormField, EmailFormField, type ExportedJSON, FileFormField, FormBuilderPluginOptions, type FormBuilderPluginResult, FormConfig, FormDocument, FormField, type FormFieldOption, FormNotifications, FormSettings, type FormValidationError, type FormValidationErrorCode, type FormValidationResult, HiddenFormField, type JSONExportOptions, type NextlyPlugin, NumberFormField, PhoneFormField, RESERVED_FORM_SLUGS, RadioFormField, ResolvedFormBuilderConfig, SelectFormField, type SpamCheckConfig, type SpamCheckOptions, type SpamCheckResult, SubmissionDocument, type SubmitFormContext, type SubmitFormOptions, type SubmitFormResult, TextFormField, TextareaFormField, TimeFormField, type TriggerWebhooksOptions, type TriggerWebhooksResult, UrlFormField, type WebhookDeliveryResult, WebhookEvent, type WebhookPayload, applyFieldDefaults, applyFormDefaults, assertValidFormConfig, checkSpam, checkbox, cleanupRateLimitStore, clearRateLimitStore, createFormConfig, date, downloadFile, email, evaluateConditions, exportAndDownload, exportToCSV, exportToJSON, file, fireWebhooks, formBuilder, formBuilderPlugin, formatExportValue, formsCollection, generateExportFilename, generateZodSchema, getFormBuilderConfig, getFormSubmissionStats, getRateLimitStoreSize, getSupportedComparisonOperators, getSupportedWebhookEvents, getValidationErrors, hidden, isFormAcceptingSubmissions, isRateLimited, isValidComparisonOperator, isValidWebhookUrl, number, option, phone, pluralize, radio, select, submissionsCollection, submitForm, text, textarea, time, toTitleCase, transformFormData, triggerWebhooks, url, validateFormConfig, validateFormData, validateSubmission };
+export declare function submissionsCollection(pluginConfig: ResolvedFormBuilderConfig): ExtendedCollectionConfig;
+export declare const formBuilderPlugin: ReturnType<typeof formBuilder>["plugin"];
+export { type AnyFormField, BUILT_IN_FORM_FIELD_TYPES, type BaseFormField, type CSVExportOptions, type CheckboxFormField, type ComparisonOperator, type ConditionalLogic, type ConditionalLogicCondition, type CustomFormField, type DateFormField, type EmailConfig, type EmailFormField, type ExportedJSON, type FieldBlockConfig, type FileFormField, type FormAccess, type FormBuilderPluginOptions, type FormBuilderPluginResult, type FormConfig, type FormDocument, type FormField, type FormFieldOption, type FormFieldType, type FormFieldTypeId, type FormHookContext, type FormHooks, type FormNotification, type FormNotificationItem, type FormNotifications, type FormSettings, type FormSubmission, type FormValidationError, type FormValidationErrorCode, type FormValidationResult, type HiddenFormField, type JSONExportOptions, type NextlyPlugin, type NumberFormField, type PhoneFormField, type RadioFormField, type ResolvedFormBuilderConfig, type SelectFormField, type SpamCheckConfig, type SpamCheckOptions, type SpamCheckResult, type SubmissionDocument, type SubmitFormContext, type SubmitFormOptions, type SubmitFormResult, type TextFormField, type TextareaFormField, type TimeFormField, type UrlFormField, type ValidationRules, isCheckboxFormField, isEmailFormField, isFileFormField, isFormField, isFormFieldType, isKnownFormField, isSelectFormField, isTextFormField };
+//# sourceMappingURL=index.d.ts.map