@nice2dev/ui-tools 1.0.10

package/dist/form-builder.d.ts

@@ -0,0 +1,1117 @@
+/**
+ * @file form-builder.ts
+ * @module @nice2dev/ui-tools
+ * @description PRO-14.4 — Form Builder
+ *
+ * Types for drag-drop form builder: field types, validation rules,
+ * conditional logic, multi-page forms, calculations, e-signatures, analytics.
+ */
+/** Form field type */
+export type FormFieldType = 'text' | 'textarea' | 'number' | 'email' | 'phone' | 'url' | 'password' | 'date' | 'time' | 'datetime' | 'dateRange' | 'select' | 'multiSelect' | 'radio' | 'checkbox' | 'checkboxGroup' | 'switch' | 'slider' | 'rating' | 'file' | 'image' | 'signature' | 'address' | 'name' | 'currency' | 'percentage' | 'color' | 'hidden' | 'heading' | 'paragraph' | 'divider' | 'spacer' | 'html' | 'captcha' | 'repeater' | 'matrix' | 'table' | 'calculation' | 'lookup' | 'payment' | 'appointment';
+/** Field value type */
+export type FormFieldValue = string | number | boolean | Date | string[] | number[] | FormFileValue | FormFileValue[] | FormSignatureValue | FormAddressValue | FormNameValue | FormRepeaterValue | FormMatrixValue | FormPaymentValue | null | undefined;
+/** Form builder configuration */
+export interface FormBuilderConfig {
+    /** Initial form definition */
+    form?: FormDefinition;
+    /** Available field types */
+    fieldTypes?: FormFieldType[];
+    /** Custom field types */
+    customFieldTypes?: CustomFieldType[];
+    /** Theme */
+    theme?: FormBuilderTheme;
+    /** Locale */
+    locale?: string;
+    /** Enable preview */
+    preview?: boolean;
+    /** Enable undo/redo */
+    undoRedo?: boolean;
+    /** Enable collaboration */
+    collaboration?: boolean;
+    /** Validation mode */
+    validationMode?: 'onChange' | 'onBlur' | 'onSubmit';
+    /** Show field IDs */
+    showFieldIds?: boolean;
+    /** Show CSS classes */
+    showCssClasses?: boolean;
+    /** Allow HTML in labels */
+    allowHtmlLabels?: boolean;
+    /** Max fields */
+    maxFields?: number;
+    /** Max pages */
+    maxPages?: number;
+    /** Toolbar configuration */
+    toolbar?: FormBuilderToolbar;
+    /** Sidebar configuration */
+    sidebar?: FormBuilderSidebar;
+}
+/** Custom field type */
+export interface CustomFieldType {
+    type: string;
+    label: string;
+    icon?: string;
+    category?: string;
+    defaultConfig: Partial<FormField>;
+    component?: string;
+    validator?: (value: FormFieldValue, field: FormField) => ValidationResult;
+}
+/** Form builder theme */
+export interface FormBuilderTheme {
+    name?: string;
+    primary?: string;
+    secondary?: string;
+    background?: string;
+    surface?: string;
+    text?: string;
+    border?: string;
+    error?: string;
+    success?: string;
+    warning?: string;
+    borderRadius?: number;
+    spacing?: number;
+    fontFamily?: string;
+    fontSize?: number;
+}
+/** Form builder toolbar */
+export interface FormBuilderToolbar {
+    visible?: boolean;
+    position?: 'top' | 'bottom';
+    items?: FormBuilderToolbarItem[];
+}
+/** Toolbar item */
+export type FormBuilderToolbarItem = 'undo' | 'redo' | 'preview' | 'save' | 'export' | 'import' | 'settings' | 'clear' | 'separator';
+/** Form builder sidebar */
+export interface FormBuilderSidebar {
+    visible?: boolean;
+    position?: 'left' | 'right';
+    width?: number;
+    tabs?: ('fields' | 'properties' | 'style' | 'logic' | 'settings')[];
+}
+/** Form definition */
+export interface FormDefinition {
+    id: string;
+    name: string;
+    description?: string;
+    version?: string;
+    pages: FormPage[];
+    settings?: FormSettings;
+    theme?: FormTheme;
+    logic?: FormLogic;
+    calculations?: FormCalculation[];
+    validations?: FormValidation[];
+    actions?: FormAction[];
+    variables?: FormVariable[];
+    metadata?: FormMetadata;
+}
+/** Form page */
+export interface FormPage {
+    id: string;
+    title?: string;
+    description?: string;
+    fields: FormField[];
+    layout?: FormLayout;
+    conditions?: FormCondition[];
+    submitOnPage?: boolean;
+}
+/** Form layout */
+export interface FormLayout {
+    type: 'vertical' | 'horizontal' | 'grid' | 'custom';
+    columns?: number;
+    gap?: number;
+    responsive?: ResponsiveLayout;
+}
+/** Responsive layout */
+export interface ResponsiveLayout {
+    breakpoints?: {
+        [key: string]: number;
+    };
+    layouts?: {
+        [key: string]: FormLayout;
+    };
+}
+/** Form settings */
+export interface FormSettings {
+    submitUrl?: string;
+    submitMethod?: 'POST' | 'PUT' | 'PATCH';
+    submitHeaders?: Record<string, string>;
+    submitFormat?: 'json' | 'formData' | 'urlEncoded';
+    successMessage?: string;
+    errorMessage?: string;
+    redirectUrl?: string;
+    redirectDelay?: number;
+    saveProgress?: boolean;
+    autoSaveInterval?: number;
+    showProgressBar?: boolean;
+    showPageNumbers?: boolean;
+    showRequiredIndicator?: boolean;
+    requiredIndicator?: string;
+    showLabels?: boolean;
+    labelPosition?: 'top' | 'left' | 'inline' | 'floating';
+    labelWidth?: number;
+    allowPreviousPage?: boolean;
+    confirmNavigation?: boolean;
+    showNavigation?: boolean;
+    prevButtonText?: string;
+    nextButtonText?: string;
+    submitButtonText?: string;
+    validateOnBlur?: boolean;
+    validateOnChange?: boolean;
+    validateOnSubmit?: boolean;
+    scrollToFirstError?: boolean;
+    focusFirstError?: boolean;
+    honeypot?: boolean;
+    captcha?: CaptchaConfig;
+    fileTypeRestrictions?: string[];
+    maxFileSize?: number;
+    startDate?: Date;
+    endDate?: Date;
+    maxSubmissions?: number;
+    requireAuth?: boolean;
+    allowMultipleSubmissions?: boolean;
+    editablePeriod?: number;
+    notifications?: FormNotification[];
+    trackAnalytics?: boolean;
+    trackTiming?: boolean;
+    trackAbandonment?: boolean;
+}
+/** Captcha configuration */
+export interface CaptchaConfig {
+    type: 'recaptcha-v2' | 'recaptcha-v3' | 'hcaptcha' | 'turnstile' | 'custom';
+    siteKey: string;
+    theme?: 'light' | 'dark';
+    size?: 'normal' | 'compact' | 'invisible';
+    action?: string;
+    threshold?: number;
+}
+/** Form notification */
+export interface FormNotification {
+    id: string;
+    type: 'email' | 'webhook' | 'sms' | 'push';
+    trigger: 'submit' | 'complete' | 'abandon' | 'error' | 'schedule';
+    recipients?: NotificationRecipient[];
+    template?: NotificationTemplate;
+    conditions?: FormCondition[];
+    enabled?: boolean;
+}
+/** Notification recipient */
+export interface NotificationRecipient {
+    type: 'static' | 'field' | 'admin' | 'submitter';
+    value: string;
+}
+/** Notification template */
+export interface NotificationTemplate {
+    subject?: string;
+    body: string;
+    format?: 'text' | 'html';
+    attachments?: NotificationAttachment[];
+}
+/** Notification attachment */
+export interface NotificationAttachment {
+    type: 'submission' | 'file' | 'pdf' | 'static';
+    source?: string;
+    filename?: string;
+}
+/** Form theme */
+export interface FormTheme {
+    preset?: string;
+    colors?: FormColors;
+    typography?: FormTypography;
+    spacing?: FormSpacing;
+    borders?: FormBorders;
+    shadows?: FormShadows;
+    custom?: Record<string, string>;
+}
+/** Form colors */
+export interface FormColors {
+    primary?: string;
+    secondary?: string;
+    background?: string;
+    surface?: string;
+    text?: string;
+    textSecondary?: string;
+    label?: string;
+    placeholder?: string;
+    border?: string;
+    borderFocus?: string;
+    error?: string;
+    errorBackground?: string;
+    success?: string;
+    warning?: string;
+    disabled?: string;
+    link?: string;
+}
+/** Form typography */
+export interface FormTypography {
+    fontFamily?: string;
+    fontSize?: number;
+    fontSizeLabel?: number;
+    fontSizeHelper?: number;
+    fontSizeError?: number;
+    fontWeight?: number;
+    fontWeightLabel?: number;
+    lineHeight?: number;
+}
+/** Form spacing */
+export interface FormSpacing {
+    fieldGap?: number;
+    sectionGap?: number;
+    labelGap?: number;
+    inputPadding?: number;
+    pageGap?: number;
+}
+/** Form borders */
+export interface FormBorders {
+    radius?: number;
+    width?: number;
+    style?: string;
+    focusWidth?: number;
+}
+/** Form shadows */
+export interface FormShadows {
+    input?: string;
+    inputFocus?: string;
+    card?: string;
+    button?: string;
+}
+/** Form metadata */
+export interface FormMetadata {
+    created?: Date;
+    createdBy?: string;
+    modified?: Date;
+    modifiedBy?: string;
+    published?: boolean;
+    publishedDate?: Date;
+    status?: 'draft' | 'published' | 'archived';
+    tags?: string[];
+    category?: string;
+    analytics?: FormAnalyticsMetadata;
+}
+/** Form analytics metadata */
+export interface FormAnalyticsMetadata {
+    totalViews?: number;
+    totalSubmissions?: number;
+    conversionRate?: number;
+    averageCompletionTime?: number;
+    abandonmentRate?: number;
+}
+/** Form field */
+export interface FormField {
+    id: string;
+    type: FormFieldType;
+    name: string;
+    label?: string;
+    placeholder?: string;
+    helperText?: string;
+    tooltip?: string;
+    defaultValue?: FormFieldValue;
+    required?: boolean;
+    disabled?: boolean;
+    readOnly?: boolean;
+    hidden?: boolean;
+    validations?: FieldValidation[];
+    conditions?: FieldCondition[];
+    properties?: FieldProperties;
+    layout?: FieldLayout;
+    style?: FieldStyle;
+    permissions?: FieldPermissions;
+    data?: FieldData;
+}
+/** Field properties */
+export interface FieldProperties {
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    patternMessage?: string;
+    mask?: string;
+    maskChar?: string;
+    prefix?: string;
+    suffix?: string;
+    min?: number;
+    max?: number;
+    step?: number;
+    precision?: number;
+    format?: string;
+    minDate?: Date | string;
+    maxDate?: Date | string;
+    dateFormat?: string;
+    timeFormat?: string;
+    timezone?: string;
+    disabledDates?: (Date | string)[];
+    disabledDays?: number[];
+    showCalendar?: boolean;
+    showTime?: boolean;
+    options?: FieldOption[];
+    optionsSource?: OptionSource;
+    searchable?: boolean;
+    clearable?: boolean;
+    creatable?: boolean;
+    multiple?: boolean;
+    maxSelections?: number;
+    displayFormat?: string;
+    accept?: string;
+    maxFileSize?: number;
+    maxFiles?: number;
+    minFiles?: number;
+    allowedExtensions?: string[];
+    camera?: boolean;
+    crop?: ImageCropConfig;
+    resize?: ImageResizeConfig;
+    marks?: SliderMark[];
+    range?: boolean;
+    vertical?: boolean;
+    ratingMax?: number;
+    ratingIcons?: {
+        full: string;
+        half?: string;
+        empty: string;
+    };
+    allowHalf?: boolean;
+    addressType?: 'full' | 'simple' | 'international';
+    googleMapsKey?: string;
+    autocomplete?: boolean;
+    showMap?: boolean;
+    signatureType?: 'draw' | 'type' | 'upload' | 'all';
+    signatureWidth?: number;
+    signatureHeight?: number;
+    penColor?: string;
+    penWidth?: number;
+    signatureFonts?: string[];
+    minItems?: number;
+    maxItems?: number;
+    itemTemplate?: FormField[];
+    addButtonText?: string;
+    removeButtonText?: string;
+    sortable?: boolean;
+    rows?: MatrixRow[];
+    columns?: MatrixColumn[];
+    cellType?: 'radio' | 'checkbox' | 'text' | 'number' | 'select';
+    formula?: string;
+    variables?: string[];
+    outputFormat?: string;
+    lookupSource?: LookupSource;
+    lookupField?: string;
+    lookupDisplay?: string;
+    paymentProvider?: PaymentProvider;
+    amount?: number | string;
+    currency?: string;
+    description?: string;
+    appointmentDuration?: number;
+    appointmentBuffer?: number;
+    availableSlots?: AvailableSlot[];
+    timezoneSelection?: boolean;
+    content?: string;
+    headingLevel?: 1 | 2 | 3 | 4 | 5 | 6;
+    custom?: Record<string, unknown>;
+}
+/** Field option */
+export interface FieldOption {
+    value: string | number;
+    label: string;
+    disabled?: boolean;
+    group?: string;
+    description?: string;
+    icon?: string;
+    color?: string;
+}
+/** Option source */
+export interface OptionSource {
+    type: 'static' | 'api' | 'field' | 'function';
+    url?: string;
+    method?: 'GET' | 'POST';
+    headers?: Record<string, string>;
+    params?: Record<string, string>;
+    body?: unknown;
+    fieldId?: string;
+    valuePath?: string;
+    labelPath?: string;
+    transform?: string;
+    cache?: boolean;
+    cacheTime?: number;
+    dependsOn?: string[];
+}
+/** Image crop configuration */
+export interface ImageCropConfig {
+    enabled: boolean;
+    aspectRatio?: number;
+    minWidth?: number;
+    minHeight?: number;
+    maxWidth?: number;
+    maxHeight?: number;
+    circular?: boolean;
+}
+/** Image resize configuration */
+export interface ImageResizeConfig {
+    enabled: boolean;
+    maxWidth?: number;
+    maxHeight?: number;
+    quality?: number;
+    format?: 'jpeg' | 'png' | 'webp';
+}
+/** Slider mark */
+export interface SliderMark {
+    value: number;
+    label?: string;
+}
+/** Matrix row */
+export interface MatrixRow {
+    id: string;
+    label: string;
+    required?: boolean;
+}
+/** Matrix column */
+export interface MatrixColumn {
+    id: string;
+    label: string;
+    value: string | number;
+}
+/** Lookup source */
+export interface LookupSource {
+    type: 'api' | 'database' | 'static';
+    url?: string;
+    table?: string;
+    data?: Record<string, unknown>[];
+    searchFields?: string[];
+    minChars?: number;
+    debounce?: number;
+}
+/** Payment provider */
+export interface PaymentProvider {
+    type: 'stripe' | 'paypal' | 'square' | 'braintree' | 'custom';
+    publicKey?: string;
+    environment?: 'sandbox' | 'production';
+    methods?: ('card' | 'bank' | 'wallet')[];
+}
+/** Available slot */
+export interface AvailableSlot {
+    dayOfWeek?: number;
+    date?: string;
+    startTime: string;
+    endTime: string;
+    capacity?: number;
+}
+/** Field layout */
+export interface FieldLayout {
+    column?: number;
+    columnSpan?: number;
+    row?: number;
+    rowSpan?: number;
+    order?: number;
+    width?: string | number;
+    minWidth?: string | number;
+    maxWidth?: string | number;
+    responsive?: ResponsiveFieldLayout;
+}
+/** Responsive field layout */
+export interface ResponsiveFieldLayout {
+    sm?: Partial<FieldLayout>;
+    md?: Partial<FieldLayout>;
+    lg?: Partial<FieldLayout>;
+    xl?: Partial<FieldLayout>;
+}
+/** Field style */
+export interface FieldStyle {
+    className?: string;
+    labelClassName?: string;
+    inputClassName?: string;
+    helperClassName?: string;
+    errorClassName?: string;
+    wrapperStyle?: Record<string, string>;
+    labelStyle?: Record<string, string>;
+    inputStyle?: Record<string, string>;
+    customCss?: string;
+}
+/** Field permissions */
+export interface FieldPermissions {
+    view?: string[];
+    edit?: string[];
+    required?: string[];
+}
+/** Field data */
+export interface FieldData {
+    attributes?: Record<string, string>;
+    dataset?: Record<string, string>;
+    autofill?: string;
+    autocomplete?: string;
+}
+/** File value */
+export interface FormFileValue {
+    id?: string;
+    name: string;
+    size: number;
+    type: string;
+    url?: string;
+    preview?: string;
+    data?: string | ArrayBuffer;
+    status?: 'pending' | 'uploading' | 'completed' | 'error';
+    progress?: number;
+    error?: string;
+}
+/** Signature value */
+export interface FormSignatureValue {
+    type: 'draw' | 'type' | 'upload';
+    data?: string;
+    text?: string;
+    font?: string;
+    timestamp?: Date;
+    ip?: string;
+}
+/** Address value */
+export interface FormAddressValue {
+    street1?: string;
+    street2?: string;
+    city?: string;
+    state?: string;
+    postalCode?: string;
+    country?: string;
+    formatted?: string;
+    latitude?: number;
+    longitude?: number;
+}
+/** Name value */
+export interface FormNameValue {
+    prefix?: string;
+    firstName?: string;
+    middleName?: string;
+    lastName?: string;
+    suffix?: string;
+    formatted?: string;
+}
+/** Repeater value - uses unknown to avoid circular reference */
+export type FormRepeaterValue = Record<string, unknown>[];
+/** Matrix value - uses unknown to avoid circular reference */
+export type FormMatrixValue = Record<string, Record<string, unknown>>;
+/** Payment value */
+export interface FormPaymentValue {
+    transactionId?: string;
+    status?: 'pending' | 'processing' | 'completed' | 'failed' | 'refunded';
+    amount?: number;
+    currency?: string;
+    method?: string;
+    last4?: string;
+    brand?: string;
+    receipt?: string;
+    error?: string;
+}
+/** Field validation */
+export interface FieldValidation {
+    id: string;
+    type: ValidationType;
+    message?: string;
+    params?: ValidationParams;
+    condition?: FormCondition;
+}
+/** Validation type */
+export type ValidationType = 'required' | 'email' | 'url' | 'phone' | 'minLength' | 'maxLength' | 'min' | 'max' | 'pattern' | 'matches' | 'custom' | 'date' | 'dateRange' | 'time' | 'number' | 'integer' | 'decimal' | 'creditCard' | 'postalCode' | 'ssn' | 'ipAddress' | 'alphanumeric' | 'alpha' | 'numeric' | 'fileType' | 'fileSize' | 'imageSize' | 'uniqueInRepater' | 'asyncValidator';
+/** Validation params */
+export interface ValidationParams {
+    value?: unknown;
+    min?: number;
+    max?: number;
+    pattern?: string;
+    flags?: string;
+    field?: string;
+    types?: string[];
+    allowedValues?: unknown[];
+    url?: string;
+    method?: string;
+    custom?: (value: FormFieldValue, field: FormField, form: FormDefinition) => boolean | Promise<boolean>;
+}
+/** Form validation */
+export interface FormValidation {
+    id: string;
+    type: 'cross-field' | 'page' | 'form';
+    fields?: string[];
+    rule: ValidationRule;
+    message: string;
+}
+/** Validation rule */
+export interface ValidationRule {
+    type: 'comparison' | 'expression' | 'custom';
+    operator?: ComparisonOperator;
+    field1?: string;
+    field2?: string;
+    value?: unknown;
+    expression?: string;
+    custom?: (values: Record<string, FormFieldValue>) => boolean | Promise<boolean>;
+}
+/** Comparison operator */
+export type ComparisonOperator = 'equals' | 'notEquals' | 'greaterThan' | 'lessThan' | 'greaterThanOrEqual' | 'lessThanOrEqual' | 'contains' | 'notContains' | 'startsWith' | 'endsWith' | 'matches' | 'isEmpty' | 'isNotEmpty';
+/** Validation result */
+export interface ValidationResult {
+    valid: boolean;
+    errors?: ValidationError[];
+}
+/** Validation error */
+export interface ValidationError {
+    fieldId: string;
+    message: string;
+    type: ValidationType | string;
+    params?: Record<string, unknown>;
+}
+/** Form logic */
+export interface FormLogic {
+    rules: LogicRule[];
+    executeOn?: 'change' | 'blur' | 'both';
+}
+/** Logic rule */
+export interface LogicRule {
+    id: string;
+    name?: string;
+    conditions: FormCondition[];
+    conditionLogic?: 'and' | 'or';
+    actions: LogicAction[];
+    enabled?: boolean;
+    priority?: number;
+}
+/** Form condition */
+export interface FormCondition {
+    field: string;
+    operator: ConditionOperator;
+    value?: unknown;
+    values?: unknown[];
+}
+/** Condition operator */
+export type ConditionOperator = 'equals' | 'notEquals' | 'greaterThan' | 'lessThan' | 'greaterThanOrEqual' | 'lessThanOrEqual' | 'contains' | 'notContains' | 'startsWith' | 'endsWith' | 'isEmpty' | 'isNotEmpty' | 'isChecked' | 'isNotChecked' | 'isValid' | 'isInvalid' | 'changed' | 'in' | 'notIn' | 'between' | 'regex';
+/** Field condition */
+export interface FieldCondition {
+    action: 'show' | 'hide' | 'enable' | 'disable' | 'require' | 'unrequire';
+    conditions: FormCondition[];
+    conditionLogic?: 'and' | 'or';
+}
+/** Logic action */
+export interface LogicAction {
+    type: LogicActionType;
+    target?: string;
+    targets?: string[];
+    value?: unknown;
+    params?: Record<string, unknown>;
+}
+/** Logic action type */
+export type LogicActionType = 'show' | 'hide' | 'enable' | 'disable' | 'require' | 'unrequire' | 'setValue' | 'clearValue' | 'setOptions' | 'addOption' | 'removeOption' | 'setValidation' | 'removeValidation' | 'setProperty' | 'goToPage' | 'submit' | 'reset' | 'triggerEvent' | 'runScript' | 'callApi';
+/** Form calculation */
+export interface FormCalculation {
+    id: string;
+    name?: string;
+    targetField: string;
+    formula: string;
+    variables?: CalculationVariable[];
+    trigger?: 'change' | 'blur' | 'manual';
+    format?: CalculationFormat;
+    conditions?: FormCondition[];
+    enabled?: boolean;
+}
+/** Calculation variable */
+export interface CalculationVariable {
+    name: string;
+    field?: string;
+    value?: unknown;
+    type?: 'field' | 'constant' | 'function';
+}
+/** Calculation format */
+export interface CalculationFormat {
+    type: 'number' | 'currency' | 'percentage' | 'date' | 'custom';
+    decimals?: number;
+    currency?: string;
+    locale?: string;
+    pattern?: string;
+}
+/** Form action */
+export interface FormAction {
+    id: string;
+    name?: string;
+    trigger: ActionTrigger;
+    action: ActionConfig;
+    conditions?: FormCondition[];
+    enabled?: boolean;
+}
+/** Action trigger */
+export interface ActionTrigger {
+    type: 'submit' | 'pageChange' | 'fieldChange' | 'click' | 'timer' | 'custom';
+    field?: string;
+    page?: number;
+    delay?: number;
+    event?: string;
+}
+/** Action config */
+export interface ActionConfig {
+    type: ActionType;
+    params?: ActionParams;
+}
+/** Action type */
+export type ActionType = 'submitForm' | 'saveProgress' | 'redirect' | 'showMessage' | 'showModal' | 'closeModal' | 'callApi' | 'downloadFile' | 'printForm' | 'email' | 'runScript' | 'triggerWebhook' | 'analytics' | 'custom';
+/** Action params */
+export interface ActionParams {
+    url?: string;
+    method?: string;
+    headers?: Record<string, string>;
+    body?: unknown;
+    message?: string;
+    messageType?: 'success' | 'error' | 'warning' | 'info';
+    modalId?: string;
+    script?: string;
+    filename?: string;
+    eventName?: string;
+    eventData?: Record<string, unknown>;
+    delay?: number;
+}
+/** Form variable */
+export interface FormVariable {
+    name: string;
+    source: VariableSource;
+    defaultValue?: unknown;
+    transform?: VariableTransform;
+}
+/** Variable source */
+export type VariableSource = {
+    type: 'constant';
+    value: unknown;
+} | {
+    type: 'queryParam';
+    param: string;
+} | {
+    type: 'cookie';
+    name: string;
+} | {
+    type: 'localStorage';
+    key: string;
+} | {
+    type: 'sessionStorage';
+    key: string;
+} | {
+    type: 'userData';
+    property: string;
+} | {
+    type: 'api';
+    url: string;
+    path?: string;
+} | {
+    type: 'date';
+    format?: string;
+} | {
+    type: 'random';
+    valueType: 'uuid' | 'number' | 'string';
+    options?: unknown;
+} | {
+    type: 'custom';
+    function: string;
+};
+/** Variable transform */
+export interface VariableTransform {
+    type: 'uppercase' | 'lowercase' | 'trim' | 'replace' | 'format' | 'custom';
+    params?: Record<string, unknown>;
+}
+/** Form submission */
+export interface FormSubmission {
+    id: string;
+    formId: string;
+    formVersion?: string;
+    values: Record<string, FormFieldValue>;
+    files?: FormFileSubmission[];
+    metadata: SubmissionMetadata;
+    status: SubmissionStatus;
+    payment?: FormPaymentValue;
+    signature?: FormSignatureValue;
+}
+/** File submission */
+export interface FormFileSubmission {
+    fieldId: string;
+    files: FormFileValue[];
+}
+/** Submission metadata */
+export interface SubmissionMetadata {
+    submittedAt: Date;
+    updatedAt?: Date;
+    ip?: string;
+    userAgent?: string;
+    referrer?: string;
+    userId?: string;
+    sessionId?: string;
+    startTime?: Date;
+    completionTime?: number;
+    pages?: PageSubmissionMetadata[];
+    abandonedAt?: Date;
+    geolocation?: GeolocationData;
+    device?: DeviceData;
+}
+/** Page submission metadata */
+export interface PageSubmissionMetadata {
+    pageId: string;
+    startTime: Date;
+    endTime?: Date;
+    timeSpent: number;
+    validationErrors?: number;
+}
+/** Geolocation data */
+export interface GeolocationData {
+    country?: string;
+    region?: string;
+    city?: string;
+    postalCode?: string;
+    latitude?: number;
+    longitude?: number;
+    timezone?: string;
+}
+/** Device data */
+export interface DeviceData {
+    type?: 'desktop' | 'tablet' | 'mobile';
+    browser?: string;
+    browserVersion?: string;
+    os?: string;
+    osVersion?: string;
+    screenWidth?: number;
+    screenHeight?: number;
+}
+/** Submission status */
+export type SubmissionStatus = 'draft' | 'pending' | 'submitted' | 'processing' | 'completed' | 'failed' | 'abandoned' | 'spam';
+/** Form analytics */
+export interface FormAnalytics {
+    formId: string;
+    period: AnalyticsPeriod;
+    summary: AnalyticsSummary;
+    pageAnalytics: PageAnalytics[];
+    fieldAnalytics: FieldAnalytics[];
+    conversionFunnel: ConversionFunnel;
+    abandonmentAnalysis: AbandonmentAnalysis;
+    timeAnalysis: TimeAnalysis;
+    deviceAnalysis: DeviceAnalysis;
+    geographicAnalysis: GeographicAnalysis;
+}
+/** Analytics period */
+export interface AnalyticsPeriod {
+    start: Date;
+    end: Date;
+    granularity: 'hour' | 'day' | 'week' | 'month';
+}
+/** Analytics summary */
+export interface AnalyticsSummary {
+    totalViews: number;
+    uniqueViews: number;
+    totalStarts: number;
+    totalSubmissions: number;
+    conversionRate: number;
+    completionRate: number;
+    averageCompletionTime: number;
+    medianCompletionTime: number;
+    abandonmentRate: number;
+    returningUsers: number;
+    validationErrorRate: number;
+    trend: TrendData[];
+}
+/** Trend data */
+export interface TrendData {
+    date: Date;
+    views: number;
+    starts: number;
+    submissions: number;
+}
+/** Page analytics */
+export interface PageAnalytics {
+    pageId: string;
+    pageNumber: number;
+    views: number;
+    completions: number;
+    dropoffs: number;
+    averageTime: number;
+    validationErrors: number;
+    mostTriggeredErrors: {
+        fieldId: string;
+        count: number;
+    }[];
+}
+/** Field analytics */
+export interface FieldAnalytics {
+    fieldId: string;
+    fieldType: FormFieldType;
+    interactionCount: number;
+    completionRate: number;
+    averageTime: number;
+    validationErrors: number;
+    emptySubmissions: number;
+    valueDistribution?: {
+        value: string;
+        count: number;
+    }[];
+    correctionRate: number;
+}
+/** Conversion funnel */
+export interface ConversionFunnel {
+    stages: FunnelStage[];
+    overallConversion: number;
+    biggestDropoff: {
+        from: string;
+        to: string;
+        rate: number;
+    };
+}
+/** Funnel stage */
+export interface FunnelStage {
+    id: string;
+    name: string;
+    count: number;
+    percentage: number;
+    dropoffRate: number;
+}
+/** Abandonment analysis */
+export interface AbandonmentAnalysis {
+    totalAbandoned: number;
+    abandonmentRate: number;
+    byPage: {
+        pageId: string;
+        count: number;
+        percentage: number;
+    }[];
+    byField: {
+        fieldId: string;
+        count: number;
+        percentage: number;
+    }[];
+    averageTimeBeforeAbandonment: number;
+    commonLastInteraction: {
+        elementId: string;
+        count: number;
+    }[];
+}
+/** Time analysis */
+export interface TimeAnalysis {
+    byHour: {
+        hour: number;
+        submissions: number;
+    }[];
+    byDayOfWeek: {
+        day: number;
+        submissions: number;
+    }[];
+    peakTimes: {
+        start: string;
+        end: string;
+        submissions: number;
+    }[];
+}
+/** Device analysis */
+export interface DeviceAnalysis {
+    byDevice: {
+        device: string;
+        count: number;
+        percentage: number;
+    }[];
+    byBrowser: {
+        browser: string;
+        count: number;
+        percentage: number;
+    }[];
+    byOS: {
+        os: string;
+        count: number;
+        percentage: number;
+    }[];
+    conversionByDevice: {
+        device: string;
+        rate: number;
+    }[];
+}
+/** Geographic analysis */
+export interface GeographicAnalysis {
+    byCountry: {
+        country: string;
+        count: number;
+        percentage: number;
+    }[];
+    byRegion: {
+        region: string;
+        count: number;
+        percentage: number;
+    }[];
+    topCities: {
+        city: string;
+        count: number;
+    }[];
+}
+/** Form export format */
+export type FormExportFormat = 'json' | 'yaml' | 'xml' | 'html' | 'pdf';
+/** Form export options */
+export interface FormExportOptions {
+    format: FormExportFormat;
+    includeSubmissions?: boolean;
+    includeAnalytics?: boolean;
+    includeTheme?: boolean;
+    prettyPrint?: boolean;
+}
+/** Submission export format */
+export type SubmissionExportFormat = 'csv' | 'xlsx' | 'json' | 'pdf';
+/** Submission export options */
+export interface SubmissionExportOptions {
+    format: SubmissionExportFormat;
+    fields?: string[];
+    dateFormat?: string;
+    includeMetadata?: boolean;
+    includeFiles?: boolean;
+    filters?: SubmissionFilter[];
+    sortBy?: string;
+    sortOrder?: 'asc' | 'desc';
+}
+/** Submission filter */
+export interface SubmissionFilter {
+    field: string;
+    operator: ComparisonOperator;
+    value: unknown;
+}
+/** Embed configuration */
+export interface FormEmbedConfig {
+    type: 'inline' | 'popup' | 'slide' | 'fullpage';
+    container?: string;
+    width?: string | number;
+    height?: string | number;
+    trigger?: EmbedTrigger;
+    animation?: EmbedAnimation;
+    overlay?: boolean;
+    closeOnOverlayClick?: boolean;
+    closeButton?: boolean;
+    responsive?: boolean;
+    callbacks?: EmbedCallbacks;
+}
+/** Embed trigger */
+export interface EmbedTrigger {
+    type: 'click' | 'scroll' | 'exit' | 'time' | 'manual';
+    selector?: string;
+    scrollPercent?: number;
+    delay?: number;
+}
+/** Embed animation */
+export interface EmbedAnimation {
+    type: 'fade' | 'slide' | 'zoom' | 'none';
+    direction?: 'left' | 'right' | 'top' | 'bottom';
+    duration?: number;
+}
+/** Embed callbacks */
+export interface EmbedCallbacks {
+    onOpen?: () => void;
+    onClose?: () => void;
+    onSubmit?: (data: FormSubmission) => void;
+    onError?: (error: Error) => void;
+    onPageChange?: (page: number) => void;
+    onFieldChange?: (fieldId: string, value: FormFieldValue) => void;
+}
+/** Form access control */
+export interface FormAccessControl {
+    public?: boolean;
+    requireAuth?: boolean;
+    allowedRoles?: string[];
+    allowedUsers?: string[];
+    deniedUsers?: string[];
+    password?: string;
+    ipWhitelist?: string[];
+    ipBlacklist?: string[];
+    refererWhitelist?: string[];
+    domainWhitelist?: string[];
+}
+/** Submission access control */
+export interface SubmissionAccessControl {
+    viewOwn?: boolean;
+    viewAll?: boolean;
+    editOwn?: boolean;
+    editAll?: boolean;
+    deleteOwn?: boolean;
+    deleteAll?: boolean;
+    export?: boolean;
+}
+//# sourceMappingURL=form-builder.d.ts.map