@nextlyhq/plugin-form-builder 0.0.2-alpha.67 → 0.0.2-alpha.69

package/dist/index.d.ts

@@ -1,29 +1,15 @@
-import * as nextly from 'nextly';
-import { CollectionConfig, PluginContext } from 'nextly';
-import { PluginDefinition } from '@nextlyhq/plugin-sdk';
-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, A as AnyFormField, i as SubmissionDocument, j as FormDocument } from './types-Bo4lk9BD.js';
-export { B as BUILT_IN_FORM_FIELD_TYPES, k as BaseFormField, l as ConditionalLogicCondition, m as CustomFormField, n as EmailConfig, o as FieldBlockConfig, p as FormAccess, q as FormField, r as FormFieldType, s as FormFieldTypeId, t as FormHookContext, u as FormHooks, v as FormNotification, w as FormNotificationItem, x as FormSubmission, V as ValidationRules, y as isCheckboxFormField, z as isEmailFormField, G as isFileFormField, I as isFormField, J as isFormFieldType, K as isKnownFormField, L as isSelectFormField, M as isTextFormField } from './types-Bo4lk9BD.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.
@@ -52,36 +38,11 @@ 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.
@@ -100,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.
  *
@@ -169,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.
  *
@@ -187,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.
  *
@@ -235,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.
@@ -250,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.
  *
@@ -293,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.
  *
@@ -312,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.
@@ -340,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.
@@ -416,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.
  *
@@ -445,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.
  *
@@ -468,7 +364,7 @@ declare const text: (config: Omit<TextFormField, "type">) => TextFormField;
  * })
  * ```
  */
-declare const email: (config: Omit<EmailFormField, "type">) => EmailFormField;
+export declare const email: (config: Omit<EmailFormField, "type">) => EmailFormField;
 /**
  * Creates a phone input field configuration.
  *
@@ -491,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.
  *
@@ -513,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.
  *
@@ -540,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.
  *
@@ -568,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.
  *
@@ -605,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.
  *
@@ -631,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.
  *
@@ -655,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.
  *
@@ -686,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.
  *
@@ -710,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.
  *
@@ -732,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.
  *
@@ -752,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.
  */
@@ -848,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.
  *
@@ -894,7 +749,7 @@ declare function getSupportedComparisonOperators(): ComparisonOperator[];
  * const result = schema.safeParse({ firstName: 'John', email: 'john@example.com', age: 25 });
  * ```
  */
-declare function generateZodSchema(fields: AnyFormField[]): z.ZodObject<Record<string, z.ZodTypeAny>>;
+export declare function generateZodSchema(fields: AnyFormField[]): z.ZodObject<Record<string, z.ZodTypeAny>>;
 /**
  * Transform form data before validation.
  *
@@ -908,7 +763,7 @@ declare function generateZodSchema(fields: AnyFormField[]): z.ZodObject<Record<s
  * @param fields - Form field configurations
  * @returns Transformed data ready for validation
  */
-declare function transformFormData(data: Record<string, unknown>, fields: AnyFormField[]): 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.
  *
@@ -929,7 +784,7 @@ declare function transformFormData(data: Record<string, unknown>, fields: AnyFor
  * }
  * ```
  */
-declare function validateFormData(data: Record<string, unknown>, fields: AnyFormField[]): z.ZodSafeParseResult<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.
  *
@@ -938,10 +793,10 @@ declare function validateFormData(data: Record<string, unknown>, fields: AnyForm
  */
 /** 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;
+  path: string;
+  /** `REQUIRED` for an answer that is missing or empty, else `INVALID`. */
+  code: "REQUIRED" | "INVALID";
+  message: string;
 }
 /**
  * The same failures as a field-to-message map.
@@ -950,85 +805,73 @@ interface ValidationIssue {
  * second time, so the two cannot disagree about which message belongs to a
  * field or which failure won when one field had several.
  */
-declare function getValidationErrors(result: z.ZodSafeParseResult<unknown>): Record<string, 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.
- *
- * @module utils/export-formats
- * @since 0.1.0
- */
-
+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.
@@ -1044,7 +887,7 @@ interface ExportedJSON {
  * formatExportValue(new Date(), { type: 'date' }); // "2024-01-15"
  * ```
  */
-declare function formatExportValue(value: unknown, field?: AnyFormField): string;
+export declare function formatExportValue(value: unknown, field?: AnyFormField): string;
 /**
  * Export submissions to CSV format.
  *
@@ -1070,7 +913,7 @@ declare function formatExportValue(value: unknown, field?: AnyFormField): 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.
  *
@@ -1097,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.
  *
@@ -1117,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.
  *
@@ -1133,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.
  *
@@ -1153,72 +996,61 @@ declare function generateExportFilename(formSlug: string, format: "csv" | "json"
  * };
  * ```
  */
-declare function exportAndDownload(submissions: SubmissionDocument[], form: FormDocument, format: "csv" | "json", options?: CSVExportOptions | JSONExportOptions): void;
-
-/**
- * Form Submission Handler
- *
- * Processes form submissions including validation, spam detection,
- * storage, and notification triggering.
- *
- * @module handlers/submit-form
- * @since 0.1.0
- */
-
+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 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;
 }
 /**
  * How this submission reaches the collections it touches.
@@ -1233,9 +1065,9 @@ interface SubmitFormOptions {
  * silently overrode that configuration.
  */
 type SubmissionAccess = {
-    as: "system";
+  as: "system";
 } | {
-    as: "public";
+  as: "public";
 };
 /**
  * Why a submission ended the way it did.
@@ -1255,60 +1087,60 @@ type SubmitFormOutcome = "accepted" | "no-such-form" | "closed" | "invalid" | "d
  * Result of form submission.
  */
 interface SubmitFormResult {
-    /** 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;
+  /** 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.
@@ -1351,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.
  *
@@ -1375,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.
@@ -1386,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.
  *
@@ -1398,80 +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
- *
- * Honeypot and rate limiting for form submissions.
- *
- * The honeypot is a pure read of the submitted payload. The rate limit is not:
- * it counts, and where the count lives decides whether the limit means
- * anything. It lives in the deployment's own {@link RateLimitStore}, the one
- * the REST and auth limiters already share, so `rateLimit.store` is configured
- * once and all three agree about what they are counting. A store private to
- * this module would count per process, and on a deployment that spans several
- * the effective limit becomes `configured x instances` -- a number the operator
- * never chose, that fails open, and only under load.
- *
- * @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.
@@ -1502,18 +1316,7 @@ interface SpamCheckResult {
  * }
  * ```
  */
-declare function checkSpam(options: SpamCheckOptions): Promise<SpamCheckResult>;
-
-/**
- * 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"`
@@ -1523,54 +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;
+  };
 }
-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.
@@ -1591,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 { AnyFormField, type CSVExportOptions, CheckboxFormField, type ComparisonOperator, ConditionalLogic, DEFAULT_FORM_SETTINGS, DEFAULT_NOTIFICATION_SETTINGS, DateFormField, EmailFormField, type ExportedJSON, FileFormField, FormBuilderPluginOptions, type FormBuilderPluginResult, FormConfig, FormDocument, 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, UrlFormField, applyFieldDefaults, applyFormDefaults, assertValidFormConfig, checkSpam, checkbox, createFormConfig, date, downloadFile, email, evaluateConditions, exportAndDownload, exportToCSV, exportToJSON, file, formBuilder, formBuilderPlugin, formatExportValue, formsCollection, generateExportFilename, generateZodSchema, getFormBuilderConfig, getFormSubmissionStats, getSupportedComparisonOperators, getValidationErrors, hidden, isFormAcceptingSubmissions, isValidComparisonOperator, number, option, phone, pluralize, radio, select, submissionsCollection, submitForm, text, textarea, time, toTitleCase, transformFormData, 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