@page-speed/forms 0.1.0

package/dist/types-Cw5CeZP-.d.ts

@@ -0,0 +1,387 @@
+import { ReactNode } from 'react';
+
+/**
+ * Core TypeScript types for @page-speed/forms
+ *
+ * Provides type-safe form state management, validation, and submission handling
+ */
+
+/**
+ * Generic form values type
+ * Represents the structure of form data
+ */
+type FormValues = Record<string, any>;
+/**
+ * Form errors type
+ * Maps field names to error messages
+ */
+type FormErrors<T extends FormValues = FormValues> = {
+    [K in keyof T]?: string | string[];
+};
+/**
+ * Touched fields type
+ * Tracks which fields have been interacted with
+ */
+type TouchedFields<T extends FormValues = FormValues> = {
+    [K in keyof T]?: boolean;
+};
+/**
+ * Field validation function
+ * Validates a single field value
+ */
+type FieldValidator<T = any> = (value: T, allValues: FormValues) => string | undefined | Promise<string | undefined>;
+/**
+ * Form validation schema
+ * Defines validation rules for form fields
+ */
+type ValidationSchema<T extends FormValues = FormValues> = {
+    [K in keyof T]?: FieldValidator<T[K]> | FieldValidator<T[K]>[];
+};
+/**
+ * Validation mode configuration
+ */
+type ValidationMode = "onChange" | "onBlur" | "onSubmit";
+/**
+ * Form submission status
+ */
+type SubmissionStatus = "idle" | "submitting" | "success" | "error";
+/**
+ * Form helpers provided to submission handler
+ */
+interface FormHelpers<T extends FormValues = FormValues> {
+    /**
+     * Set form values
+     */
+    setValues: (values: T | ((prev: T) => T)) => void;
+    /**
+     * Set a single field value
+     */
+    setFieldValue: <K extends keyof T>(field: K, value: T[K]) => void;
+    /**
+     * Set form errors
+     */
+    setErrors: (errors: FormErrors<T>) => void;
+    /**
+     * Set a single field error
+     */
+    setFieldError: <K extends keyof T>(field: K, error: string | undefined) => void;
+    /**
+     * Set touched fields
+     */
+    setTouched: (touched: TouchedFields<T>) => void;
+    /**
+     * Set a single field as touched
+     */
+    setFieldTouched: <K extends keyof T>(field: K, touched: boolean) => void;
+    /**
+     * Mark submission as complete
+     */
+    setSubmitting: (submitting: boolean) => void;
+    /**
+     * Reset form to initial values
+     */
+    resetForm: () => void;
+}
+/**
+ * Form submission handler
+ */
+type SubmitHandler<T extends FormValues = FormValues> = (values: T, helpers: FormHelpers<T>) => void | Promise<void>;
+/**
+ * Form error handler
+ */
+type ErrorHandler<T extends FormValues = FormValues> = (errors: FormErrors<T>) => void;
+/**
+ * useForm hook options
+ */
+interface UseFormOptions<T extends FormValues = FormValues> {
+    /**
+     * Initial form values
+     */
+    initialValues: T;
+    /**
+     * Validation schema
+     */
+    validationSchema?: ValidationSchema<T>;
+    /**
+     * When to validate fields
+     * @default "onBlur"
+     */
+    validateOn?: ValidationMode;
+    /**
+     * When to revalidate fields after initial validation
+     * @default "onChange"
+     */
+    revalidateOn?: ValidationMode;
+    /**
+     * Form submission handler
+     */
+    onSubmit: SubmitHandler<T>;
+    /**
+     * Form error handler
+     */
+    onError?: ErrorHandler<T>;
+    /**
+     * Enable debug mode
+     * @default false
+     */
+    debug?: boolean;
+}
+/**
+ * Form state returned by useForm
+ */
+interface FormState<T extends FormValues = FormValues> {
+    /**
+     * Current form values
+     */
+    values: T;
+    /**
+     * Current form errors
+     */
+    errors: FormErrors<T>;
+    /**
+     * Touched fields
+     */
+    touched: TouchedFields<T>;
+    /**
+     * Is form currently submitting
+     */
+    isSubmitting: boolean;
+    /**
+     * Is form valid (no errors)
+     */
+    isValid: boolean;
+    /**
+     * Has form been touched
+     */
+    isDirty: boolean;
+    /**
+     * Submission status
+     */
+    status: SubmissionStatus;
+}
+/**
+ * Form actions returned by useForm
+ */
+interface FormActions<T extends FormValues = FormValues> {
+    /**
+     * Handle form submission
+     */
+    handleSubmit: (e?: React.FormEvent) => Promise<void>;
+    /**
+     * Set form values
+     */
+    setValues: (values: T | ((prev: T) => T)) => void;
+    /**
+     * Set a single field value
+     */
+    setFieldValue: <K extends keyof T>(field: K, value: T[K]) => void;
+    /**
+     * Set form errors
+     */
+    setErrors: (errors: FormErrors<T>) => void;
+    /**
+     * Set a single field error
+     */
+    setFieldError: <K extends keyof T>(field: K, error: string | undefined) => void;
+    /**
+     * Set touched fields
+     */
+    setTouched: (touched: TouchedFields<T>) => void;
+    /**
+     * Set a single field as touched
+     */
+    setFieldTouched: <K extends keyof T>(field: K, touched: boolean) => void;
+    /**
+     * Validate entire form
+     */
+    validateForm: () => Promise<FormErrors<T>>;
+    /**
+     * Validate a single field
+     */
+    validateField: <K extends keyof T>(field: K) => Promise<string | undefined>;
+    /**
+     * Reset form to initial values
+     */
+    resetForm: () => void;
+    /**
+     * Get field props for binding to inputs
+     */
+    getFieldProps: <K extends keyof T>(field: K) => FieldInputProps<T[K]>;
+    /**
+     * Get field meta information
+     */
+    getFieldMeta: <K extends keyof T>(field: K) => FieldMeta;
+}
+/**
+ * Complete form API returned by useForm
+ */
+type UseFormReturn<T extends FormValues = FormValues> = FormState<T> & FormActions<T>;
+/**
+ * Field input props for binding to form inputs
+ */
+interface FieldInputProps<T = any> {
+    name: string;
+    value: T;
+    onChange: (value: T) => void;
+    onBlur: () => void;
+}
+/**
+ * Field meta information
+ */
+interface FieldMeta {
+    error?: string | string[];
+    touched: boolean;
+    isDirty: boolean;
+    isValidating: boolean;
+}
+/**
+ * useField hook options
+ */
+interface UseFieldOptions<T = any> {
+    /**
+     * Field name
+     */
+    name: string;
+    /**
+     * Field validator
+     */
+    validate?: FieldValidator<T>;
+    /**
+     * Transform value before setting
+     */
+    transform?: (value: any) => T;
+}
+/**
+ * Field state returned by useField
+ */
+interface UseFieldReturn<T = any> {
+    /**
+     * Input props for binding to form controls
+     */
+    field: FieldInputProps<T>;
+    /**
+     * Field meta information
+     */
+    meta: FieldMeta;
+    /**
+     * Field helpers
+     */
+    helpers: {
+        setValue: (value: T) => void;
+        setTouched: (touched: boolean) => void;
+        setError: (error: string | undefined) => void;
+    };
+}
+/**
+ * Form component props
+ */
+interface FormProps<T extends FormValues = FormValues> {
+    /**
+     * Form instance from useForm
+     */
+    form: UseFormReturn<T>;
+    /**
+     * Form children
+     */
+    children: ReactNode;
+    /**
+     * Additional className
+     */
+    className?: string;
+    /**
+     * Form action URL (for progressive enhancement)
+     */
+    action?: string;
+    /**
+     * Form method (for progressive enhancement)
+     */
+    method?: "get" | "post";
+    /**
+     * Disable browser validation
+     * @default true
+     */
+    noValidate?: boolean;
+}
+/**
+ * Field component props
+ */
+interface FieldProps {
+    /**
+     * Field name
+     */
+    name: string;
+    /**
+     * Field label
+     */
+    label?: ReactNode;
+    /**
+     * Field description
+     */
+    description?: ReactNode;
+    /**
+     * Field children (render prop or component)
+     */
+    children: ReactNode | ((field: UseFieldReturn) => ReactNode);
+    /**
+     * Show error immediately
+     * @default false
+     */
+    showError?: boolean;
+    /**
+     * Additional className
+     */
+    className?: string;
+    /**
+     * Field validator
+     */
+    validate?: FieldValidator;
+}
+/**
+ * Input component base props
+ */
+interface InputProps<T = string> {
+    /**
+     * Input name
+     */
+    name: string;
+    /**
+     * Input value
+     */
+    value: T;
+    /**
+     * Change handler
+     */
+    onChange: (value: T) => void;
+    /**
+     * Blur handler
+     */
+    onBlur?: () => void;
+    /**
+     * Placeholder text
+     */
+    placeholder?: string;
+    /**
+     * Is input disabled
+     */
+    disabled?: boolean;
+    /**
+     * Is input required
+     */
+    required?: boolean;
+    /**
+     * Has error
+     */
+    error?: boolean;
+    /**
+     * Additional className
+     */
+    className?: string;
+    /**
+     * ARIA attributes
+     */
+    "aria-invalid"?: boolean;
+    "aria-describedby"?: string;
+    "aria-required"?: boolean;
+}
+
+export type { ErrorHandler as E, FieldValidator as F, InputProps as I, SubmissionStatus as S, TouchedFields as T, UseFormOptions as U, ValidationSchema as V, ValidationMode as a, FormValues as b, UseFormReturn as c, UseFieldOptions as d, UseFieldReturn as e, FormProps as f, FieldProps as g, FormErrors as h, FormHelpers as i, SubmitHandler as j, FormState as k, FormActions as l, FieldInputProps as m, FieldMeta as n };

package/dist/upload.cjs

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=upload.cjs.map
+//# sourceMappingURL=upload.cjs.map

package/dist/upload.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"upload.cjs"}

package/dist/upload.d.cts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/upload.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/upload.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=upload.js.map
+//# sourceMappingURL=upload.js.map

package/dist/upload.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"upload.js"}

package/dist/validation-rules.cjs

@@ -0,0 +1,80 @@
+'use strict';
+
+var chunk2FXAQT7S_cjs = require('./chunk-2FXAQT7S.cjs');
+
+
+
+Object.defineProperty(exports, "alpha", {
+  enumerable: true,
+  get: function () { return chunk2FXAQT7S_cjs.alpha; }
+});
+Object.defineProperty(exports, "alphanumeric", {
+  enumerable: true,
+  get: function () { return chunk2FXAQT7S_cjs.alphanumeric; }
+});
+Object.defineProperty(exports, "compose", {
+  enumerable: true,
+  get: function () { return chunk2FXAQT7S_cjs.compose; }
+});
+Object.defineProperty(exports, "creditCard", {
+  enumerable: true,
+  get: function () { return chunk2FXAQT7S_cjs.creditCard; }
+});
+Object.defineProperty(exports, "email", {
+  enumerable: true,
+  get: function () { return chunk2FXAQT7S_cjs.email; }
+});
+Object.defineProperty(exports, "integer", {
+  enumerable: true,
+  get: function () { return chunk2FXAQT7S_cjs.integer; }
+});
+Object.defineProperty(exports, "matches", {
+  enumerable: true,
+  get: function () { return chunk2FXAQT7S_cjs.matches; }
+});
+Object.defineProperty(exports, "max", {
+  enumerable: true,
+  get: function () { return chunk2FXAQT7S_cjs.max; }
+});
+Object.defineProperty(exports, "maxLength", {
+  enumerable: true,
+  get: function () { return chunk2FXAQT7S_cjs.maxLength; }
+});
+Object.defineProperty(exports, "min", {
+  enumerable: true,
+  get: function () { return chunk2FXAQT7S_cjs.min; }
+});
+Object.defineProperty(exports, "minLength", {
+  enumerable: true,
+  get: function () { return chunk2FXAQT7S_cjs.minLength; }
+});
+Object.defineProperty(exports, "numeric", {
+  enumerable: true,
+  get: function () { return chunk2FXAQT7S_cjs.numeric; }
+});
+Object.defineProperty(exports, "oneOf", {
+  enumerable: true,
+  get: function () { return chunk2FXAQT7S_cjs.oneOf; }
+});
+Object.defineProperty(exports, "pattern", {
+  enumerable: true,
+  get: function () { return chunk2FXAQT7S_cjs.pattern; }
+});
+Object.defineProperty(exports, "phone", {
+  enumerable: true,
+  get: function () { return chunk2FXAQT7S_cjs.phone; }
+});
+Object.defineProperty(exports, "postalCode", {
+  enumerable: true,
+  get: function () { return chunk2FXAQT7S_cjs.postalCode; }
+});
+Object.defineProperty(exports, "required", {
+  enumerable: true,
+  get: function () { return chunk2FXAQT7S_cjs.required; }
+});
+Object.defineProperty(exports, "url", {
+  enumerable: true,
+  get: function () { return chunk2FXAQT7S_cjs.url; }
+});
+//# sourceMappingURL=validation-rules.cjs.map
+//# sourceMappingURL=validation-rules.cjs.map

package/dist/validation-rules.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"validation-rules.cjs"}

package/dist/validation-rules.d.cts

@@ -0,0 +1,123 @@
+import { F as FieldValidator } from './types-Cw5CeZP-.cjs';
+import 'react';
+
+/**
+ * @page-speed/forms - Validation Rules
+ *
+ * Common validation rules for form fields.
+ * Tree-shakable - import only the rules you need.
+ *
+ * @example
+ * ```tsx
+ * import { required, email, minLength } from '@page-speed/forms/validation/rules';
+ *
+ * const form = useForm({
+ *   validationSchema: {
+ *     email: [required(), email()],
+ *     password: [required(), minLength(8)],
+ *   }
+ * });
+ * ```
+ */
+
+/**
+ * Error message template function
+ * Allows customization of error messages
+ */
+type ErrorMessageFn = (params?: Record<string, any>) => string;
+/**
+ * Validation rule options
+ */
+interface ValidationRuleOptions {
+    /**
+     * Custom error message
+     */
+    message?: string | ErrorMessageFn;
+}
+/**
+ * Required field validator
+ * Ensures field has a truthy value
+ */
+declare function required(options?: ValidationRuleOptions): FieldValidator;
+/**
+ * Email validator
+ * Validates email format using RFC 5322 compatible regex
+ */
+declare function email(options?: ValidationRuleOptions): FieldValidator;
+/**
+ * URL validator
+ * Validates URL format
+ */
+declare function url(options?: ValidationRuleOptions): FieldValidator;
+/**
+ * Phone number validator
+ * Validates US phone numbers (flexible formats)
+ */
+declare function phone(options?: ValidationRuleOptions): FieldValidator;
+/**
+ * Minimum length validator
+ */
+declare function minLength(min: number, options?: ValidationRuleOptions): FieldValidator;
+/**
+ * Maximum length validator
+ */
+declare function maxLength(max: number, options?: ValidationRuleOptions): FieldValidator;
+/**
+ * Minimum value validator (for numbers)
+ */
+declare function min(minValue: number, options?: ValidationRuleOptions): FieldValidator;
+/**
+ * Maximum value validator (for numbers)
+ */
+declare function max(maxValue: number, options?: ValidationRuleOptions): FieldValidator;
+/**
+ * Pattern validator
+ * Validates against a regular expression
+ */
+declare function pattern(regex: RegExp, options?: ValidationRuleOptions): FieldValidator;
+/**
+ * Match validator
+ * Ensures field matches another field (e.g., password confirmation)
+ */
+declare function matches(fieldName: string, options?: ValidationRuleOptions): FieldValidator;
+/**
+ * One of validator
+ * Ensures value is one of the allowed values
+ */
+declare function oneOf<T = any>(allowedValues: T[], options?: ValidationRuleOptions): FieldValidator<T>;
+/**
+ * Credit card validator
+ * Validates credit card numbers using Luhn algorithm
+ */
+declare function creditCard(options?: ValidationRuleOptions): FieldValidator;
+/**
+ * Postal code validator (US ZIP codes)
+ */
+declare function postalCode(options?: ValidationRuleOptions): FieldValidator;
+/**
+ * Alpha validator
+ * Ensures value contains only alphabetic characters
+ */
+declare function alpha(options?: ValidationRuleOptions): FieldValidator;
+/**
+ * Alphanumeric validator
+ * Ensures value contains only letters and numbers
+ */
+declare function alphanumeric(options?: ValidationRuleOptions): FieldValidator;
+/**
+ * Numeric validator
+ * Ensures value is a valid number
+ */
+declare function numeric(options?: ValidationRuleOptions): FieldValidator;
+/**
+ * Integer validator
+ * Ensures value is a valid integer
+ */
+declare function integer(options?: ValidationRuleOptions): FieldValidator;
+/**
+ * Compose multiple validators
+ * Runs validators in sequence and returns first error
+ */
+declare function compose(...validators: FieldValidator[]): FieldValidator;
+
+export { type ErrorMessageFn, type ValidationRuleOptions, alpha, alphanumeric, compose, creditCard, email, integer, matches, max, maxLength, min, minLength, numeric, oneOf, pattern, phone, postalCode, required, url };