@character-foundry/character-foundry 0.4.3-dev.1766103111 → 0.4.3-dev.1767230557

package/dist/app-framework.d.cts

@@ -518,6 +518,14 @@ export interface AutoFormProps<T extends z.ZodObject<z.ZodRawShape>> {
 	onChange?: (values: z.infer<T>) => void;
 	/** Called on form submit with validated data */
 	onSubmit?: (values: z.infer<T>) => void | Promise<void>;
+	/** Called when validation fails during onChange */
+	onValidationError?: (error: z.ZodError) => void;
+	/**
+	 * Called on every value change, regardless of validation status.
+	 * Useful when you need to track raw user input before validation.
+	 * The values may not conform to the schema type.
+	 */
+	onRawChange?: (values: unknown) => void;
 	/** UI hints for customizing field rendering */
 	uiHints?: UIHints<z.infer<T>>;
 	/** Custom field order (array of field names) */
@@ -592,7 +600,7 @@ export interface AutoFormProps<T extends z.ZodObject<z.ZodRawShape>> {
  * />
  * ```
  */
-export declare function AutoForm<T extends z.ZodObject<z.ZodRawShape>>({ schema, values, defaultValues, onChange, onSubmit, uiHints, fieldOrder, disabled, withSubmit, submitText, className, widgetRegistry, children, }: AutoFormProps<T>): react_jsx_runtime.JSX.Element;
+export declare function AutoForm<T extends z.ZodObject<z.ZodRawShape>>({ schema, values, defaultValues, onChange, onSubmit, onValidationError, onRawChange, uiHints, fieldOrder, disabled, withSubmit, submitText, className, widgetRegistry, children, }: AutoFormProps<T>): react_jsx_runtime.JSX.Element;
 /**
  * Analyzed field information extracted from a Zod schema.
  */

package/dist/app-framework.d.ts

@@ -518,6 +518,14 @@ export interface AutoFormProps<T extends z.ZodObject<z.ZodRawShape>> {
 	onChange?: (values: z.infer<T>) => void;
 	/** Called on form submit with validated data */
 	onSubmit?: (values: z.infer<T>) => void | Promise<void>;
+	/** Called when validation fails during onChange */
+	onValidationError?: (error: z.ZodError) => void;
+	/**
+	 * Called on every value change, regardless of validation status.
+	 * Useful when you need to track raw user input before validation.
+	 * The values may not conform to the schema type.
+	 */
+	onRawChange?: (values: unknown) => void;
 	/** UI hints for customizing field rendering */
 	uiHints?: UIHints<z.infer<T>>;
 	/** Custom field order (array of field names) */
@@ -592,7 +600,7 @@ export interface AutoFormProps<T extends z.ZodObject<z.ZodRawShape>> {
  * />
  * ```
  */
-export declare function AutoForm<T extends z.ZodObject<z.ZodRawShape>>({ schema, values, defaultValues, onChange, onSubmit, uiHints, fieldOrder, disabled, withSubmit, submitText, className, widgetRegistry, children, }: AutoFormProps<T>): react_jsx_runtime.JSX.Element;
+export declare function AutoForm<T extends z.ZodObject<z.ZodRawShape>>({ schema, values, defaultValues, onChange, onSubmit, onValidationError, onRawChange, uiHints, fieldOrder, disabled, withSubmit, submitText, className, widgetRegistry, children, }: AutoFormProps<T>): react_jsx_runtime.JSX.Element;
 /**
  * Analyzed field information extracted from a Zod schema.
  */

package/dist/app-framework.js

@@ -1629,6 +1629,8 @@ function AutoForm({
   defaultValues,
   onChange,
   onSubmit,
+  onValidationError,
+  onRawChange,
   uiHints = {},
   fieldOrder,
   disabled = false,
@@ -1723,15 +1725,22 @@ function AutoForm({
   }, [values, reset, schemaDefaults, defaultValues]);
   const onChangeRef = useRef3(onChange);
   onChangeRef.current = onChange;
+  const onValidationErrorRef = useRef3(onValidationError);
+  onValidationErrorRef.current = onValidationError;
+  const onRawChangeRef = useRef3(onRawChange);
+  onRawChangeRef.current = onRawChange;
   const schemaRef = useRef3(schema);
   schemaRef.current = schema;
   useEffect2(() => {
-    if (!onChangeRef.current) return;
+    if (!onChangeRef.current && !onValidationErrorRef.current && !onRawChangeRef.current) return;
     const subscription = watch((formValues, { type }) => {
       if (type !== "change") return;
+      onRawChangeRef.current?.(formValues);
       const result = schemaRef.current.safeParse(formValues);
-      if (result.success && onChangeRef.current) {
-        onChangeRef.current(result.data);
+      if (result.success) {
+        onChangeRef.current?.(result.data);
+      } else {
+        onValidationErrorRef.current?.(result.error);
       }
     });
     return () => subscription.unsubscribe();