@page-speed/forms 0.1.4 → 0.1.5

package/README.md

@@ -1,4 +1,4 @@
-<img width="1200" height="330" alt="page-speed-forms-npm-module" src="https://github.com/user-attachments/assets/4dd21311-9de6-4c42-be75-bbc8fe5a0192" />
+<img width="1200" height="330" alt="page-speed-forms-library" src="https://github.com/user-attachments/assets/abbcd5be-f5ea-4ae8-a51e-cee16c71c0ab" />
 
 # @page-speed/forms
 

package/dist/core.cjs

@@ -1,28 +1,383 @@
 'use strict';
 
-var chunkZQCPEOB6_cjs = require('./chunk-ZQCPEOB6.cjs');
+var React2 = require('react');
+var react = require('@legendapp/state/react');
 
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
 
+var React2__namespace = /*#__PURE__*/_interopNamespace(React2);
 
-Object.defineProperty(exports, "Field", {
-  enumerable: true,
-  get: function () { return chunkZQCPEOB6_cjs.Field; }
-});
-Object.defineProperty(exports, "Form", {
-  enumerable: true,
-  get: function () { return chunkZQCPEOB6_cjs.Form; }
-});
-Object.defineProperty(exports, "FormContext", {
-  enumerable: true,
-  get: function () { return chunkZQCPEOB6_cjs.FormContext; }
-});
-Object.defineProperty(exports, "useField", {
-  enumerable: true,
-  get: function () { return chunkZQCPEOB6_cjs.useField; }
-});
-Object.defineProperty(exports, "useForm", {
-  enumerable: true,
-  get: function () { return chunkZQCPEOB6_cjs.useForm; }
-});
+// src/core/useForm.ts
+function useForm(options) {
+  const {
+    initialValues,
+    validationSchema,
+    validateOn = "onBlur",
+    revalidateOn = "onChange",
+    onSubmit,
+    onError,
+    debug = false
+  } = options;
+  const state$ = react.useObservable({
+    values: initialValues,
+    errors: {},
+    touched: {},
+    isSubmitting: false,
+    status: "idle",
+    initialValues: { ...initialValues },
+    // Create a copy to prevent reference sharing
+    hasValidated: {}
+  });
+  const validationInProgress = React2.useRef(/* @__PURE__ */ new Set());
+  const validateField = React2.useCallback(
+    async (field) => {
+      const validators = validationSchema?.[field];
+      if (!validators) return void 0;
+      const fieldKey = String(field);
+      validationInProgress.current.add(fieldKey);
+      try {
+        const value = state$.values[field].get();
+        const allValues = state$.values.get();
+        const validatorArray = Array.isArray(validators) ? validators : [validators];
+        for (const validator of validatorArray) {
+          const error = await validator(value, allValues);
+          if (error) {
+            state$.errors[field].set(error);
+            validationInProgress.current.delete(fieldKey);
+            return error;
+          }
+        }
+        state$.errors[field].set(void 0);
+        validationInProgress.current.delete(fieldKey);
+        return void 0;
+      } catch (error) {
+        validationInProgress.current.delete(fieldKey);
+        const errorMessage = error instanceof Error ? error.message : "Validation error";
+        state$.errors[field].set(errorMessage);
+        return errorMessage;
+      }
+    },
+    [validationSchema, state$]
+  );
+  const validateForm = React2.useCallback(async () => {
+    if (!validationSchema) return {};
+    const fields = Object.keys(validationSchema);
+    const errors2 = {};
+    await Promise.all(
+      fields.map(async (field) => {
+        const error = await validateField(field);
+        if (error) {
+          errors2[field] = error;
+        }
+      })
+    );
+    state$.errors.set(errors2);
+    return errors2;
+  }, [validationSchema, validateField, state$]);
+  const setFieldValue = React2.useCallback(
+    (field, value) => {
+      state$.values[field].set(value);
+      const shouldRevalidate = revalidateOn === "onChange" && state$.hasValidated[String(field)].get();
+      if (shouldRevalidate && validationSchema?.[field]) {
+        validateField(field);
+      }
+      if (debug) {
+        console.log("[useForm] setFieldValue:", { field, value });
+      }
+    },
+    [state$, revalidateOn, validationSchema, validateField, debug]
+  );
+  const setFieldTouched = React2.useCallback(
+    (field, touched2) => {
+      state$.touched[field].set(touched2);
+      if (touched2 && validateOn === "onBlur" && validationSchema?.[field]) {
+        state$.hasValidated[String(field)].set(true);
+        validateField(field);
+      }
+      if (debug) {
+        console.log("[useForm] setFieldTouched:", { field, touched: touched2 });
+      }
+    },
+    [state$, validateOn, validationSchema, validateField, debug]
+  );
+  const resetForm = React2.useCallback(() => {
+    state$.values.set(state$.initialValues.get());
+    state$.errors.set({});
+    state$.touched.set({});
+    state$.isSubmitting.set(false);
+    state$.status.set("idle");
+    state$.hasValidated.set({});
+    if (debug) {
+      console.log("[useForm] Form reset");
+    }
+  }, [state$, debug]);
+  const handleSubmit = React2.useCallback(
+    async (e) => {
+      e?.preventDefault();
+      if (debug) {
+        console.log("[useForm] handleSubmit started");
+      }
+      state$.isSubmitting.set(true);
+      state$.status.set("submitting");
+      try {
+        const errors2 = await validateForm();
+        const hasErrors = Object.keys(errors2).length > 0;
+        if (hasErrors) {
+          state$.status.set("error");
+          onError?.(errors2);
+          if (debug) {
+            console.log("[useForm] Validation errors:", errors2);
+          }
+          return;
+        }
+        const helpers = {
+          setValues: (values2) => {
+            if (typeof values2 === "function") {
+              state$.values.set(values2(state$.values.get()));
+            } else {
+              state$.values.set(values2);
+            }
+          },
+          setFieldValue,
+          setErrors: (errors3) => state$.errors.set(errors3),
+          setFieldError: (field, error) => state$.errors[field].set(error),
+          setTouched: (touched2) => state$.touched.set(touched2),
+          setFieldTouched,
+          setSubmitting: (submitting) => state$.isSubmitting.set(submitting),
+          resetForm
+        };
+        await onSubmit(state$.values.get(), helpers);
+        state$.status.set("success");
+        if (debug) {
+          console.log("[useForm] Submit successful");
+        }
+      } catch (error) {
+        state$.status.set("error");
+        if (debug) {
+          console.error("[useForm] Submit error:", error);
+        }
+        throw error;
+      } finally {
+        state$.isSubmitting.set(false);
+      }
+    },
+    [
+      state$,
+      validateForm,
+      onSubmit,
+      onError,
+      setFieldValue,
+      setFieldTouched,
+      resetForm,
+      debug
+    ]
+  );
+  const getFieldProps = React2.useCallback(
+    (field) => {
+      return {
+        name: String(field),
+        value: state$.values[field].get(),
+        onChange: (value) => setFieldValue(field, value),
+        onBlur: () => setFieldTouched(field, true)
+      };
+    },
+    [state$, setFieldValue, setFieldTouched]
+  );
+  const getFieldMeta = React2.useCallback(
+    (field) => {
+      const fieldKey = String(field);
+      return {
+        error: state$.errors[field].get(),
+        touched: state$.touched[field].get() ?? false,
+        isDirty: state$.values[field].get() !== state$.initialValues[field].get(),
+        isValidating: validationInProgress.current.has(fieldKey)
+      };
+    },
+    [state$]
+  );
+  const values = react.useSelector(() => state$.values.get());
+  const errors = react.useSelector(() => state$.errors.get());
+  const touched = react.useSelector(() => state$.touched.get());
+  const isSubmitting = react.useSelector(() => state$.isSubmitting.get());
+  const status = react.useSelector(() => state$.status.get());
+  const isValid = react.useSelector(() => Object.keys(state$.errors.get()).length === 0);
+  const isDirty = react.useSelector(() => {
+    const currentValues = state$.values.get();
+    const initialValues2 = state$.initialValues.get();
+    return Object.keys(currentValues).some(
+      (key) => currentValues[key] !== initialValues2[key]
+    );
+  });
+  return {
+    // State
+    values,
+    errors,
+    touched,
+    isSubmitting,
+    isValid,
+    isDirty,
+    status,
+    // Actions
+    handleSubmit,
+    setValues: (values2) => {
+      if (typeof values2 === "function") {
+        state$.values.set(values2(state$.values.get()));
+      } else {
+        state$.values.set(values2);
+      }
+    },
+    setFieldValue,
+    setErrors: (errors2) => state$.errors.set(errors2),
+    setFieldError: (field, error) => state$.errors[field].set(error),
+    setTouched: (touched2) => state$.touched.set(touched2),
+    setFieldTouched,
+    validateForm,
+    validateField,
+    resetForm,
+    getFieldProps,
+    getFieldMeta
+  };
+}
+var FormContext = React2.createContext(null);
+FormContext.displayName = "FormContext";
+
+// src/core/useField.ts
+function useField(options) {
+  const { name, validate, transform } = options;
+  const form = React2.useContext(FormContext);
+  if (!form) {
+    throw new Error(
+      "useField must be used within a FormContext. Wrap your component with <Form> or use useForm's getFieldProps instead."
+    );
+  }
+  const baseFieldProps = form.getFieldProps(name);
+  const field = {
+    ...baseFieldProps,
+    value: baseFieldProps.value,
+    onChange: (value) => {
+      const transformedValue = transform ? transform(value) : value;
+      baseFieldProps.onChange(transformedValue);
+      if (validate) {
+        const result = validate(transformedValue, form.values);
+        if (result instanceof Promise) {
+          result.then((error) => {
+            if (error !== void 0) {
+              form.setFieldError(name, error);
+            }
+          });
+        } else if (result !== void 0) {
+          form.setFieldError(name, result);
+        }
+      }
+    }
+  };
+  const meta = form.getFieldMeta(name);
+  const helpers = {
+    setValue: React2.useCallback(
+      (value) => {
+        const transformedValue = transform ? transform(value) : value;
+        form.setFieldValue(name, transformedValue);
+      },
+      [name, transform, form]
+    ),
+    setTouched: React2.useCallback(
+      (touched) => {
+        form.setFieldTouched(name, touched);
+      },
+      [name, form]
+    ),
+    setError: React2.useCallback(
+      (error) => {
+        form.setFieldError(name, error);
+      },
+      [name, form]
+    )
+  };
+  return {
+    field,
+    meta,
+    helpers
+  };
+}
+function Form({
+  form,
+  children,
+  className,
+  action,
+  method = "post",
+  noValidate = true,
+  ...props
+}) {
+  const handleFormSubmit = React2__namespace.useCallback(
+    async (e) => {
+      try {
+        await form.handleSubmit(e);
+      } catch (error) {
+      }
+    },
+    [form]
+  );
+  return /* @__PURE__ */ React2__namespace.createElement(FormContext.Provider, { value: form }, /* @__PURE__ */ React2__namespace.createElement(
+    "form",
+    {
+      onSubmit: handleFormSubmit,
+      action,
+      method,
+      noValidate,
+      className,
+      ...props
+    },
+    children
+  ));
+}
+Form.displayName = "Form";
+function Field({
+  name,
+  label,
+  description,
+  children,
+  showError = true,
+  className,
+  validate
+}) {
+  const fieldState = useField({ name, validate });
+  const { meta } = fieldState;
+  const hasError = meta.touched && meta.error;
+  const errorId = `${name}-error`;
+  const descriptionId = `${name}-description`;
+  return /* @__PURE__ */ React2__namespace.createElement("div", { className, "data-field": name }, label && /* @__PURE__ */ React2__namespace.createElement("label", { htmlFor: name, className: "field-label" }, label), description && /* @__PURE__ */ React2__namespace.createElement("div", { id: descriptionId, className: "field-description" }, description), /* @__PURE__ */ React2__namespace.createElement("div", { className: "field-input" }, typeof children === "function" ? children(fieldState) : children), showError && hasError && /* @__PURE__ */ React2__namespace.createElement(
+    "div",
+    {
+      id: errorId,
+      className: "field-error",
+      role: "alert",
+      "aria-live": "polite"
+    },
+    Array.isArray(meta.error) ? meta.error.join(", ") : meta.error
+  ));
+}
+Field.displayName = "Field";
+
+exports.Field = Field;
+exports.Form = Form;
+exports.FormContext = FormContext;
+exports.useField = useField;
+exports.useForm = useForm;
 //# sourceMappingURL=core.cjs.map
 //# sourceMappingURL=core.cjs.map

package/dist/core.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"core.cjs"}
+{"version":3,"sources":["../src/core/useForm.ts","../src/core/FormContext.tsx","../src/core/useField.ts","../src/core/Form.tsx","../src/core/Field.tsx"],"names":["useObservable","useRef","useCallback","errors","touched","values","useSelector","initialValues","createContext","useContext","React","React2"],"mappings":"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","file":"core.cjs","sourcesContent":["\"use client\";\n\nimport { useCallback, useRef } from \"react\";\nimport { useObservable, useSelector } from \"@legendapp/state/react\";\nimport type {\n  FormValues,\n  FormErrors,\n  TouchedFields,\n  UseFormOptions,\n  UseFormReturn,\n  SubmissionStatus,\n  FieldInputProps,\n  FieldMeta,\n  FormHelpers,\n} from \"./types\";\n\n/**\n * useForm - High-performance form state management with field-level reactivity\n *\n * Built on @legendapp/state for optimal performance:\n * - Field-level reactivity: Only re-render the specific field that changed\n * - Observable-based state: ~1 re-render per change vs ~10 for traditional hooks\n * - Tree-shakable: Only bundle what you use\n *\n * @example\n * ```tsx\n * const form = useForm({\n *   initialValues: { email: '', password: '' },\n *   onSubmit: async (values) => {\n *     await login(values);\n *   },\n *   validationSchema: {\n *     email: (value) => !value ? 'Required' : undefined,\n *     password: (value) => value.length < 8 ? 'Too short' : undefined,\n *   },\n * });\n *\n * return (\n *   <form onSubmit={form.handleSubmit}>\n *     <input {...form.getFieldProps('email')} />\n *     {form.errors.email && <span>{form.errors.email}</span>}\n *   </form>\n * );\n * ```\n *\n * @see https://opensite.ai/developers/page-speed/forms/use-form\n */\nexport function useForm<T extends FormValues = FormValues>(\n  options: UseFormOptions<T>\n): UseFormReturn<T> {\n  const {\n    initialValues,\n    validationSchema,\n    validateOn = \"onBlur\",\n    revalidateOn = \"onChange\",\n    onSubmit,\n    onError,\n    debug = false,\n  } = options;\n\n  // Create observable form state for field-level reactivity\n  // Note: Type assertion needed for @legendapp/state beta compatibility\n  // The beta version's TypeScript types don't properly expose nested Observable properties\n  // This will be removed once stable v3.0.0 is released with proper type definitions\n  const state$ = useObservable({\n    values: initialValues,\n    errors: {} as FormErrors<T>,\n    touched: {} as TouchedFields<T>,\n    isSubmitting: false,\n    status: \"idle\" as SubmissionStatus,\n    initialValues: { ...initialValues }, // Create a copy to prevent reference sharing\n    hasValidated: {} as Record<string, boolean>,\n  }) as any;\n\n  // Track validation in progress to prevent race conditions\n  const validationInProgress = useRef<Set<string>>(new Set());\n\n  /**\n   * Validate a single field\n   */\n  const validateField = useCallback(\n    async <K extends keyof T>(field: K): Promise<string | undefined> => {\n      const validators = validationSchema?.[field];\n      if (!validators) return undefined;\n\n      const fieldKey = String(field);\n      validationInProgress.current.add(fieldKey);\n\n      try {\n        const value = state$.values[field].get();\n        const allValues = state$.values.get();\n\n        const validatorArray = Array.isArray(validators)\n          ? validators\n          : [validators];\n\n        for (const validator of validatorArray) {\n          const error = await validator(value, allValues);\n          if (error) {\n            state$.errors[field].set(error);\n            validationInProgress.current.delete(fieldKey);\n            return error;\n          }\n        }\n\n        // Clear error if validation passed\n        state$.errors[field].set(undefined);\n        validationInProgress.current.delete(fieldKey);\n        return undefined;\n      } catch (error) {\n        validationInProgress.current.delete(fieldKey);\n        const errorMessage =\n          error instanceof Error ? error.message : \"Validation error\";\n        state$.errors[field].set(errorMessage);\n        return errorMessage;\n      }\n    },\n    [validationSchema, state$]\n  );\n\n  /**\n   * Validate entire form\n   */\n  const validateForm = useCallback(async (): Promise<FormErrors<T>> => {\n    if (!validationSchema) return {};\n\n    const fields = Object.keys(validationSchema) as Array<keyof T>;\n    const errors: FormErrors<T> = {};\n\n    await Promise.all(\n      fields.map(async (field) => {\n        const error = await validateField(field);\n        if (error) {\n          errors[field] = error;\n        }\n      })\n    );\n\n    state$.errors.set(errors);\n    return errors;\n  }, [validationSchema, validateField, state$]);\n\n  /**\n   * Set field value with optional validation\n   */\n  const setFieldValue = useCallback(\n    <K extends keyof T>(field: K, value: T[K]) => {\n      state$.values[field].set(value);\n\n      // Revalidate if field has been validated before\n      const shouldRevalidate =\n        revalidateOn === \"onChange\" &&\n        state$.hasValidated[String(field)].get();\n\n      if (shouldRevalidate && validationSchema?.[field]) {\n        validateField(field);\n      }\n\n      if (debug) {\n        console.log(\"[useForm] setFieldValue:\", { field, value });\n      }\n    },\n    [state$, revalidateOn, validationSchema, validateField, debug]\n  );\n\n  /**\n   * Set field as touched with optional validation\n   */\n  const setFieldTouched = useCallback(\n    <K extends keyof T>(field: K, touched: boolean) => {\n      state$.touched[field].set(touched);\n\n      // Validate on blur if configured\n      if (touched && validateOn === \"onBlur\" && validationSchema?.[field]) {\n        state$.hasValidated[String(field)].set(true);\n        validateField(field);\n      }\n\n      if (debug) {\n        console.log(\"[useForm] setFieldTouched:\", { field, touched });\n      }\n    },\n    [state$, validateOn, validationSchema, validateField, debug]\n  );\n\n  /**\n   * Reset form to initial values\n   */\n  const resetForm = useCallback(() => {\n    state$.values.set(state$.initialValues.get());\n    state$.errors.set({});\n    state$.touched.set({});\n    state$.isSubmitting.set(false);\n    state$.status.set(\"idle\");\n    state$.hasValidated.set({});\n\n    if (debug) {\n      console.log(\"[useForm] Form reset\");\n    }\n  }, [state$, debug]);\n\n  /**\n   * Handle form submission\n   */\n  const handleSubmit = useCallback(\n    async (e?: React.FormEvent) => {\n      e?.preventDefault();\n\n      if (debug) {\n        console.log(\"[useForm] handleSubmit started\");\n      }\n\n      state$.isSubmitting.set(true);\n      state$.status.set(\"submitting\");\n\n      try {\n        // Validate form\n        const errors = await validateForm();\n        const hasErrors = Object.keys(errors).length > 0;\n\n        if (hasErrors) {\n          state$.status.set(\"error\");\n          onError?.(errors);\n\n          if (debug) {\n            console.log(\"[useForm] Validation errors:\", errors);\n          }\n\n          return;\n        }\n\n        // Create form helpers\n        const helpers: FormHelpers<T> = {\n          setValues: (values) => {\n            if (typeof values === \"function\") {\n              state$.values.set(values(state$.values.get()));\n            } else {\n              state$.values.set(values);\n            }\n          },\n          setFieldValue,\n          setErrors: (errors) => state$.errors.set(errors),\n          setFieldError: (field, error) => state$.errors[field].set(error),\n          setTouched: (touched) => state$.touched.set(touched),\n          setFieldTouched,\n          setSubmitting: (submitting) => state$.isSubmitting.set(submitting),\n          resetForm,\n        };\n\n        // Call submission handler\n        await onSubmit(state$.values.get(), helpers);\n\n        state$.status.set(\"success\");\n\n        if (debug) {\n          console.log(\"[useForm] Submit successful\");\n        }\n      } catch (error) {\n        state$.status.set(\"error\");\n\n        if (debug) {\n          console.error(\"[useForm] Submit error:\", error);\n        }\n\n        throw error;\n      } finally {\n        state$.isSubmitting.set(false);\n      }\n    },\n    [\n      state$,\n      validateForm,\n      onSubmit,\n      onError,\n      setFieldValue,\n      setFieldTouched,\n      resetForm,\n      debug,\n    ]\n  );\n\n  /**\n   * Get field props for binding to inputs\n   */\n  const getFieldProps = useCallback(\n    <K extends keyof T>(field: K): FieldInputProps<T[K]> => {\n      return {\n        name: String(field),\n        value: state$.values[field].get(),\n        onChange: (value: T[K]) => setFieldValue(field, value),\n        onBlur: () => setFieldTouched(field, true),\n      };\n    },\n    [state$, setFieldValue, setFieldTouched]\n  );\n\n  /**\n   * Get field meta information\n   */\n  const getFieldMeta = useCallback(\n    <K extends keyof T>(field: K): FieldMeta => {\n      const fieldKey = String(field);\n      return {\n        error: state$.errors[field].get(),\n        touched: state$.touched[field].get() ?? false,\n        isDirty:\n          state$.values[field].get() !== state$.initialValues[field].get(),\n        isValidating: validationInProgress.current.has(fieldKey),\n      };\n    },\n    [state$]\n  );\n\n  // Use selectors for reactive properties\n  const values = useSelector(() => state$.values.get());\n  const errors = useSelector(() => state$.errors.get());\n  const touched = useSelector(() => state$.touched.get());\n  const isSubmitting = useSelector(() => state$.isSubmitting.get());\n  const status = useSelector(() => state$.status.get());\n\n  // Use selectors for derived state to ensure reactivity\n  const isValid = useSelector(() => Object.keys(state$.errors.get()).length === 0);\n  const isDirty = useSelector(() => {\n    const currentValues = state$.values.get();\n    const initialValues = state$.initialValues.get();\n    return Object.keys(currentValues).some(\n      (key) => currentValues[key] !== initialValues[key]\n    );\n  });\n\n  return {\n    // State\n    values,\n    errors,\n    touched,\n    isSubmitting,\n    isValid,\n    isDirty,\n    status,\n\n    // Actions\n    handleSubmit,\n    setValues: (values) => {\n      if (typeof values === \"function\") {\n        state$.values.set(values(state$.values.get()));\n      } else {\n        state$.values.set(values);\n      }\n    },\n    setFieldValue,\n    setErrors: (errors) => state$.errors.set(errors),\n    setFieldError: (field, error) => state$.errors[field].set(error),\n    setTouched: (touched) => state$.touched.set(touched),\n    setFieldTouched,\n    validateForm,\n    validateField,\n    resetForm,\n    getFieldProps,\n    getFieldMeta,\n  };\n}\n","\"use client\";\n\nimport { createContext } from \"react\";\nimport type { UseFormReturn } from \"./types\";\n\n/**\n * FormContext - React context for providing form state to child components\n *\n * Allows useField hook to access form state without prop drilling.\n * Automatically provided by the <Form> component.\n *\n * @internal\n */\nexport const FormContext = createContext<UseFormReturn<any> | null>(null);\n\nFormContext.displayName = \"FormContext\";\n","\"use client\";\n\nimport { useCallback, useContext } from \"react\";\nimport { FormContext } from \"./FormContext\";\nimport type { UseFieldOptions, UseFieldReturn, FieldInputProps, FieldMeta } from \"./types\";\n\n/**\n * useField - Field-level reactive hook for form inputs\n *\n * Provides isolated reactivity for individual form fields.\n * Only re-renders when the specific field changes, not when other fields update.\n *\n * Must be used within a FormContext (inside <Form> component).\n *\n * @example\n * ```tsx\n * function EmailInput() {\n *   const { field, meta, helpers } = useField({ name: 'email' });\n *\n *   return (\n *     <div>\n *       <input {...field} type=\"email\" />\n *       {meta.touched && meta.error && <span>{meta.error}</span>}\n *     </div>\n *   );\n * }\n * ```\n *\n * @see https://opensite.ai/developers/page-speed/forms/use-field\n */\nexport function useField<T = any>(\n  options: UseFieldOptions<T>\n): UseFieldReturn<T> {\n  const { name, validate, transform } = options;\n\n  const form = useContext(FormContext);\n\n  if (!form) {\n    throw new Error(\n      \"useField must be used within a FormContext. \" +\n        \"Wrap your component with <Form> or use useForm's getFieldProps instead.\"\n    );\n  }\n\n  // Get field props with automatic change/blur handling\n  const baseFieldProps = form.getFieldProps(name);\n\n  // Apply transform if provided\n  const field: FieldInputProps<T> = {\n    ...baseFieldProps,\n    value: baseFieldProps.value as T,\n    onChange: (value: T) => {\n      const transformedValue = transform ? transform(value) : value;\n      baseFieldProps.onChange(transformedValue);\n\n      // Run field-level validation if provided\n      if (validate) {\n        const result = validate(transformedValue, form.values);\n        if (result instanceof Promise) {\n          result.then((error) => {\n            if (error !== undefined) {\n              form.setFieldError(name, error);\n            }\n          });\n        } else if (result !== undefined) {\n          form.setFieldError(name, result);\n        }\n      }\n    },\n  };\n\n  // Get field meta information\n  const meta: FieldMeta = form.getFieldMeta(name);\n\n  // Field helpers\n  const helpers = {\n    setValue: useCallback(\n      (value: T) => {\n        const transformedValue = transform ? transform(value) : value;\n        form.setFieldValue(name, transformedValue);\n      },\n      [name, transform, form]\n    ),\n    setTouched: useCallback(\n      (touched: boolean) => {\n        form.setFieldTouched(name, touched);\n      },\n      [name, form]\n    ),\n    setError: useCallback(\n      (error: string | undefined) => {\n        form.setFieldError(name, error);\n      },\n      [name, form]\n    ),\n  };\n\n  return {\n    field,\n    meta,\n    helpers,\n  };\n}\n","\"use client\";\n\nimport * as React from \"react\";\nimport { FormContext } from \"./FormContext\";\nimport type { FormProps, FormValues } from \"./types\";\n\n/**\n * Form - Progressive enhancement form component\n *\n * Provides form context to child components and handles form submission.\n * Supports progressive enhancement with server-side fallback.\n *\n * Features:\n * - Provides FormContext for useField hook\n * - Handles form submission with validation\n * - Progressive enhancement support (works without JavaScript)\n * - Accessible form semantics\n *\n * @example\n * ```tsx\n * const form = useForm({\n *   initialValues: { email: '' },\n *   onSubmit: async (values) => {\n *     await submitForm(values);\n *   },\n * });\n *\n * return (\n *   <Form form={form} action=\"/api/submit\" method=\"post\">\n *     <input {...form.getFieldProps('email')} />\n *     <button type=\"submit\">Submit</button>\n *   </Form>\n * );\n * ```\n *\n * @see https://opensite.ai/developers/page-speed/forms/form\n */\nexport function Form<T extends FormValues = FormValues>({\n  form,\n  children,\n  className,\n  action,\n  method = \"post\",\n  noValidate = true,\n  ...props\n}: FormProps<T> & React.FormHTMLAttributes<HTMLFormElement>) {\n  // Wrap handleSubmit to catch any unhandled rejections\n  const handleFormSubmit = React.useCallback(\n    async (e: React.FormEvent) => {\n      try {\n        await form.handleSubmit(e);\n      } catch (error) {\n        // Error is already handled by useForm, just prevent unhandled rejection\n        // The form status and errors are already set by useForm's error handling\n      }\n    },\n    [form]\n  );\n\n  return (\n    <FormContext.Provider value={form}>\n      <form\n        onSubmit={handleFormSubmit}\n        action={action}\n        method={method}\n        noValidate={noValidate}\n        className={className}\n        {...props}\n      >\n        {children}\n      </form>\n    </FormContext.Provider>\n  );\n}\n\nForm.displayName = \"Form\";\n","\"use client\";\n\nimport * as React from \"react\";\nimport { useField } from \"./useField\";\nimport type { FieldProps } from \"./types\";\n\n/**\n * Field - Field wrapper component with label, description, and error display\n *\n * Provides a complete field UI with automatic error handling and accessibility.\n * Uses useField hook internally for field-level reactivity.\n *\n * Features:\n * - Automatic label association\n * - Error display with accessibility\n * - Optional description text\n * - Render prop pattern for flexibility\n * - Full accessibility support\n *\n * @example\n * ```tsx\n * <Field name=\"email\" label=\"Email Address\" description=\"We'll never share your email\">\n *   {({ field, meta }) => (\n *     <input\n *       {...field}\n *       type=\"email\"\n *       className={meta.error && meta.touched ? 'error' : ''}\n *     />\n *   )}\n * </Field>\n * ```\n *\n * @see https://opensite.ai/developers/page-speed/forms/field\n */\nexport function Field({\n  name,\n  label,\n  description,\n  children,\n  showError = true,\n  className,\n  validate,\n}: FieldProps) {\n  const fieldState = useField({ name, validate });\n  const { meta } = fieldState;\n\n  const hasError = meta.touched && meta.error;\n  const errorId = `${name}-error`;\n  const descriptionId = `${name}-description`;\n\n  return (\n    <div className={className} data-field={name}>\n      {/* Label */}\n      {label && (\n        <label htmlFor={name} className=\"field-label\">\n          {label}\n        </label>\n      )}\n\n      {/* Description */}\n      {description && (\n        <div id={descriptionId} className=\"field-description\">\n          {description}\n        </div>\n      )}\n\n      {/* Field content (render prop or direct children) */}\n      <div className=\"field-input\">\n        {typeof children === \"function\" ? children(fieldState) : children}\n      </div>\n\n      {/* Error message */}\n      {showError && hasError && (\n        <div\n          id={errorId}\n          className=\"field-error\"\n          role=\"alert\"\n          aria-live=\"polite\"\n        >\n          {Array.isArray(meta.error) ? meta.error.join(\", \") : meta.error}\n        </div>\n      )}\n    </div>\n  );\n}\n\nField.displayName = \"Field\";\n"]}