@formos/react 0.1.0

package/dist/index.js

@@ -0,0 +1,396 @@
+// src/FormProvider.tsx
+import { useState, useMemo, useCallback, useEffect } from "react";
+import { createFormEngine } from "@formos/kernel";
+
+// src/FormContext.tsx
+import { createContext } from "react";
+var FormContext = createContext(null);
+FormContext.displayName = "FormContext";
+
+// src/FormProvider.tsx
+import { jsx } from "react/jsx-runtime";
+function FormProvider({
+  schema,
+  initialValues,
+  children,
+  ...engineOptions
+}) {
+  const [version, setVersion] = useState(0);
+  const [isSubmitting, setIsSubmitting] = useState(false);
+  const engine = useMemo(() => {
+    const { onSubmit, ...otherOptions } = engineOptions;
+    const wrappedOnSubmit = onSubmit ? async (values) => {
+      setIsSubmitting(true);
+      try {
+        await onSubmit(values);
+      } finally {
+        setIsSubmitting(false);
+      }
+    } : void 0;
+    return createFormEngine(schema, {
+      ...otherOptions,
+      onSubmit: wrappedOnSubmit
+    });
+  }, [schema, engineOptions]);
+  useEffect(() => {
+    if (initialValues) {
+      Object.entries(initialValues).forEach(([fieldName, value]) => {
+        engine.setValue(fieldName, value, { silent: true });
+      });
+    }
+  }, []);
+  const notifyUpdate = useCallback(() => {
+    setVersion((v) => v + 1);
+  }, []);
+  const contextValue = useMemo(
+    () => ({
+      engine,
+      schema,
+      version,
+      notifyUpdate,
+      isSubmitting
+    }),
+    [engine, schema, version, notifyUpdate, isSubmitting]
+  );
+  return /* @__PURE__ */ jsx(FormContext.Provider, { value: contextValue, children });
+}
+
+// src/useForm.ts
+import { useCallback as useCallback2, useContext } from "react";
+function useForm() {
+  const context = useContext(FormContext);
+  if (!context) {
+    throw new Error("useForm must be used within a FormProvider");
+  }
+  const { engine, schema, notifyUpdate } = context;
+  const submit = useCallback2(async () => {
+    const success = await engine.submit();
+    notifyUpdate();
+    return success;
+  }, [engine, notifyUpdate]);
+  const reset = useCallback2(() => {
+    engine.reset();
+    notifyUpdate();
+  }, [engine, notifyUpdate]);
+  const validate = useCallback2(
+    async (trigger) => {
+      const isValid2 = await engine.validate(void 0, trigger);
+      notifyUpdate();
+      return isValid2;
+    },
+    [engine, notifyUpdate]
+  );
+  const getValues = useCallback2(() => {
+    const values = {};
+    schema.fields.forEach((field) => {
+      if (field?.name) {
+        values[field.name] = engine.getValue(field.name);
+      }
+    });
+    return values;
+  }, [engine, schema]);
+  const getValue = useCallback2(
+    (fieldName) => {
+      return engine.getValue(fieldName);
+    },
+    [engine]
+  );
+  const setValue = useCallback2(
+    async (fieldName, value) => {
+      await engine.setValue(fieldName, value);
+      notifyUpdate();
+    },
+    [engine, notifyUpdate]
+  );
+  const getErrors = useCallback2(() => {
+    return engine.getErrors();
+  }, [engine]);
+  const getError = useCallback2(
+    (fieldName) => {
+      return engine.getError(fieldName);
+    },
+    [engine]
+  );
+  const setError = useCallback2(
+    (fieldName, error) => {
+      engine.setError(fieldName, error);
+      notifyUpdate();
+    },
+    [engine, notifyUpdate]
+  );
+  const clearError = useCallback2(
+    (fieldName) => {
+      engine.clearError(fieldName);
+      notifyUpdate();
+    },
+    [engine, notifyUpdate]
+  );
+  const isValid = useCallback2(() => {
+    return engine.isValid();
+  }, [engine]);
+  const isDirty = useCallback2(
+    (fieldName) => {
+      return engine.isDirty(fieldName);
+    },
+    [engine]
+  );
+  const isTouched = useCallback2(
+    (fieldName) => {
+      return engine.isTouched(fieldName);
+    },
+    [engine]
+  );
+  const markTouched = useCallback2(
+    (fieldName) => {
+      engine.markTouched(fieldName);
+      notifyUpdate();
+    },
+    [engine, notifyUpdate]
+  );
+  const getCurrentStep = useCallback2(() => {
+    return engine.getCurrentStep?.();
+  }, [engine]);
+  const getTotalSteps = useCallback2(() => {
+    return engine.getTotalSteps?.();
+  }, [engine]);
+  const nextStep = engine.nextStep ? useCallback2(async () => {
+    const moved = await engine.nextStep();
+    notifyUpdate();
+    return moved;
+  }, [engine, notifyUpdate]) : void 0;
+  const prevStep = engine.prevStep ? useCallback2(() => {
+    engine.prevStep();
+    notifyUpdate();
+  }, [engine, notifyUpdate]) : void 0;
+  const goToStep = engine.goToStep ? useCallback2(
+    async (stepIndex) => {
+      const moved = await engine.goToStep(stepIndex);
+      notifyUpdate();
+      return moved;
+    },
+    [engine, notifyUpdate]
+  ) : void 0;
+  const canGoToStep = engine.canGoToStep ? useCallback2(
+    (stepIndex) => {
+      return engine.canGoToStep(stepIndex);
+    },
+    [engine]
+  ) : void 0;
+  return {
+    // Form actions
+    submit,
+    reset,
+    // Validation
+    validate,
+    // Value access
+    getValues,
+    getValue,
+    setValue,
+    // Error access
+    getErrors,
+    getError,
+    setError,
+    clearError,
+    // State checks
+    isValid,
+    isDirty,
+    isTouched,
+    // Field actions
+    markTouched,
+    // Multi-step navigation
+    getCurrentStep,
+    getTotalSteps,
+    nextStep,
+    prevStep,
+    goToStep,
+    canGoToStep,
+    // Advanced (escape hatches)
+    engine,
+    schema
+  };
+}
+
+// src/useField.ts
+import { useContext as useContext2, useState as useState2, useCallback as useCallback3, useEffect as useEffect2 } from "react";
+function useField(fieldName, options = {}) {
+  const context = useContext2(FormContext);
+  if (!context) {
+    throw new Error("useField must be used within a FormProvider");
+  }
+  const { engine, version, notifyUpdate } = context;
+  const { validateOnChange = true, validateOnBlur = true } = options;
+  const [fieldState, setFieldState] = useState2(() => ({
+    value: engine.getValue(fieldName),
+    error: engine.getError(fieldName),
+    touched: engine.isTouched(fieldName),
+    dirty: engine.isDirty(fieldName)
+  }));
+  useEffect2(() => {
+    setFieldState({
+      value: engine.getValue(fieldName),
+      error: engine.getError(fieldName),
+      touched: engine.isTouched(fieldName),
+      dirty: engine.isDirty(fieldName)
+    });
+  }, [engine, fieldName, version]);
+  const setValue = useCallback3(
+    async (value) => {
+      await engine.setValue(fieldName, value, {
+        trigger: validateOnChange ? "onChange" : "manual"
+      });
+      notifyUpdate();
+    },
+    [engine, fieldName, validateOnChange, notifyUpdate]
+  );
+  const setError = useCallback3(
+    (error) => {
+      engine.setError(fieldName, error);
+      notifyUpdate();
+    },
+    [engine, fieldName, notifyUpdate]
+  );
+  const clearError = useCallback3(() => {
+    engine.clearError(fieldName);
+    notifyUpdate();
+  }, [engine, fieldName, notifyUpdate]);
+  const markTouched = useCallback3(async () => {
+    engine.markTouched(fieldName);
+    if (validateOnBlur) {
+      await engine.validate(fieldName, "onBlur");
+    }
+    notifyUpdate();
+  }, [engine, fieldName, validateOnBlur, notifyUpdate]);
+  const validate = useCallback3(async () => {
+    const isValid = await engine.validate(fieldName, "manual");
+    notifyUpdate();
+    return isValid;
+  }, [engine, fieldName, notifyUpdate]);
+  return {
+    value: fieldState.value,
+    error: fieldState.error,
+    touched: fieldState.touched,
+    dirty: fieldState.dirty,
+    setValue,
+    setError,
+    clearError,
+    markTouched,
+    validate
+  };
+}
+
+// src/useFormState.ts
+import { useContext as useContext3, useState as useState3, useEffect as useEffect3 } from "react";
+function useFormState() {
+  const context = useContext3(FormContext);
+  if (!context) {
+    throw new Error("useFormState must be used within a FormProvider");
+  }
+  const { engine, schema, version, isSubmitting } = context;
+  const [formState, setFormState] = useState3(() => {
+    const values = {};
+    schema.fields.forEach((field) => {
+      if (field?.name) {
+        values[field.name] = engine.getValue(field.name);
+      }
+    });
+    return {
+      values,
+      errors: engine.getErrors(),
+      isValid: engine.isValid(),
+      isDirty: engine.isDirty(),
+      isSubmitting
+    };
+  });
+  useEffect3(() => {
+    const values = {};
+    schema.fields.forEach((field) => {
+      if (field?.name) {
+        values[field.name] = engine.getValue(field.name);
+      }
+    });
+    setFormState({
+      values,
+      errors: engine.getErrors(),
+      isValid: engine.isValid(),
+      isDirty: engine.isDirty(),
+      isSubmitting
+    });
+  }, [engine, schema, version, isSubmitting]);
+  return formState;
+}
+
+// src/useStep.ts
+import { useContext as useContext4, useState as useState4, useCallback as useCallback4, useEffect as useEffect4 } from "react";
+function useStep() {
+  const context = useContext4(FormContext);
+  if (!context) {
+    throw new Error("useStep must be used within a FormProvider");
+  }
+  const { engine, version, notifyUpdate, schema } = context;
+  if (!schema.steps || schema.steps.length === 0) {
+    throw new Error(
+      "useStep can only be used with multi-step forms. Schema must have steps defined."
+    );
+  }
+  const [stepState, setStepState] = useState4(() => ({
+    currentStep: engine.getCurrentStep?.() ?? 0,
+    totalSteps: engine.getTotalSteps?.() ?? 1
+  }));
+  useEffect4(() => {
+    setStepState({
+      currentStep: engine.getCurrentStep?.() ?? 0,
+      totalSteps: engine.getTotalSteps?.() ?? 1
+    });
+  }, [engine, version]);
+  const nextStep = useCallback4(async () => {
+    if (!engine.nextStep) {
+      throw new Error("nextStep is not available on this engine");
+    }
+    const moved = await engine.nextStep();
+    notifyUpdate();
+    return moved;
+  }, [engine, notifyUpdate]);
+  const prevStep = useCallback4(() => {
+    if (!engine.prevStep) {
+      throw new Error("prevStep is not available on this engine");
+    }
+    engine.prevStep();
+    notifyUpdate();
+  }, [engine, notifyUpdate]);
+  const goToStep = useCallback4(
+    async (stepIndex) => {
+      if (!engine.goToStep) {
+        throw new Error("goToStep is not available on this engine");
+      }
+      const moved = await engine.goToStep(stepIndex);
+      notifyUpdate();
+      return moved;
+    },
+    [engine, notifyUpdate]
+  );
+  const canGoToStep = useCallback4(
+    (stepIndex) => {
+      if (!engine.canGoToStep) {
+        return false;
+      }
+      return engine.canGoToStep(stepIndex);
+    },
+    [engine]
+  );
+  return {
+    currentStep: stepState.currentStep,
+    totalSteps: stepState.totalSteps,
+    nextStep,
+    prevStep,
+    goToStep,
+    canGoToStep
+  };
+}
+export {
+  FormProvider,
+  useField,
+  useForm,
+  useFormState,
+  useStep
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/FormProvider.tsx","../src/FormContext.tsx","../src/useForm.ts","../src/useField.ts","../src/useFormState.ts","../src/useStep.ts"],"sourcesContent":["/**\r\n * FormProvider component\r\n * Wraps the application and provides form engine to child components\r\n */\r\n\r\nimport { useState, useMemo, useCallback, useEffect } from \"react\";\r\nimport { createFormEngine } from \"@formos/kernel\";\r\nimport { FormContext } from \"./FormContext.js\";\r\nimport type { FormProviderProps } from \"./types.js\";\r\n\r\n/**\r\n * Form provider component that creates and manages a form engine instance.\r\n *\r\n * Wrap your form components with this provider to enable form hooks.\r\n * The provider creates a single form engine instance and makes it available\r\n * via React context.\r\n *\r\n * @public\r\n * @stable\r\n *\r\n * @example\r\n * ```tsx\r\n * import { FormProvider } from '@formos/react';\r\n * import { normalizeSchema } from '@formos/schema';\r\n *\r\n * const schema = { version: 'v1', fields: [...] };\r\n * const normalized = normalizeSchema(schema);\r\n *\r\n * function App() {\r\n *   return (\r\n *     <FormProvider\r\n *       schema={normalized}\r\n *       validators={{\r\n *         required: (value) => value ? null : 'Required'\r\n *       }}\r\n *       onSubmit={async (values) => {\r\n *         await api.post('/submit', values);\r\n *       }}\r\n *     >\r\n *       <MyForm />\r\n *     </FormProvider>\r\n *   );\r\n * }\r\n * ```\r\n */\r\nexport function FormProvider({\r\n  schema,\r\n  initialValues,\r\n  children,\r\n  ...engineOptions\r\n}: FormProviderProps) {\r\n  // Version counter for forcing re-renders on subscriptions\r\n  const [version, setVersion] = useState(0);\r\n  const [isSubmitting, setIsSubmitting] = useState(false);\r\n\r\n  // Create form engine instance (memoized)\r\n  const engine = useMemo(() => {\r\n    const { onSubmit, ...otherOptions } = engineOptions;\r\n\r\n    // Wrap onSubmit to track submitting state\r\n    const wrappedOnSubmit = onSubmit\r\n      ? async (values: Record<string, unknown>) => {\r\n          setIsSubmitting(true);\r\n          try {\r\n            await onSubmit(values);\r\n          } finally {\r\n            setIsSubmitting(false);\r\n          }\r\n        }\r\n      : undefined;\r\n\r\n    return createFormEngine(schema, {\r\n      ...otherOptions,\r\n      onSubmit: wrappedOnSubmit,\r\n    });\r\n  }, [schema, engineOptions]);\r\n\r\n  // Set initial values on mount\r\n  useEffect(() => {\r\n    if (initialValues) {\r\n      Object.entries(initialValues).forEach(([fieldName, value]) => {\r\n        // Use silent to avoid triggering validation/effects on initial load\r\n        engine.setValue(fieldName, value, { silent: true });\r\n      });\r\n    }\r\n  }, []); // Only run on mount\r\n\r\n  // Callback to notify subscribers of updates\r\n  const notifyUpdate = useCallback(() => {\r\n    setVersion((v) => v + 1);\r\n  }, []);\r\n\r\n  // Context value (memoized)\r\n  const contextValue = useMemo(\r\n    () => ({\r\n      engine,\r\n      schema,\r\n      version,\r\n      notifyUpdate,\r\n      isSubmitting,\r\n    }),\r\n    [engine, schema, version, notifyUpdate, isSubmitting],\r\n  );\r\n\r\n  return (\r\n    <FormContext.Provider value={contextValue}>{children}</FormContext.Provider>\r\n  );\r\n}\r\n","/**\r\n * Form context for React integration\r\n * Provides FormEngine instance to child components\r\n */\r\n\r\nimport { createContext } from \"react\";\r\nimport type { FormContextValue } from \"./types.js\";\r\n\r\n/**\r\n * React context for form engine instance.\r\n *\r\n * @internal\r\n */\r\nexport const FormContext = createContext<FormContextValue | null>(null);\r\n\r\nFormContext.displayName = \"FormContext\";\r\n","/**\r\n * useForm hook - primary hook for form-level operations\r\n */\r\n\r\nimport { useCallback, useContext } from \"react\";\r\nimport type { UseFormResult } from \"./types.js\";\r\nimport { FormContext } from \"./FormContext.js\";\r\n\r\n/**\r\n * Primary hook for form-level operations.\r\n *\r\n * Provides access to form engine and form-level actions like submit,\r\n * reset, validation, and multi-step navigation. Wraps @formos/kernel\r\n * with React-idiomatic API.\r\n *\r\n * @returns Form operations and state access methods\r\n * @throws {Error} If used outside FormProvider\r\n *\r\n * @public\r\n * @stable\r\n *\r\n * @example\r\n * Single-step form:\r\n * ```tsx\r\n * function LoginForm() {\r\n *   const { submit, reset, isValid, isDirty } = useForm();\r\n *\r\n *   const handleSubmit = async (e: React.FormEvent) => {\r\n *     e.preventDefault();\r\n *     const success = await submit();\r\n *     if (success) {\r\n *       console.log('Login successful');\r\n *     }\r\n *   };\r\n *\r\n *   return (\r\n *     <form onSubmit={handleSubmit}>\r\n *       <EmailField />\r\n *       <PasswordField />\r\n *       <button type=\"submit\" disabled={!isValid()}>\r\n *         Submit\r\n *       </button>\r\n *       <button type=\"button\" onClick={reset} disabled={!isDirty()}>\r\n *         Reset\r\n *       </button>\r\n *     </form>\r\n *   );\r\n * }\r\n * ```\r\n *\r\n * @example\r\n * Multi-step form:\r\n * ```tsx\r\n * function SignupWizard() {\r\n *   const {\r\n *     submit,\r\n *     getCurrentStep,\r\n *     getTotalSteps,\r\n *     nextStep,\r\n *     prevStep,\r\n *     isValid\r\n *   } = useForm();\r\n *\r\n *   const currentStep = getCurrentStep() ?? 0;\r\n *   const totalSteps = getTotalSteps() ?? 1;\r\n *\r\n *   const handleNext = async () => {\r\n *     const moved = await nextStep?.();\r\n *     if (!moved) {\r\n *       alert('Fix errors before proceeding');\r\n *     }\r\n *   };\r\n *\r\n *   return (\r\n *     <div>\r\n *       <div>Step {currentStep + 1} of {totalSteps}</div>\r\n *       <button onClick={prevStep} disabled={currentStep === 0}>\r\n *         Previous\r\n *       </button>\r\n *       <button onClick={handleNext}>\r\n *         {currentStep === totalSteps - 1 ? 'Submit' : 'Next'}\r\n *       </button>\r\n *     </div>\r\n *   );\r\n * }\r\n * ```\r\n */\r\nexport function useForm(): UseFormResult {\r\n  const context = useContext(FormContext);\r\n\r\n  if (!context) {\r\n    throw new Error(\"useForm must be used within a FormProvider\");\r\n  }\r\n\r\n  const { engine, schema, notifyUpdate } = context;\r\n\r\n  // =========================================================================\r\n  // FORM ACTIONS\r\n  // =========================================================================\r\n\r\n  /**\r\n   * Submit form: validates all fields and calls onSubmit handler if valid.\r\n   * Returns true if submission succeeded, false if validation failed.\r\n   */\r\n  const submit = useCallback(async (): Promise<boolean> => {\r\n    const success = await engine.submit();\r\n    notifyUpdate(); // Notify subscribers of potential state changes\r\n    return success;\r\n  }, [engine, notifyUpdate]);\r\n\r\n  /**\r\n   * Reset form to initial state (values, errors, touched, dirty).\r\n   */\r\n  const reset = useCallback((): void => {\r\n    engine.reset();\r\n    notifyUpdate(); // Notify subscribers of state reset\r\n  }, [engine, notifyUpdate]);\r\n\r\n  // =========================================================================\r\n  // VALIDATION\r\n  // =========================================================================\r\n\r\n  /**\r\n   * Validate entire form with optional trigger.\r\n   * Useful for manual validation before navigation or submission.\r\n   */\r\n  const validate = useCallback(\r\n    async (\r\n      trigger?: \"onChange\" | \"onBlur\" | \"onSubmit\" | \"manual\",\r\n    ): Promise<boolean> => {\r\n      const isValid = await engine.validate(undefined, trigger);\r\n      notifyUpdate(); // Notify subscribers of validation changes\r\n      return isValid;\r\n    },\r\n    [engine, notifyUpdate],\r\n  );\r\n\r\n  // =========================================================================\r\n  // VALUE ACCESS\r\n  // =========================================================================\r\n\r\n  /**\r\n   * Get all form values as object.\r\n   * Useful for debugging or passing to external functions.\r\n   */\r\n  const getValues = useCallback((): Record<string, unknown> => {\r\n    const values: Record<string, unknown> = {};\r\n    schema.fields.forEach((field) => {\r\n      if (field?.name) {\r\n        values[field.name] = engine.getValue(field.name);\r\n      }\r\n    });\r\n    return values;\r\n  }, [engine, schema]);\r\n\r\n  /**\r\n   * Get single field value.\r\n   * Useful for conditional logic based on other field values.\r\n   */\r\n  const getValue = useCallback(\r\n    (fieldName: string): unknown => {\r\n      return engine.getValue(fieldName);\r\n    },\r\n    [engine],\r\n  );\r\n\r\n  /**\r\n   * Set field value programmatically.\r\n   * Triggers validation and effects according to field configuration.\r\n   */\r\n  const setValue = useCallback(\r\n    async (fieldName: string, value: unknown): Promise<void> => {\r\n      await engine.setValue(fieldName, value);\r\n      notifyUpdate();\r\n    },\r\n    [engine, notifyUpdate],\r\n  );\r\n\r\n  // =========================================================================\r\n  // ERROR ACCESS\r\n  // =========================================================================\r\n\r\n  /**\r\n   * Get all field errors.\r\n   * Useful for error summaries or checking total error count.\r\n   */\r\n  const getErrors = useCallback((): Record<string, string | undefined> => {\r\n    return engine.getErrors();\r\n  }, [engine]);\r\n\r\n  /**\r\n   * Get single field error.\r\n   * Useful for displaying errors outside field components.\r\n   */\r\n  const getError = useCallback(\r\n    (fieldName: string): string | undefined => {\r\n      return engine.getError(fieldName);\r\n    },\r\n    [engine],\r\n  );\r\n\r\n  /**\r\n   * Set field error manually (e.g., from server validation).\r\n   */\r\n  const setError = useCallback(\r\n    (fieldName: string, error: string): void => {\r\n      engine.setError(fieldName, error);\r\n      notifyUpdate();\r\n    },\r\n    [engine, notifyUpdate],\r\n  );\r\n\r\n  /**\r\n   * Clear field error.\r\n   */\r\n  const clearError = useCallback(\r\n    (fieldName: string): void => {\r\n      engine.clearError(fieldName);\r\n      notifyUpdate();\r\n    },\r\n    [engine, notifyUpdate],\r\n  );\r\n\r\n  // =========================================================================\r\n  // STATE CHECKS\r\n  // =========================================================================\r\n\r\n  /**\r\n   * Check if form is valid (has no errors).\r\n   * Use for enabling/disabling submit buttons.\r\n   */\r\n  const isValid = useCallback((): boolean => {\r\n    return engine.isValid();\r\n  }, [engine]);\r\n\r\n  /**\r\n   * Check if form or specific field is dirty (changed from initial value).\r\n   * Without parameter: checks if ANY field is dirty.\r\n   * With parameter: checks if SPECIFIC field is dirty.\r\n   */\r\n  const isDirty = useCallback(\r\n    (fieldName?: string): boolean => {\r\n      return engine.isDirty(fieldName);\r\n    },\r\n    [engine],\r\n  );\r\n\r\n  /**\r\n   * Check if field has been touched (user interacted with it).\r\n   * Useful for showing errors only after user interaction.\r\n   */\r\n  const isTouched = useCallback(\r\n    (fieldName: string): boolean => {\r\n      return engine.isTouched(fieldName);\r\n    },\r\n    [engine],\r\n  );\r\n\r\n  // =========================================================================\r\n  // FIELD ACTIONS\r\n  // =========================================================================\r\n\r\n  /**\r\n   * Mark field as touched programmatically.\r\n   */\r\n  const markTouched = useCallback(\r\n    (fieldName: string): void => {\r\n      engine.markTouched(fieldName);\r\n      notifyUpdate();\r\n    },\r\n    [engine, notifyUpdate],\r\n  );\r\n\r\n  // =========================================================================\r\n  // MULTI-STEP NAVIGATION\r\n  // =========================================================================\r\n\r\n  /**\r\n   * Get current step index (0-based).\r\n   * Returns undefined for single-step forms.\r\n   */\r\n  const getCurrentStep = useCallback((): number | undefined => {\r\n    return engine.getCurrentStep?.();\r\n  }, [engine]);\r\n\r\n  /**\r\n   * Get total number of steps.\r\n   * Returns undefined for single-step forms.\r\n   */\r\n  const getTotalSteps = useCallback((): number | undefined => {\r\n    return engine.getTotalSteps?.();\r\n  }, [engine]);\r\n\r\n  /**\r\n   * Go to next step (validates current step first).\r\n   * Returns true if moved, false if validation failed.\r\n   * Undefined for single-step forms.\r\n   */\r\n  const nextStep = engine.nextStep\r\n    ? useCallback(async (): Promise<boolean> => {\r\n        const moved = await engine.nextStep!();\r\n        notifyUpdate();\r\n        return moved;\r\n      }, [engine, notifyUpdate])\r\n    : undefined;\r\n\r\n  /**\r\n   * Go to previous step (no validation).\r\n   * Undefined for single-step forms.\r\n   */\r\n  const prevStep = engine.prevStep\r\n    ? useCallback((): void => {\r\n        engine.prevStep!();\r\n        notifyUpdate();\r\n      }, [engine, notifyUpdate])\r\n    : undefined;\r\n\r\n  /**\r\n   * Jump to specific step (validates if moving forward).\r\n   * Returns true if moved, false if validation failed.\r\n   * Undefined for single-step forms.\r\n   */\r\n  const goToStep = engine.goToStep\r\n    ? useCallback(\r\n        async (stepIndex: number): Promise<boolean> => {\r\n          const moved = await engine.goToStep!(stepIndex);\r\n          notifyUpdate();\r\n          return moved;\r\n        },\r\n        [engine, notifyUpdate],\r\n      )\r\n    : undefined;\r\n\r\n  /**\r\n   * Check if can navigate to step.\r\n   * Undefined for single-step forms.\r\n   */\r\n  const canGoToStep = engine.canGoToStep\r\n    ? useCallback(\r\n        (stepIndex: number): boolean => {\r\n          return engine.canGoToStep!(stepIndex);\r\n        },\r\n        [engine],\r\n      )\r\n    : undefined;\r\n\r\n  // =========================================================================\r\n  // RETURN OBJECT\r\n  // =========================================================================\r\n\r\n  return {\r\n    // Form actions\r\n    submit,\r\n    reset,\r\n\r\n    // Validation\r\n    validate,\r\n\r\n    // Value access\r\n    getValues,\r\n    getValue,\r\n    setValue,\r\n\r\n    // Error access\r\n    getErrors,\r\n    getError,\r\n    setError,\r\n    clearError,\r\n\r\n    // State checks\r\n    isValid,\r\n    isDirty,\r\n    isTouched,\r\n\r\n    // Field actions\r\n    markTouched,\r\n\r\n    // Multi-step navigation\r\n    getCurrentStep,\r\n    getTotalSteps,\r\n    nextStep,\r\n    prevStep,\r\n    goToStep,\r\n    canGoToStep,\r\n\r\n    // Advanced (escape hatches)\r\n    engine,\r\n    schema,\r\n  };\r\n}\r\n","/**\r\n * useField hook - field-level operations and state\r\n */\r\n\r\nimport { useContext, useState, useCallback, useEffect } from \"react\";\r\nimport { FormContext } from \"./FormContext.js\";\r\nimport type { UseFieldOptions, UseFieldResult } from \"./types.js\";\r\n\r\n/**\r\n * Hook for field-level operations and state management.\r\n *\r\n * Provides field value, error, touched/dirty state, and actions.\r\n * Automatically subscribes to field changes for reactive updates.\r\n *\r\n * @param fieldName - Name of the field to manage\r\n * @param options - Optional configuration for validation triggers\r\n * @returns Field state and actions\r\n * @throws {Error} If used outside FormProvider\r\n *\r\n * @public\r\n * @stable\r\n *\r\n * @example\r\n * ```tsx\r\n * function EmailField() {\r\n *   const {\r\n *     value,\r\n *     error,\r\n *     touched,\r\n *     setValue,\r\n *     markTouched\r\n *   } = useField('email', {\r\n *     validateOnChange: true,\r\n *     validateOnBlur: true\r\n *   });\r\n *\r\n *   return (\r\n *     <div>\r\n *       <input\r\n *         type=\"email\"\r\n *         value={String(value || '')}\r\n *         onChange={(e) => setValue(e.target.value)}\r\n *         onBlur={() => markTouched()}\r\n *       />\r\n *       {touched && error && <span>{error}</span>}\r\n *     </div>\r\n *   );\r\n * }\r\n * ```\r\n */\r\nexport function useField(\r\n  fieldName: string,\r\n  options: UseFieldOptions = {},\r\n): UseFieldResult {\r\n  const context = useContext(FormContext);\r\n\r\n  if (!context) {\r\n    throw new Error(\"useField must be used within a FormProvider\");\r\n  }\r\n\r\n  const { engine, version, notifyUpdate } = context;\r\n  const { validateOnChange = true, validateOnBlur = true } = options;\r\n\r\n  // Local state to track field state (subscribed to context version)\r\n  const [fieldState, setFieldState] = useState(() => ({\r\n    value: engine.getValue(fieldName),\r\n    error: engine.getError(fieldName),\r\n    touched: engine.isTouched(fieldName),\r\n    dirty: engine.isDirty(fieldName),\r\n  }));\r\n\r\n  // Update local state when context version changes\r\n  useEffect(() => {\r\n    setFieldState({\r\n      value: engine.getValue(fieldName),\r\n      error: engine.getError(fieldName),\r\n      touched: engine.isTouched(fieldName),\r\n      dirty: engine.isDirty(fieldName),\r\n    });\r\n  }, [engine, fieldName, version]);\r\n\r\n  // Set field value\r\n  const setValue = useCallback(\r\n    async (value: unknown) => {\r\n      await engine.setValue(fieldName, value, {\r\n        trigger: validateOnChange ? \"onChange\" : \"manual\",\r\n      });\r\n      notifyUpdate(); // Notify context of change\r\n    },\r\n    [engine, fieldName, validateOnChange, notifyUpdate],\r\n  );\r\n\r\n  // Set field error\r\n  const setError = useCallback(\r\n    (error: string) => {\r\n      engine.setError(fieldName, error);\r\n      notifyUpdate();\r\n    },\r\n    [engine, fieldName, notifyUpdate],\r\n  );\r\n\r\n  // Clear field error\r\n  const clearError = useCallback(() => {\r\n    engine.clearError(fieldName);\r\n    notifyUpdate();\r\n  }, [engine, fieldName, notifyUpdate]);\r\n\r\n  // Mark field as touched\r\n  const markTouched = useCallback(async () => {\r\n    engine.markTouched(fieldName);\r\n    if (validateOnBlur) {\r\n      await engine.validate(fieldName, \"onBlur\");\r\n    }\r\n    notifyUpdate();\r\n  }, [engine, fieldName, validateOnBlur, notifyUpdate]);\r\n\r\n  // Validate field\r\n  const validate = useCallback(async () => {\r\n    const isValid = await engine.validate(fieldName, \"manual\");\r\n    notifyUpdate();\r\n    return isValid;\r\n  }, [engine, fieldName, notifyUpdate]);\r\n\r\n  return {\r\n    value: fieldState.value,\r\n    error: fieldState.error,\r\n    touched: fieldState.touched,\r\n    dirty: fieldState.dirty,\r\n    setValue,\r\n    setError,\r\n    clearError,\r\n    markTouched,\r\n    validate,\r\n  };\r\n}\r\n","/**\r\n * useFormState hook - observe form-level state\r\n */\r\n\r\nimport { useContext, useState, useEffect } from \"react\";\r\nimport { FormContext } from \"./FormContext.js\";\r\nimport type { UseFormStateResult } from \"./types.js\";\r\n\r\n/**\r\n * Hook for observing form-level state.\r\n *\r\n * Returns reactive state for all form values, errors, and validation status.\r\n * Use this for displaying form-level information like submit button state\r\n * or global error summaries.\r\n *\r\n * @returns Form state object\r\n * @throws {Error} If used outside FormProvider\r\n *\r\n * @public\r\n * @stable\r\n *\r\n * @example\r\n * ```tsx\r\n * function SubmitButton() {\r\n *   const { isValid, isDirty, isSubmitting } = useFormState();\r\n *\r\n *   return (\r\n *     <button\r\n *       type=\"submit\"\r\n *       disabled={!isValid || !isDirty || isSubmitting}\r\n *     >\r\n *       {isSubmitting ? 'Submitting...' : 'Submit'}\r\n *     </button>\r\n *   );\r\n * }\r\n * ```\r\n */\r\nexport function useFormState(): UseFormStateResult {\r\n  const context = useContext(FormContext);\r\n\r\n  if (!context) {\r\n    throw new Error(\"useFormState must be used within a FormProvider\");\r\n  }\r\n\r\n  const { engine, schema, version, isSubmitting } = context;\r\n\r\n  // Compute form state (re-computes when version changes)\r\n  const [formState, setFormState] = useState(() => {\r\n    const values: Record<string, unknown> = {};\r\n    schema.fields.forEach((field) => {\r\n      if (field?.name) {\r\n        values[field.name] = engine.getValue(field.name);\r\n      }\r\n    });\r\n\r\n    return {\r\n      values,\r\n      errors: engine.getErrors(),\r\n      isValid: engine.isValid(),\r\n      isDirty: engine.isDirty(),\r\n      isSubmitting,\r\n    };\r\n  });\r\n\r\n  // Update state when version changes\r\n  useEffect(() => {\r\n    const values: Record<string, unknown> = {};\r\n    schema.fields.forEach((field) => {\r\n      if (field?.name) {\r\n        values[field.name] = engine.getValue(field.name);\r\n      }\r\n    });\r\n\r\n    setFormState({\r\n      values,\r\n      errors: engine.getErrors(),\r\n      isValid: engine.isValid(),\r\n      isDirty: engine.isDirty(),\r\n      isSubmitting,\r\n    });\r\n  }, [engine, schema, version, isSubmitting]);\r\n\r\n  return formState;\r\n}\r\n","/**\r\n * useStep hook - multi-step form navigation\r\n */\r\n\r\nimport { useContext, useState, useCallback, useEffect } from \"react\";\r\nimport { FormContext } from \"./FormContext.js\";\r\nimport type { UseStepResult } from \"./types.js\";\r\n\r\n/**\r\n * Hook for multi-step form navigation.\r\n *\r\n * Only works with multi-step forms (schemas with `steps` defined).\r\n * Provides current step information and navigation methods.\r\n *\r\n * @returns Step state and navigation methods\r\n * @throws {Error} If used outside FormProvider or in single-step form\r\n *\r\n * @public\r\n * @stable\r\n *\r\n * @example\r\n * ```tsx\r\n * function StepNavigation() {\r\n *   const {\r\n *     currentStep,\r\n *     totalSteps,\r\n *     nextStep,\r\n *     prevStep,\r\n *     canGoToStep\r\n *   } = useStep();\r\n *\r\n *   const handleNext = async () => {\r\n *     const moved = await nextStep();\r\n *     if (!moved) {\r\n *       alert('Please fix errors before proceeding');\r\n *     }\r\n *   };\r\n *\r\n *   return (\r\n *     <div>\r\n *       <p>Step {currentStep + 1} of {totalSteps}</p>\r\n *       <button onClick={prevStep} disabled={currentStep === 0}>\r\n *         Previous\r\n *       </button>\r\n *       <button onClick={handleNext}>\r\n *         {currentStep === totalSteps - 1 ? 'Submit' : 'Next'}\r\n *       </button>\r\n *     </div>\r\n *   );\r\n * }\r\n * ```\r\n */\r\nexport function useStep(): UseStepResult {\r\n  const context = useContext(FormContext);\r\n\r\n  if (!context) {\r\n    throw new Error(\"useStep must be used within a FormProvider\");\r\n  }\r\n\r\n  const { engine, version, notifyUpdate, schema } = context;\r\n\r\n  // Check if this is a multi-step form\r\n  if (!schema.steps || schema.steps.length === 0) {\r\n    throw new Error(\r\n      \"useStep can only be used with multi-step forms. Schema must have steps defined.\",\r\n    );\r\n  }\r\n\r\n  // Track step state\r\n  const [stepState, setStepState] = useState(() => ({\r\n    currentStep: engine.getCurrentStep?.() ?? 0,\r\n    totalSteps: engine.getTotalSteps?.() ?? 1,\r\n  }));\r\n\r\n  // Update step state when version changes\r\n  useEffect(() => {\r\n    setStepState({\r\n      currentStep: engine.getCurrentStep?.() ?? 0,\r\n      totalSteps: engine.getTotalSteps?.() ?? 1,\r\n    });\r\n  }, [engine, version]);\r\n\r\n  // Go to next step\r\n  const nextStep = useCallback(async () => {\r\n    if (!engine.nextStep) {\r\n      throw new Error(\"nextStep is not available on this engine\");\r\n    }\r\n\r\n    const moved = await engine.nextStep();\r\n    notifyUpdate(); // Notify context of step change\r\n    return moved;\r\n  }, [engine, notifyUpdate]);\r\n\r\n  // Go to previous step\r\n  const prevStep = useCallback(() => {\r\n    if (!engine.prevStep) {\r\n      throw new Error(\"prevStep is not available on this engine\");\r\n    }\r\n\r\n    engine.prevStep();\r\n    notifyUpdate();\r\n  }, [engine, notifyUpdate]);\r\n\r\n  // Jump to specific step\r\n  const goToStep = useCallback(\r\n    async (stepIndex: number) => {\r\n      if (!engine.goToStep) {\r\n        throw new Error(\"goToStep is not available on this engine\");\r\n      }\r\n\r\n      const moved = await engine.goToStep(stepIndex);\r\n      notifyUpdate();\r\n      return moved;\r\n    },\r\n    [engine, notifyUpdate],\r\n  );\r\n\r\n  // Check if can navigate to step\r\n  const canGoToStep = useCallback(\r\n    (stepIndex: number) => {\r\n      if (!engine.canGoToStep) {\r\n        return false;\r\n      }\r\n\r\n      return engine.canGoToStep(stepIndex);\r\n    },\r\n    [engine],\r\n  );\r\n\r\n  return {\r\n    currentStep: stepState.currentStep,\r\n    totalSteps: stepState.totalSteps,\r\n    nextStep,\r\n    prevStep,\r\n    goToStep,\r\n    canGoToStep,\r\n  };\r\n}\r\n"],"mappings":"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","names":["useCallback","useCallback","isValid","useContext","useState","useCallback","useEffect","useContext","useState","useEffect","useCallback","useContext","useState","useEffect","useContext","useState","useEffect","useContext","useState","useCallback","useEffect","useContext","useState","useEffect","useCallback"]}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@formos/react",
+  "version": "0.1.0",
+  "description": "React bindings for Formos - Headless form engine hooks",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "form",
+    "react",
+    "hooks",
+    "form-builder",
+    "form-engine",
+    "headless",
+    "typescript"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yourusername/formos.git",
+    "directory": "packages/react"
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "react": "^18.0.0"
+  },
+  "dependencies": {
+    "@formos/schema": "0.1.0",
+    "@formos/kernel": "0.1.0"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^14.1.2",
+    "@types/jest": "^29.5.14",
+    "@types/react": "^18.2.47",
+    "@jest/globals": "^29.7.0",
+    "eslint": "^9.17.0",
+    "jest": "^29.7.0",
+    "jest-environment-jsdom": "^29.7.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "ts-jest": "^29.1.2",
+    "tsup": "^8.0.1",
+    "typescript": "^5.9.2",
+    "@repo/typescript-config": "0.0.0",
+    "@repo/eslint-config": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint . --max-warnings 0",
+    "check-types": "tsc --noEmit",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "publish:npm": "pnpm publish --access public"
+  }
+}