@formhaus/core 0.1.0

package/dist/validation/validate-field.js

@@ -0,0 +1,61 @@
+import { getDefaultMessage } from './default-messages';
+function isEmpty(value) {
+    return value === undefined || value === null || value === '';
+}
+export function validateField(field, value, allValues, validators) {
+    const rules = field.validation;
+    if (!rules)
+        return null;
+    if (rules.required) {
+        if (isEmpty(value)) {
+            return typeof rules.required === 'string' ? rules.required : getDefaultMessage('required');
+        }
+    }
+    // Skip remaining rules if value is empty and not required
+    if (isEmpty(value))
+        return null;
+    if (rules.minLength !== undefined && typeof value === 'string') {
+        if (value.length < rules.minLength) {
+            return rules.minLengthMessage ?? getDefaultMessage('minLength', { min: rules.minLength });
+        }
+    }
+    if (rules.maxLength !== undefined && typeof value === 'string') {
+        if (value.length > rules.maxLength) {
+            return rules.maxLengthMessage ?? getDefaultMessage('maxLength', { max: rules.maxLength });
+        }
+    }
+    if (rules.min !== undefined && typeof value === 'number') {
+        if (value < rules.min) {
+            return rules.minMessage ?? getDefaultMessage('min', { min: rules.min });
+        }
+    }
+    if (rules.max !== undefined && typeof value === 'number') {
+        if (value > rules.max) {
+            return rules.maxMessage ?? getDefaultMessage('max', { max: rules.max });
+        }
+    }
+    if (rules.pattern !== undefined) {
+        try {
+            const regex = new RegExp(rules.pattern);
+            if (!regex.test(String(value))) {
+                return rules.patternMessage ?? getDefaultMessage('pattern');
+            }
+        }
+        catch {
+            // Invalid regex: skip validation silently
+        }
+    }
+    if (rules.matchField !== undefined) {
+        const otherValue = allValues[rules.matchField];
+        if (value !== otherValue) {
+            return rules.matchFieldMessage ?? getDefaultMessage('matchField');
+        }
+    }
+    if (rules.validator !== undefined && validators) {
+        const customValidator = validators[rules.validator];
+        if (customValidator) {
+            return customValidator(value, allValues);
+        }
+    }
+    return null;
+}

package/dist/validation/validate-step.d.ts

@@ -0,0 +1,5 @@
+import type { FormField, FormStep } from '../types';
+import { type ValidatorFn } from './validate-field';
+export declare function validateStep(step: FormStep, values: Record<string, unknown>, validators?: Record<string, ValidatorFn>): Record<string, string>;
+export declare function validateFields(fields: FormField[], values: Record<string, unknown>, validators?: Record<string, ValidatorFn>): Record<string, string>;
+//# sourceMappingURL=validate-step.d.ts.map

package/dist/validation/validate-step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-step.d.ts","sourceRoot":"","sources":["../../src/validation/validate-step.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEpD,OAAO,EAAE,KAAK,WAAW,EAAiB,MAAM,kBAAkB,CAAC;AAEnE,wBAAgB,YAAY,CAC1B,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GACvC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAaxB;AAED,wBAAgB,cAAc,CAC5B,MAAM,EAAE,SAAS,EAAE,EACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GACvC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAaxB"}

package/dist/validation/validate-step.js

@@ -0,0 +1,26 @@
+import { isVisible } from '../visibility';
+import { validateField } from './validate-field';
+export function validateStep(step, values, validators) {
+    const errors = {};
+    for (const field of step.fields) {
+        if (!isVisible(field, values))
+            continue;
+        const error = validateField(field, values[field.key], values, validators);
+        if (error) {
+            errors[field.key] = error;
+        }
+    }
+    return errors;
+}
+export function validateFields(fields, values, validators) {
+    const errors = {};
+    for (const field of fields) {
+        if (!isVisible(field, values))
+            continue;
+        const error = validateField(field, values[field.key], values, validators);
+        if (error) {
+            errors[field.key] = error;
+        }
+    }
+    return errors;
+}

package/dist/visibility/evaluate-condition.d.ts

@@ -0,0 +1,3 @@
+import type { ShowCondition } from '../types';
+export declare function evaluateCondition(condition: ShowCondition, values: Record<string, unknown>): boolean;
+//# sourceMappingURL=evaluate-condition.d.ts.map

package/dist/visibility/evaluate-condition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate-condition.d.ts","sourceRoot":"","sources":["../../src/visibility/evaluate-condition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAwBT"}

package/dist/visibility/evaluate-condition.js

@@ -0,0 +1,19 @@
+export function evaluateCondition(condition, values) {
+    const value = values[condition.field];
+    if (condition.eq !== undefined) {
+        return value === condition.eq;
+    }
+    if (condition.neq !== undefined) {
+        return value !== condition.neq;
+    }
+    if (condition.in !== undefined) {
+        return condition.in.includes(value);
+    }
+    if (condition.notIn !== undefined) {
+        return !condition.notIn.includes(value);
+    }
+    if (condition.notEmpty === true) {
+        return value !== undefined && value !== null && value !== '';
+    }
+    return true;
+}

package/dist/visibility/index.d.ts

@@ -0,0 +1,4 @@
+export { evaluateCondition } from './evaluate-condition';
+export { isStepVisible } from './is-step-visible';
+export { isVisible } from './is-visible';
+//# sourceMappingURL=index.d.ts.map

package/dist/visibility/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/visibility/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC"}

package/dist/visibility/index.js

@@ -0,0 +1,3 @@
+export { evaluateCondition } from './evaluate-condition';
+export { isStepVisible } from './is-step-visible';
+export { isVisible } from './is-visible';

package/dist/visibility/is-step-visible.d.ts

@@ -0,0 +1,3 @@
+import type { FormStep } from '../types';
+export declare function isStepVisible(step: FormStep, values: Record<string, unknown>): boolean;
+//# sourceMappingURL=is-step-visible.d.ts.map

package/dist/visibility/is-step-visible.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-step-visible.d.ts","sourceRoot":"","sources":["../../src/visibility/is-step-visible.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAGzC,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAEtF"}

package/dist/visibility/is-step-visible.js

@@ -0,0 +1,4 @@
+import { isVisible } from './is-visible';
+export function isStepVisible(step, values) {
+    return isVisible(step, values);
+}

package/dist/visibility/is-visible.d.ts

@@ -0,0 +1,3 @@
+import type { FormField } from '../types';
+export declare function isVisible(field: Pick<FormField, 'show' | 'showAny'>, values: Record<string, unknown>): boolean;
+//# sourceMappingURL=is-visible.d.ts.map

package/dist/visibility/is-visible.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-visible.d.ts","sourceRoot":"","sources":["../../src/visibility/is-visible.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAiB,MAAM,UAAU,CAAC;AAgBzD,wBAAgB,SAAS,CACvB,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC,EAC1C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAIT"}

package/dist/visibility/is-visible.js

@@ -0,0 +1,14 @@
+import { evaluateCondition } from './evaluate-condition';
+function evaluateConditions(conditions, mode, values) {
+    if (!conditions || conditions.length === 0)
+        return true;
+    if (mode === 'and') {
+        return conditions.every((c) => evaluateCondition(c, values));
+    }
+    return conditions.some((c) => evaluateCondition(c, values));
+}
+export function isVisible(field, values) {
+    const showResult = evaluateConditions(field.show, 'and', values);
+    const showAnyResult = evaluateConditions(field.showAny, 'or', values);
+    return showResult && showAnyResult;
+}

package/fixtures/basic-form.json

@@ -0,0 +1,46 @@
+{
+  "id": "basic-form",
+  "title": "Contact Information",
+  "submit": { "label": "Submit" },
+  "fields": [
+    {
+      "key": "firstName",
+      "type": "text",
+      "label": "First Name",
+      "placeholder": "Enter your first name",
+      "validation": { "required": true, "minLength": 2 }
+    },
+    {
+      "key": "lastName",
+      "type": "text",
+      "label": "Last Name",
+      "placeholder": "Enter your last name",
+      "validation": { "required": true }
+    },
+    {
+      "key": "email",
+      "type": "email",
+      "label": "Email Address",
+      "placeholder": "you@example.com",
+      "validation": {
+        "required": true,
+        "pattern": "^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$",
+        "patternMessage": "Please enter a valid email address"
+      }
+    },
+    {
+      "key": "country",
+      "type": "select",
+      "label": "Country",
+      "placeholder": "Select a country",
+      "options": [
+        { "value": "US", "label": "United States" },
+        { "value": "MX", "label": "Mexico" },
+        { "value": "CA", "label": "Canada" },
+        { "value": "BR", "label": "Brazil" },
+        { "value": "IN", "label": "India" }
+      ],
+      "validation": { "required": true }
+    }
+  ]
+}

package/fixtures/conditional-fields.json

@@ -0,0 +1,84 @@
+{
+  "id": "conditional-fields",
+  "title": "Payment Details",
+  "submit": { "label": "Continue" },
+  "fields": [
+    {
+      "key": "paymentMethod",
+      "type": "select",
+      "label": "Payment Method",
+      "options": [
+        { "value": "bank", "label": "Bank Transfer" },
+        { "value": "card", "label": "Credit/Debit Card" },
+        { "value": "crypto", "label": "Cryptocurrency" }
+      ],
+      "validation": { "required": true }
+    },
+    {
+      "key": "bankName",
+      "type": "text",
+      "label": "Bank Name",
+      "show": [{ "field": "paymentMethod", "eq": "bank" }],
+      "validation": { "required": true }
+    },
+    {
+      "key": "accountNumber",
+      "type": "text",
+      "label": "Account Number",
+      "show": [{ "field": "paymentMethod", "eq": "bank" }],
+      "validation": { "required": true },
+      "inputMode": "numeric"
+    },
+    {
+      "key": "routingNumber",
+      "type": "text",
+      "label": "Routing Number",
+      "show": [{ "field": "paymentMethod", "eq": "bank" }],
+      "validation": {
+        "required": true,
+        "pattern": "^[0-9]{9}$",
+        "patternMessage": "Routing number must be 9 digits"
+      },
+      "inputMode": "numeric"
+    },
+    {
+      "key": "cardNumber",
+      "type": "text",
+      "label": "Card Number",
+      "show": [{ "field": "paymentMethod", "eq": "card" }],
+      "validation": { "required": true },
+      "inputMode": "numeric"
+    },
+    {
+      "key": "cardExpiry",
+      "type": "text",
+      "label": "Expiry (MM/YY)",
+      "placeholder": "MM/YY",
+      "show": [{ "field": "paymentMethod", "eq": "card" }],
+      "validation": {
+        "required": true,
+        "pattern": "^(0[1-9]|1[0-2])/[0-9]{2}$",
+        "patternMessage": "Format: MM/YY"
+      }
+    },
+    {
+      "key": "walletAddress",
+      "type": "text",
+      "label": "Wallet Address",
+      "show": [{ "field": "paymentMethod", "eq": "crypto" }],
+      "validation": { "required": true }
+    },
+    {
+      "key": "cryptoNetwork",
+      "type": "select",
+      "label": "Network",
+      "show": [{ "field": "paymentMethod", "eq": "crypto" }],
+      "options": [
+        { "value": "ethereum", "label": "Ethereum" },
+        { "value": "tron", "label": "Tron" },
+        { "value": "solana", "label": "Solana" }
+      ],
+      "validation": { "required": true }
+    }
+  ]
+}

package/fixtures/conditional-steps.json

@@ -0,0 +1,79 @@
+{
+  "id": "conditional-steps",
+  "title": "Open Account",
+  "submit": { "label": "Open Account" },
+  "steps": [
+    {
+      "id": "account-type",
+      "title": "Account Type",
+      "fields": [
+        {
+          "key": "accountType",
+          "type": "radio",
+          "label": "What type of account?",
+          "options": [
+            { "value": "personal", "label": "Personal" },
+            { "value": "business", "label": "Business" }
+          ],
+          "validation": { "required": true }
+        },
+        {
+          "key": "fullName",
+          "type": "text",
+          "label": "Full Name",
+          "validation": { "required": true }
+        },
+        {
+          "key": "email",
+          "type": "email",
+          "label": "Email",
+          "validation": { "required": true }
+        }
+      ]
+    },
+    {
+      "id": "business-info",
+      "title": "Business Information",
+      "description": "Tell us about your business",
+      "show": [{ "field": "accountType", "eq": "business" }],
+      "fields": [
+        {
+          "key": "companyName",
+          "type": "text",
+          "label": "Company Name",
+          "validation": { "required": true }
+        },
+        {
+          "key": "taxId",
+          "type": "text",
+          "label": "Tax ID / EIN",
+          "validation": { "required": true }
+        },
+        {
+          "key": "companySize",
+          "type": "select",
+          "label": "Company Size",
+          "options": [
+            { "value": "1-10", "label": "1-10 employees" },
+            { "value": "11-50", "label": "11-50 employees" },
+            { "value": "51-200", "label": "51-200 employees" },
+            { "value": "200+", "label": "200+ employees" }
+          ]
+        }
+      ]
+    },
+    {
+      "id": "review",
+      "title": "Review & Confirm",
+      "description": "Please review your information",
+      "fields": [
+        {
+          "key": "termsAccepted",
+          "type": "checkbox",
+          "label": "I accept the Terms of Service and Privacy Policy",
+          "validation": { "required": "You must accept the terms to continue" }
+        }
+      ]
+    }
+  ]
+}

package/fixtures/dispute-form.json

@@ -0,0 +1,91 @@
+{
+  "id": "dispute-form",
+  "title": "File a Dispute",
+  "submit": { "label": "Submit Dispute" },
+  "cancel": { "label": "Cancel", "variant": "text" },
+  "steps": [
+    {
+      "id": "transaction",
+      "title": "Transaction Details",
+      "description": "Which transaction are you disputing?",
+      "fields": [
+        {
+          "key": "transactionId",
+          "type": "text",
+          "label": "Transaction ID",
+          "helperText": "Found in your transaction history",
+          "validation": { "required": true }
+        },
+        {
+          "key": "disputeType",
+          "type": "radio",
+          "label": "Reason for Dispute",
+          "options": [
+            { "value": "unauthorized", "label": "Unauthorized transaction" },
+            { "value": "not_received", "label": "Transfer not received" },
+            { "value": "wrong_amount", "label": "Wrong amount" },
+            { "value": "duplicate", "label": "Duplicate charge" },
+            { "value": "other", "label": "Other" }
+          ],
+          "validation": { "required": true }
+        },
+        {
+          "key": "disputeAmount",
+          "type": "number",
+          "label": "Disputed Amount (USD)",
+          "show": [{ "field": "disputeType", "eq": "wrong_amount" }],
+          "validation": { "required": true, "min": 0.01 },
+          "inputMode": "numeric"
+        }
+      ]
+    },
+    {
+      "id": "details",
+      "title": "Additional Details",
+      "fields": [
+        {
+          "key": "description",
+          "type": "textarea",
+          "label": "Describe the issue",
+          "helperText": "Please provide as much detail as possible",
+          "validation": {
+            "required": true,
+            "minLength": 20,
+            "minLengthMessage": "Please provide more detail (at least 20 characters)"
+          },
+          "rows": 5
+        },
+        {
+          "key": "contactPreference",
+          "type": "select",
+          "label": "How should we contact you?",
+          "options": [
+            { "value": "email", "label": "Email" },
+            { "value": "phone", "label": "Phone" }
+          ],
+          "defaultValue": "email"
+        },
+        {
+          "key": "phoneNumber",
+          "type": "phone",
+          "label": "Phone Number",
+          "show": [{ "field": "contactPreference", "eq": "phone" }],
+          "validation": { "required": true },
+          "inputMode": "tel"
+        }
+      ]
+    },
+    {
+      "id": "confirm",
+      "title": "Review & Submit",
+      "fields": [
+        {
+          "key": "acknowledgement",
+          "type": "checkbox",
+          "label": "I certify that the information provided is accurate and complete",
+          "validation": { "required": "You must certify the information is accurate" }
+        }
+      ]
+    }
+  ]
+}

package/fixtures/multi-step-form.json

@@ -0,0 +1,108 @@
+{
+  "id": "multi-step",
+  "title": "Account Setup",
+  "submit": { "label": "Create Account" },
+  "steps": [
+    {
+      "id": "personal",
+      "title": "Personal Information",
+      "description": "Tell us about yourself",
+      "fields": [
+        {
+          "key": "firstName",
+          "type": "text",
+          "label": "First Name",
+          "validation": { "required": true }
+        },
+        {
+          "key": "lastName",
+          "type": "text",
+          "label": "Last Name",
+          "validation": { "required": true }
+        },
+        {
+          "key": "email",
+          "type": "email",
+          "label": "Email",
+          "validation": { "required": true }
+        },
+        {
+          "key": "phone",
+          "type": "phone",
+          "label": "Phone Number",
+          "inputMode": "tel"
+        }
+      ]
+    },
+    {
+      "id": "address",
+      "title": "Address",
+      "description": "Where do you live?",
+      "fields": [
+        {
+          "key": "street",
+          "type": "text",
+          "label": "Street Address",
+          "validation": { "required": true }
+        },
+        {
+          "key": "city",
+          "type": "text",
+          "label": "City",
+          "validation": { "required": true }
+        },
+        {
+          "key": "state",
+          "type": "text",
+          "label": "State / Province"
+        },
+        {
+          "key": "zipCode",
+          "type": "text",
+          "label": "ZIP / Postal Code",
+          "validation": { "required": true }
+        },
+        {
+          "key": "country",
+          "type": "select",
+          "label": "Country",
+          "options": [
+            { "value": "US", "label": "United States" },
+            { "value": "MX", "label": "Mexico" },
+            { "value": "CA", "label": "Canada" }
+          ],
+          "validation": { "required": true }
+        }
+      ]
+    },
+    {
+      "id": "preferences",
+      "title": "Preferences",
+      "description": "Customize your experience",
+      "fields": [
+        {
+          "key": "newsletter",
+          "type": "checkbox",
+          "label": "Subscribe to newsletter",
+          "defaultValue": true
+        },
+        {
+          "key": "notifications",
+          "type": "radio",
+          "label": "Notification preference",
+          "options": [
+            { "value": "email", "label": "Email" },
+            { "value": "sms", "label": "SMS" },
+            { "value": "none", "label": "None" }
+          ],
+          "defaultValue": "email"
+        },
+        {
+          "key": "darkMode",
+          "type": "switch",
+          "label": "Dark mode"
+        }
+      ]
+    }
+  ]
+}

package/fixtures/validation-form.json

@@ -0,0 +1,62 @@
+{
+  "id": "validation-form",
+  "title": "Account Registration",
+  "submit": { "label": "Create Account" },
+  "fields": [
+    {
+      "key": "username",
+      "type": "text",
+      "label": "Username",
+      "placeholder": "Choose a username",
+      "validation": {
+        "required": true,
+        "minLength": 3,
+        "maxLength": 20,
+        "pattern": "^[a-zA-Z0-9_]+$",
+        "patternMessage": "Only letters, numbers, and underscores"
+      }
+    },
+    {
+      "key": "email",
+      "type": "email",
+      "label": "Email",
+      "validation": {
+        "required": true,
+        "pattern": "^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$",
+        "patternMessage": "Please enter a valid email"
+      }
+    },
+    {
+      "key": "password",
+      "type": "password",
+      "label": "Password",
+      "helperText": "At least 8 characters",
+      "validation": {
+        "required": true,
+        "minLength": 8,
+        "minLengthMessage": "Password must be at least 8 characters"
+      }
+    },
+    {
+      "key": "confirmPassword",
+      "type": "password",
+      "label": "Confirm Password",
+      "validation": {
+        "required": true,
+        "matchField": "password",
+        "matchFieldMessage": "Passwords do not match"
+      }
+    },
+    {
+      "key": "age",
+      "type": "number",
+      "label": "Age",
+      "validation": {
+        "required": true,
+        "min": 18,
+        "minMessage": "You must be at least 18 years old",
+        "max": 120
+      }
+    }
+  ]
+}