@pwfabric/runtime 0.0.0-stage → 1.0.0-rc.0

package/dist/forms/named-control-values.js

@@ -0,0 +1,42 @@
+function findBlock(blocks, id) {
+    for (const block of blocks ?? []) {
+        if (block.id === id)
+            return block;
+        const inner = findBlock(block.children, id);
+        if (inner)
+            return inner;
+    }
+    return undefined;
+}
+function collect(blocks, state, into, seen) {
+    for (const block of blocks ?? []) {
+        const props = (block.props ?? {});
+        const name = props['name'];
+        const stateKey = props['stateKey'];
+        if (typeof name === 'string' &&
+            name &&
+            typeof stateKey === 'string' &&
+            stateKey &&
+            props['disabled'] !== true &&
+            !seen.has(name) &&
+            state[stateKey] !== undefined) {
+            into[name] = state[stateKey];
+            seen.add(name);
+        }
+        collect(block.children, state, into, seen);
+    }
+}
+/**
+ * The form's submitted values, completed from page state for named controls
+ * FormData missed. Returns `values` itself when there is nothing to add.
+ */
+export function completeNamedControlValues(blocks, formId, values, state) {
+    const form = findBlock(blocks, formId);
+    if (!form)
+        return values;
+    const seen = new Set(Object.keys(values));
+    const added = {};
+    collect(form.children, state, added, seen);
+    return Object.keys(added).length > 0 ? { ...values, ...added } : values;
+}
+//# sourceMappingURL=named-control-values.js.map

package/dist/forms/named-control-values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"named-control-values.js","sourceRoot":"","sources":["../../src/forms/named-control-values.ts"],"names":[],"mappings":"AAuBA,SAAS,SAAS,CAAC,MAAoC,EAAE,EAAU;IACjE,KAAK,MAAM,KAAK,IAAI,MAAM,IAAI,EAAE,EAAE,CAAC;QACjC,IAAI,KAAK,CAAC,EAAE,KAAK,EAAE;YAAE,OAAO,KAAK,CAAA;QACjC,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,QAAwC,EAAE,EAAE,CAAC,CAAA;QAC3E,IAAI,KAAK;YAAE,OAAO,KAAK,CAAA;IACzB,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,SAAS,OAAO,CACd,MAAoC,EACpC,KAA8B,EAC9B,IAA6B,EAC7B,IAAiB;IAEjB,KAAK,MAAM,KAAK,IAAI,MAAM,IAAI,EAAE,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAA4B,CAAA;QAC5D,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAA;QAC1B,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,CAAA;QAClC,IACE,OAAO,IAAI,KAAK,QAAQ;YACxB,IAAI;YACJ,OAAO,QAAQ,KAAK,QAAQ;YAC5B,QAAQ;YACR,KAAK,CAAC,UAAU,CAAC,KAAK,IAAI;YAC1B,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YACf,KAAK,CAAC,QAAQ,CAAC,KAAK,SAAS,EAC7B,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAA;YAC5B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAChB,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,QAAwC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;IAC5E,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CACxC,MAAwB,EACxB,MAAc,EACd,MAA+B,EAC/B,KAA8B;IAE9B,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACtC,IAAI,CAAC,IAAI;QAAE,OAAO,MAAM,CAAA;IACxB,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;IACzC,MAAM,KAAK,GAA4B,EAAE,CAAA;IACzC,OAAO,CAAC,IAAI,CAAC,QAAwC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,CAAA;IAC1E,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAA;AACzE,CAAC"}

package/dist/forms/processor.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Form Processor
+ *
+ * Form processing implementation
+ *
+ * @module @pwfabric/runtime/forms/processor
+ */
+import type { ZodType } from 'zod';
+import type { FormProcessor, FormField, FormSubmitHandler, FormResult, FormError, FormValidationResult, FormProcessorConfig } from './types.js';
+/**
+ * Default form processor implementation
+ */
+export declare class DefaultFormProcessor implements FormProcessor {
+    private readonly validator;
+    private readonly config;
+    constructor(config?: FormProcessorConfig);
+    validate(values: Record<string, unknown>, fields: readonly FormField[]): FormValidationResult;
+    validateWithSchema<T>(values: Record<string, unknown>, schema: ZodType<T>): FormValidationResult;
+    process<T>(_formId: string, values: Record<string, unknown>, handler: FormSubmitHandler<T>): Promise<FormResult<T>>;
+    /**
+     * Process form with validation
+     */
+    processWithValidation<T>(formId: string, values: Record<string, unknown>, fields: readonly FormField[], handler: FormSubmitHandler<T>): Promise<FormResult<T>>;
+    /**
+     * Process form with Zod schema validation
+     */
+    processWithSchema<T, TOutput>(formId: string, values: Record<string, unknown>, schema: ZodType<TOutput>, handler: FormSubmitHandler<T>): Promise<FormResult<T>>;
+    private createFormError;
+}
+/**
+ * Create a form processor
+ */
+export declare function createFormProcessor(config?: FormProcessorConfig): FormProcessor;
+/**
+ * Check if a form result is successful
+ */
+export declare function isFormSuccess<T>(result: FormResult<T>): result is {
+    success: true;
+    data: T;
+};
+/**
+ * Check if a form result is a failure
+ */
+export declare function isFormFailure<T>(result: FormResult<T>): result is {
+    success: false;
+    error: FormError;
+};
+/**
+ * Format form validation errors into a single message
+ */
+export declare function formatFormErrors(errors: Record<string, string[]>): string;
+/**
+ * Get all error messages as a flat array
+ */
+export declare function getErrorMessages(errors: Record<string, string[]>): string[];
+//# sourceMappingURL=processor.d.ts.map

package/dist/forms/processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processor.d.ts","sourceRoot":"","sources":["../../src/forms/processor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAA;AAClC,OAAO,KAAK,EACV,aAAa,EACb,SAAS,EACT,iBAAiB,EACjB,UAAU,EACV,SAAS,EACT,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,YAAY,CAAA;AAOnB;;GAEG;AACH,qBAAa,oBAAqB,YAAW,aAAa;IACxD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+B;gBAE1C,MAAM,GAAE,mBAAwB;IAU5C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,SAAS,EAAE,GAAG,oBAAoB;IAI7F,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,oBAAoB;IAI1F,OAAO,CAAC,CAAC,EACb,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC5B,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAezB;;OAEG;IACG,qBAAqB,CAAC,CAAC,EAC3B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,SAAS,SAAS,EAAE,EAC5B,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC5B,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAoBzB;;OAEG;IACG,iBAAiB,CAAC,CAAC,EAAE,OAAO,EAChC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,EACxB,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC5B,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAkBzB,OAAO,CAAC,eAAe;CA4BxB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,aAAa,CAE/E;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,CAE5F;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,GACpB,MAAM,IAAI;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAEhD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,CAUzE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,EAAE,CAQ3E"}

package/dist/forms/processor.js

@@ -0,0 +1,154 @@
+/**
+ * Form Processor
+ *
+ * Form processing implementation
+ *
+ * @module @pwfabric/runtime/forms/processor
+ */
+import { DefaultFormValidator, validateWithZod } from './validator.js';
+// ============================================================
+// DEFAULT FORM PROCESSOR
+// ============================================================
+/**
+ * Default form processor implementation
+ */
+export class DefaultFormProcessor {
+    validator;
+    config;
+    constructor(config = {}) {
+        this.validator = new DefaultFormValidator(config.messages);
+        this.config = {
+            validateOnSubmit: config.validateOnSubmit ?? true,
+            validateOnBlur: config.validateOnBlur ?? true,
+            validateOnChange: config.validateOnChange ?? false,
+            messages: config.messages ?? {},
+        };
+    }
+    validate(values, fields) {
+        return this.validator.validateAll(values, fields);
+    }
+    validateWithSchema(values, schema) {
+        return validateWithZod(values, schema);
+    }
+    async process(_formId, values, handler) {
+        try {
+            const result = await handler(values);
+            return {
+                success: true,
+                data: result,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: this.createFormError(error),
+            };
+        }
+    }
+    /**
+     * Process form with validation
+     */
+    async processWithValidation(formId, values, fields, handler) {
+        // Validate first if enabled
+        if (this.config.validateOnSubmit) {
+            const validationResult = this.validate(values, fields);
+            if (!validationResult.valid) {
+                return {
+                    success: false,
+                    error: {
+                        type: 'validation_failed',
+                        message: 'Form validation failed',
+                        validationErrors: validationResult.errors,
+                    },
+                };
+            }
+        }
+        return this.process(formId, values, handler);
+    }
+    /**
+     * Process form with Zod schema validation
+     */
+    async processWithSchema(formId, values, schema, handler) {
+        // Validate with Zod schema
+        const validationResult = this.validateWithSchema(values, schema);
+        if (!validationResult.valid) {
+            return {
+                success: false,
+                error: {
+                    type: 'validation_failed',
+                    message: 'Form validation failed',
+                    validationErrors: validationResult.errors,
+                },
+            };
+        }
+        return this.process(formId, values, handler);
+    }
+    createFormError(error) {
+        if (error instanceof Error) {
+            // Check for network errors
+            if (error.name === 'NetworkError' ||
+                error.message.includes('network') ||
+                error.message.includes('fetch')) {
+                return {
+                    type: 'network_error',
+                    message: 'A network error occurred. Please try again.',
+                    cause: error,
+                };
+            }
+            return {
+                type: 'processing_failed',
+                message: error.message,
+                cause: error,
+            };
+        }
+        return {
+            type: 'unknown',
+            message: 'An unexpected error occurred',
+            cause: error,
+        };
+    }
+}
+/**
+ * Create a form processor
+ */
+export function createFormProcessor(config) {
+    return new DefaultFormProcessor(config);
+}
+// ============================================================
+// HELPER FUNCTIONS
+// ============================================================
+/**
+ * Check if a form result is successful
+ */
+export function isFormSuccess(result) {
+    return result.success;
+}
+/**
+ * Check if a form result is a failure
+ */
+export function isFormFailure(result) {
+    return !result.success;
+}
+/**
+ * Format form validation errors into a single message
+ */
+export function formatFormErrors(errors) {
+    const messages = [];
+    for (const [field, fieldErrors] of Object.entries(errors)) {
+        for (const error of fieldErrors) {
+            messages.push(`${field}: ${error}`);
+        }
+    }
+    return messages.join('. ');
+}
+/**
+ * Get all error messages as a flat array
+ */
+export function getErrorMessages(errors) {
+    const messages = [];
+    for (const fieldErrors of Object.values(errors)) {
+        messages.push(...fieldErrors);
+    }
+    return messages;
+}
+//# sourceMappingURL=processor.js.map

package/dist/forms/processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processor.js","sourceRoot":"","sources":["../../src/forms/processor.ts"],"names":[],"mappings":"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"}

package/dist/forms/types.d.ts

@@ -0,0 +1,175 @@
+/**
+ * Form Processing Types
+ *
+ * Form processing capability for surfaces
+ *
+ * @module @pwfabric/runtime/forms/types
+ */
+import type { ZodType } from 'zod';
+/**
+ * Form field input type
+ */
+export type FormFieldType = 'text' | 'email' | 'number' | 'select' | 'checkbox' | 'textarea' | 'password' | 'tel' | 'url' | 'date' | 'hidden';
+/**
+ * Validation rule type
+ */
+export type ValidationRuleType = 'required' | 'minLength' | 'maxLength' | 'min' | 'max' | 'pattern' | 'email' | 'url' | 'custom';
+/**
+ * Validation rule definition
+ */
+export interface ValidationRule {
+    readonly type: ValidationRuleType;
+    readonly value?: unknown;
+    readonly message: string;
+}
+/**
+ * Select option for select fields
+ */
+export interface SelectOption {
+    readonly value: string | number;
+    readonly label: string;
+    readonly disabled?: boolean;
+}
+/**
+ * Form field definition
+ */
+export interface FormField {
+    readonly name: string;
+    readonly type: FormFieldType;
+    readonly label?: string;
+    readonly placeholder?: string;
+    readonly required?: boolean;
+    readonly disabled?: boolean;
+    readonly defaultValue?: unknown;
+    readonly validation?: readonly ValidationRule[];
+    readonly options?: readonly SelectOption[];
+}
+/**
+ * Form state tracking
+ */
+export interface FormState {
+    readonly values: Record<string, unknown>;
+    readonly errors: Record<string, string[]>;
+    readonly touched: Record<string, boolean>;
+    readonly isValid: boolean;
+    readonly isSubmitting: boolean;
+    readonly isDirty: boolean;
+    readonly submitCount: number;
+}
+/**
+ * Initial form state
+ */
+export declare const INITIAL_FORM_STATE: FormState;
+/**
+ * Result of validating form values
+ */
+export interface FormValidationResult {
+    readonly valid: boolean;
+    readonly errors: Record<string, string[]>;
+}
+/**
+ * Successful validation result
+ */
+export interface FormValidationSuccess extends FormValidationResult {
+    readonly valid: true;
+    readonly errors: Record<string, never>;
+}
+/**
+ * Failed validation result
+ */
+export interface FormValidationFailure extends FormValidationResult {
+    readonly valid: false;
+    readonly errors: Record<string, string[]>;
+}
+/**
+ * Result of form processing
+ */
+export type FormResult<T = unknown> = {
+    readonly success: true;
+    readonly data: T;
+} | {
+    readonly success: false;
+    readonly error: FormError;
+};
+/**
+ * Form processing error
+ */
+export interface FormError {
+    readonly type: 'validation_failed' | 'processing_failed' | 'network_error' | 'unknown';
+    readonly message: string;
+    readonly validationErrors?: Record<string, string[]>;
+    readonly cause?: unknown;
+}
+/**
+ * Form submission handler function
+ */
+export type FormSubmitHandler<T = unknown> = (values: Record<string, unknown>) => Promise<T> | T;
+/**
+ * Form processor interface
+ */
+export interface FormProcessor {
+    /**
+     * Validate form values against field definitions
+     */
+    validate(values: Record<string, unknown>, fields: readonly FormField[]): FormValidationResult;
+    /**
+     * Validate form values using a Zod schema
+     */
+    validateWithSchema<T>(values: Record<string, unknown>, schema: ZodType<T>): FormValidationResult;
+    /**
+     * Process a form submission
+     */
+    process<T>(formId: string, values: Record<string, unknown>, handler: FormSubmitHandler<T>): Promise<FormResult<T>>;
+}
+/**
+ * Form validator interface
+ */
+export interface FormValidator {
+    /**
+     * Validate a single field value
+     */
+    validateField(value: unknown, field: FormField): string[];
+    /**
+     * Validate all fields
+     */
+    validateAll(values: Record<string, unknown>, fields: readonly FormField[]): FormValidationResult;
+}
+/**
+ * Form processor configuration
+ */
+export interface FormProcessorConfig {
+    /**
+     * Whether to validate on submit
+     */
+    readonly validateOnSubmit?: boolean;
+    /**
+     * Whether to validate individual fields on blur
+     */
+    readonly validateOnBlur?: boolean;
+    /**
+     * Whether to validate individual fields on change
+     */
+    readonly validateOnChange?: boolean;
+    /**
+     * Custom error messages
+     */
+    readonly messages?: Partial<ValidationMessages>;
+}
+/**
+ * Default validation error messages
+ */
+export interface ValidationMessages {
+    readonly required: string;
+    readonly email: string;
+    readonly url: string;
+    readonly minLength: string;
+    readonly maxLength: string;
+    readonly min: string;
+    readonly max: string;
+    readonly pattern: string;
+}
+/**
+ * Default validation messages
+ */
+export declare const DEFAULT_VALIDATION_MESSAGES: ValidationMessages;
+//# sourceMappingURL=types.d.ts.map

package/dist/forms/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/forms/types.ts"],"names":[],"mappings":"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"}

package/dist/forms/types.js

@@ -0,0 +1,33 @@
+/**
+ * Form Processing Types
+ *
+ * Form processing capability for surfaces
+ *
+ * @module @pwfabric/runtime/forms/types
+ */
+/**
+ * Initial form state
+ */
+export const INITIAL_FORM_STATE = {
+    values: {},
+    errors: {},
+    touched: {},
+    isValid: true,
+    isSubmitting: false,
+    isDirty: false,
+    submitCount: 0,
+};
+/**
+ * Default validation messages
+ */
+export const DEFAULT_VALIDATION_MESSAGES = {
+    required: 'This field is required',
+    email: 'Please enter a valid email address',
+    url: 'Please enter a valid URL',
+    minLength: 'Must be at least {value} characters',
+    maxLength: 'Must be no more than {value} characters',
+    min: 'Must be at least {value}',
+    max: 'Must be no more than {value}',
+    pattern: 'Invalid format',
+};
+//# sourceMappingURL=types.js.map

package/dist/forms/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/forms/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAwFH;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAc;IAC3C,MAAM,EAAE,EAAE;IACV,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,EAAE;IACX,OAAO,EAAE,IAAI;IACb,YAAY,EAAE,KAAK;IACnB,OAAO,EAAE,KAAK;IACd,WAAW,EAAE,CAAC;CACf,CAAA;AAkJD;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAuB;IAC7D,QAAQ,EAAE,wBAAwB;IAClC,KAAK,EAAE,oCAAoC;IAC3C,GAAG,EAAE,0BAA0B;IAC/B,SAAS,EAAE,qCAAqC;IAChD,SAAS,EAAE,yCAAyC;IACpD,GAAG,EAAE,0BAA0B;IAC/B,GAAG,EAAE,8BAA8B;IACnC,OAAO,EAAE,gBAAgB;CAC1B,CAAA"}

package/dist/forms/validator.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Form Validator
+ *
+ * Form validation implementation
+ *
+ * @module @pwfabric/runtime/forms/validator
+ */
+import { z, type ZodType } from 'zod';
+import type { FormValidator, FormField, FormValidationResult, ValidationMessages } from './types.js';
+/**
+ * Default form validator implementation
+ */
+export declare class DefaultFormValidator implements FormValidator {
+    private readonly messages;
+    constructor(customMessages?: Partial<ValidationMessages>);
+    validateField(value: unknown, field: FormField): string[];
+    validateAll(values: Record<string, unknown>, fields: readonly FormField[]): FormValidationResult;
+    private validateRule;
+    private isEmpty;
+    private validateEmail;
+    private validateUrl;
+    private validateMinLength;
+    private validateMaxLength;
+    private validateMin;
+    private validateMax;
+    private validatePattern;
+    private formatMessage;
+}
+/**
+ * Validate values using a Zod schema
+ */
+export declare function validateWithZod<T>(values: Record<string, unknown>, schema: ZodType<T>): FormValidationResult;
+/**
+ * Common Zod schemas for form validation
+ */
+export declare const FormSchemas: {
+    /**
+     * Email validation schema
+     */
+    email: z.ZodString;
+    /**
+     * Required string schema
+     */
+    requiredString: z.ZodString;
+    /**
+     * URL validation schema
+     */
+    url: z.ZodString;
+    /**
+     * Phone number schema (basic)
+     */
+    phone: z.ZodString;
+    /**
+     * Password schema (min 8 chars, at least one number and letter)
+     */
+    password: z.ZodString;
+};
+/**
+ * Create a form validator
+ */
+export declare function createFormValidator(customMessages?: Partial<ValidationMessages>): FormValidator;
+//# sourceMappingURL=validator.d.ts.map

package/dist/forms/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/forms/validator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,KAAK,OAAO,EAAiB,MAAM,KAAK,CAAA;AACpD,OAAO,KAAK,EACV,aAAa,EACb,SAAS,EAET,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,YAAY,CAAA;AAOnB;;GAEG;AACH,qBAAa,oBAAqB,YAAW,aAAa;IACxD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;gBAEjC,cAAc,GAAE,OAAO,CAAC,kBAAkB,CAAM;IAI5D,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM,EAAE;IA2BzD,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,SAAS,EAAE,GAAG,oBAAoB;IAoBhG,OAAO,CAAC,YAAY;IAuCpB,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,WAAW;IAWnB,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,eAAe;IAWvB,OAAO,CAAC,aAAa;CAGtB;AAMD;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GACjB,oBAAoB,CActB;AAuBD;;GAEG;AACH,eAAO,MAAM,WAAW;IACtB;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;CAMJ,CAAA;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,aAAa,CAE/F"}