alepha 0.23.0 → 0.24.0

package/dist/react/form/index.js

@@ -1,4 +1,4 @@
-import { $inject, $module, Alepha, TypeBoxError, t } from "alepha";
+import { $inject, $module, Alepha, TypeBoxError, coerceObject, z } from "alepha";
 import { useAlepha } from "alepha/react";
 import { useEffect, useId, useMemo, useRef, useState } from "react";
 import { $logger } from "alepha/logger";
@@ -80,8 +80,6 @@ var FormValidationError = class extends TypeBoxError {
 		super({
 			message: options.message,
 			instancePath: options.path,
-			schemaPath: "",
-			keyword: "not",
 			params: {}
 		});
 	}
@@ -134,7 +132,7 @@ var FormModel = class {
 		const schemaDefaults = this.extractSchemaDefaults(options.schema);
 		if (Object.keys(schemaDefaults).length > 0) Object.assign(this.values, schemaDefaults);
 		if (options.initialValues) {
-			const decoded = this.alepha.codec.decode(t.partial(options.schema), options.initialValues);
+			const decoded = this.alepha.codec.decode(options.schema.partial(), options.initialValues);
 			Object.assign(this.values, decoded);
 		}
 		this.initialValues = { ...this.values };
@@ -144,19 +142,31 @@ var FormModel = class {
 		});
 	}
 	/**
-	* Extract default values from a TypeBox schema.
-	* Recursively handles nested objects.
+	* Extract default values from a zod object schema.
+	* Recursively handles nested objects, unwrapping optional/nullable/default.
 	*/
 	extractSchemaDefaults(schema, prefix = "") {
 		const defaults = {};
-		if (!schema.properties) return defaults;
-		for (const [key, propSchema] of Object.entries(schema.properties)) {
+		const shape = schema.shape;
+		if (!shape) return defaults;
+		for (const [key, propSchema] of Object.entries(shape)) {
 			const fullKey = prefix ? `${prefix}.${key}` : key;
-			if ("default" in propSchema && propSchema.default !== void 0) defaults[fullKey] = propSchema.default;
-			else if (propSchema && "type" in propSchema && propSchema.type === "object" && "properties" in propSchema) {
-				const nestedDefaults = this.extractSchemaDefaults(propSchema, fullKey);
-				Object.assign(defaults, nestedDefaults);
+			let inner = propSchema;
+			let defaultValue;
+			while (inner) {
+				if (z.schema.isDefault(inner)) {
+					const dv = inner._zod.def.defaultValue;
+					defaultValue = typeof dv === "function" ? dv() : dv;
+					break;
+				}
+				if (z.schema.isOptional(inner) || z.schema.isNullable(inner)) {
+					inner = inner.unwrap();
+					continue;
+				}
+				break;
 			}
+			if (defaultValue !== void 0) defaults[fullKey] = defaultValue;
+			else if (z.schema.isObject(inner)) Object.assign(defaults, this.extractSchemaDefaults(inner, fullKey));
 		}
 		return defaults;
 	}
@@ -175,13 +185,13 @@ var FormModel = class {
 		};
 	}
 	setInitialValues = (values) => {
-		const decoded = this.alepha.codec.decode(t.partial(this.options.schema), values);
+		const decoded = this.alepha.codec.decode(this.options.schema.partial(), values);
 		const oldKeys = new Set(Object.keys(this.values));
 		for (const key in this.initialValues) delete this.initialValues[key];
 		Object.assign(this.initialValues, decoded);
 		for (const key in this.values) delete this.values[key];
 		Object.assign(this.values, { ...this.initialValues });
-		const keys = new Set([...oldKeys, ...Object.keys(this.values)]);
+		const keys = /* @__PURE__ */ new Set([...oldKeys, ...Object.keys(this.values)]);
 		for (const key of keys) {
 			const path = `/${key.replaceAll(".", "/")}`;
 			this.alepha.events.emit("form:change", {
@@ -194,7 +204,7 @@ var FormModel = class {
 	};
 	reset = (event) => {
 		event?.preventDefault?.();
-		const keys = new Set([...Object.keys(this.values), ...Object.keys(this.initialValues)]);
+		const keys = /* @__PURE__ */ new Set([...Object.keys(this.values), ...Object.keys(this.initialValues)]);
 		for (const key in this.values) delete this.values[key];
 		Object.assign(this.values, { ...this.initialValues });
 		for (const key of keys) {
@@ -222,7 +232,7 @@ var FormModel = class {
 		const options = this.options;
 		try {
 			let values = this.restructureValues(this.values);
-			if (t.schema.isSchema(options.schema)) values = this.alepha.codec.decode(options.schema, values);
+			if (z.schema.isSchema(options.schema)) values = this.alepha.codec.decode(options.schema, coerceObject(options.schema, values));
 			await options.handler(values);
 			await this.alepha.events.emit("react:action:success", {
 				type: "form",
@@ -285,14 +295,14 @@ var FormModel = class {
 	createProxyFromSchema(options, schema, context) {
 		context.parent;
 		return new Proxy({}, { get: (_, prop) => {
-			if (!options.schema || !t.schema.isObject(schema)) return {};
-			if (prop in schema.properties) return this.createInputFromSchema(prop, options, schema, schema.required?.includes(prop) || false, context);
+			if (!options.schema || !z.schema.isObject(schema)) return {};
+			if (prop in schema.properties) return this.createInputFromSchema(prop, options, schema, z.schema.requiredKeys(schema).includes(prop) || false, context);
 		} });
 	}
 	createInputFromSchema(name, options, schema, required, context) {
 		const parent = context.parent || "";
-		const field = schema.properties?.[name];
-		if (!field) return {
+		const rawField = schema.properties?.[name];
+		if (!rawField) return {
 			path: "",
 			required,
 			initialValue: void 0,
@@ -301,7 +311,8 @@ var FormModel = class {
 			set: () => {},
 			form: this
 		};
-		const isRequired = schema.required?.includes(name) ?? false;
+		const field = z.schema.unwrap(rawField);
+		const isRequired = z.schema.requiredKeys(schema).includes(name) ?? false;
 		const key = parent ? `${parent}.${name}` : name;
 		const path = `/${key.replaceAll(".", "/")}`;
 		const set = (value) => {
@@ -317,27 +328,27 @@ var FormModel = class {
 		const attr = { name: key };
 		attr.id = `${this.id}-${key}`;
 		attr["data-testid"] = attr.id;
-		if (t.schema.isString(field)) {
+		if (z.schema.isString(field)) {
 			if (field.maxLength != null) attr.maxLength = Number(field.maxLength);
 			if (field.minLength != null) attr.minLength = Number(field.minLength);
 		}
 		if (isRequired) attr.required = true;
 		if ("description" in field && typeof field.description === "string") attr["aria-label"] = field.description;
-		if (t.schema.isInteger(field) || t.schema.isNumber(field)) attr.type = "number";
+		if (z.schema.isInteger(field) || z.schema.isNumber(field)) attr.type = "number";
 		else if (name === "password") attr.type = "password";
 		else if (name === "email") attr.type = "email";
 		else if (name === "url") attr.type = "url";
-		else if (t.schema.isString(field)) if (field.format === "binary") attr.type = "file";
-		else if (field.format === "date") attr.type = "date";
-		else if (field.format === "time") attr.type = "time";
-		else if (field.format === "date-time") attr.type = "datetime-local";
+		else if (z.schema.isString(field)) if (z.schema.format(field) === "binary") attr.type = "file";
+		else if (z.schema.format(field) === "date") attr.type = "date";
+		else if (z.schema.format(field) === "time") attr.type = "time";
+		else if (z.schema.format(field) === "date-time") attr.type = "datetime-local";
 		else attr.type = "text";
-		else if (t.schema.isBoolean(field)) attr.type = "checkbox";
+		else if (z.schema.isBoolean(field)) attr.type = "checkbox";
 		if (options.onCreateField) {
 			const customAttr = options.onCreateField(name, field);
 			Object.assign(attr, customAttr);
 		}
-		if (t.schema.isObject(field)) return {
+		if (z.schema.isObject(field)) return {
 			path,
 			props: attr,
 			schema: field,
@@ -350,7 +361,7 @@ var FormModel = class {
 				store: context.store
 			})
 		};
-		if (t.schema.isArray(field)) return {
+		if (z.schema.isArray(field)) return {
 			path,
 			props: attr,
 			schema: field,
@@ -377,23 +388,23 @@ var FormModel = class {
 	getValueFromInput(input, schema) {
 		if (input === null || input === void 0) return;
 		if (input instanceof File) {
-			if (t.schema.isString(schema) && schema.format === "binary") return input;
+			if (z.schema.isString(schema) && z.schema.format(schema) === "binary") return input;
 			return null;
 		}
-		if (t.schema.isBoolean(schema)) {
+		if (z.schema.isBoolean(schema)) {
 			if (input === "true") return true;
 			if (input === "false") return false;
 			if (input === "" || input === null || input === void 0) return void 0;
 			return !!input;
 		}
-		if (t.schema.isNumber(schema)) {
+		if (z.schema.isNumber(schema)) {
 			const num = Number(input);
 			return Number.isNaN(num) ? null : num;
 		}
-		if (t.schema.isString(schema)) {
-			if (schema.format === "date") return new Date(input).toISOString().slice(0, 10);
-			if (schema.format === "time") return (/* @__PURE__ */ new Date(`1970-01-01T${input}`)).toISOString().slice(11, 16);
-			if (schema.format === "date-time") return new Date(input).toISOString();
+		if (z.schema.isString(schema)) {
+			if (z.schema.format(schema) === "date") return new Date(input).toISOString().slice(0, 10);
+			if (z.schema.format(schema) === "time") return (/* @__PURE__ */ new Date(`1970-01-01T${input}`)).toISOString().slice(11, 16);
+			if (z.schema.format(schema) === "date-time") return new Date(input).toISOString();
 			return String(input);
 		}
 		return input;
@@ -408,12 +419,12 @@ var FormModel = class {
 *
 * @example
 * ```tsx
-* import { t } from "alepha";
+* import { z } from "alepha";
 *
 * const form = useForm({
-*   schema: t.object({
-*     username: t.text(),
-*     password: t.text(),
+*   schema: z.object({
+*     username: z.text(),
+*     password: z.text(),
 *   }),
 *   handler: (values) => {
 *     console.log("Form submitted with values:", values);
@@ -454,6 +465,15 @@ const useForm = (options, deps = []) => {
 			args: [options.id || formId, options]
 		});
 	}, deps);
+	useEffect(() => {
+		Object.assign(form.options, {
+			handler: options.handler,
+			onError: options.onError,
+			onChange: options.onChange,
+			onReset: options.onReset,
+			onCreateField: options.onCreateField
+		});
+	});
 	useEffect(() => {
 		if (stableEqual(initialValuesRef.current, options.initialValues)) return;
 		initialValuesRef.current = options.initialValues;
@@ -485,7 +505,7 @@ const useForm = (options, deps = []) => {
 * navigable via back/forward.
 *
 * @example
-* const form = useForm({ schema: t.object({ status: t.string(), q: t.string() }) });
+* const form = useForm({ schema: z.object({ status: z.string(), q: z.string() }) });
 * useFormQuerySync(form, { keys: ["status", "q"] });
 */
 const useFormQuerySync = (form, options) => {
@@ -589,16 +609,21 @@ const prettyName = (name) => {
 * error messages, icons, and validation constraints.
 */
 const parseField = (input, options = {}) => {
-	const schema = input.schema;
-	const label = options.label ?? (typeof schema.title === "string" ? schema.title : void 0) ?? prettyName(input.path);
-	const description = options.description ?? (typeof schema.description === "string" ? schema.description : void 0);
+	const schema = z.schema.unwrap(input.schema);
+	const meta = typeof schema.meta === "function" ? schema.meta() : null;
+	const label = options.label ?? (typeof meta?.title === "string" ? meta.title : void 0) ?? prettyName(input.path);
+	const description = options.description ?? (typeof meta?.description === "string" ? meta.description : void 0);
 	const error = options.error instanceof TypeBoxError ? options.error.value?.message : void 0;
-	const type = schema.type;
-	const format = typeof schema.format === "string" ? schema.format : void 0;
-	const isEnum = Array.isArray(schema.enum);
-	const isArray = type === "array";
-	const isObject = type === "object" && Boolean(schema.properties);
-	const isArrayOfObjects = isArray && Boolean(schema.items && schema.items.properties);
+	const isEnum = z.schema.isEnum(schema);
+	const isArray = z.schema.isArray(schema);
+	const isObject = z.schema.isObject(schema);
+	const isInteger = z.schema.isInteger(schema);
+	const isNumber = !isInteger && z.schema.isNumber(schema);
+	const isBoolean = z.schema.isBoolean(schema);
+	const type = isObject ? "object" : isArray ? "array" : isEnum ? "string" : isInteger ? "integer" : isNumber ? "number" : isBoolean ? "boolean" : z.schema.isString(schema) ? "string" : void 0;
+	const format = typeof z.schema.format(schema) === "string" ? z.schema.format(schema) : void 0;
+	const element = schema.element ?? schema.items;
+	const isArrayOfObjects = isArray && z.schema.isObject(element);
 	const name = input.props.name;
 	const iconHint = inferIconHint({
 		type,
@@ -610,9 +635,10 @@ const parseField = (input, options = {}) => {
 	const constraints = {};
 	if (typeof schema.minLength === "number") constraints.minLength = schema.minLength;
 	if (typeof schema.maxLength === "number") constraints.maxLength = schema.maxLength;
-	if (typeof schema.minimum === "number") constraints.minimum = schema.minimum;
-	if (typeof schema.maximum === "number") constraints.maximum = schema.maximum;
-	if (typeof schema.pattern === "string") constraints.pattern = schema.pattern;
+	if (typeof schema.minValue === "number") constraints.minimum = schema.minValue;
+	if (typeof schema.maxValue === "number") constraints.maximum = schema.maxValue;
+	const pattern = readPattern(schema);
+	if (pattern) constraints.pattern = pattern;
 	return {
 		id: input.props.id,
 		label,
@@ -625,14 +651,23 @@ const parseField = (input, options = {}) => {
 		isArray,
 		isObject,
 		isArrayOfObjects,
-		enum: schema.enum,
+		enum: isEnum ? z.schema.enumValues(schema) : void 0,
 		iconHint,
 		constraints,
 		testId: input.props["data-testid"],
 		schema: input.schema,
-		control: schema.$control
+		control: meta?.$control
 	};
 };
+/** Best-effort read of a `ZodString` regex pattern from its check list. */
+const readPattern = (schema) => {
+	const checks = schema?._zod?.def?.checks;
+	if (!Array.isArray(checks)) return void 0;
+	for (const check of checks) {
+		const pattern = check?._zod?.def?.pattern;
+		if (pattern instanceof RegExp) return pattern.source;
+	}
+};
 const inferIconHint = (params) => {
 	const { type, format, name, isEnum, isArray } = params;
 	if (format === "email") return "email";

package/dist/react/form/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/react/form/hooks/useFormState.ts","../../../src/react/form/components/FormState.tsx","../../../src/react/form/errors/FormValidationError.ts","../../../src/react/form/hooks/useFieldValue.ts","../../../src/react/form/services/FormModel.ts","../../../src/react/form/hooks/useForm.ts","../../../src/react/form/hooks/useFormQuerySync.ts","../../../src/react/form/hooks/useFormValues.ts","../../../src/react/form/services/prettyName.ts","../../../src/react/form/services/parseField.ts","../../../src/react/form/index.ts"],"sourcesContent":["import { type TObject, TypeBoxError } from \"alepha\";\nimport { useAlepha } from \"alepha/react\";\nimport { useEffect, useState } from \"react\";\nimport type { FormModel } from \"../services/FormModel.ts\";\n\nexport interface UseFormStateReturn {\n  loading: boolean;\n  dirty: boolean;\n  values?: Record<string, any>;\n  error?: Error;\n}\n\nexport const useFormState = <\n  T extends TObject,\n  Keys extends keyof UseFormStateReturn,\n>(\n  target: FormModel<T> | { form: FormModel<T>; path: string },\n  _events: Keys[] = [\"loading\", \"dirty\", \"error\"] as Keys[],\n): Pick<UseFormStateReturn, Keys> => {\n  const alepha = useAlepha();\n  const events = _events as string[];\n\n  const [dirty, setDirty] = useState(false);\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<Error | undefined>(undefined);\n  const [values, setValues] = useState<Record<string, any> | undefined>(\n    undefined,\n  );\n\n  const form = \"form\" in target ? target.form : target;\n  const path = \"path\" in target ? target.path : undefined;\n\n  const hasValues = events.includes(\"values\");\n  const hasErrors = events.includes(\"error\");\n  const hasDirty = events.includes(\"dirty\");\n  const hasLoading = events.includes(\"loading\");\n\n  useEffect(() => {\n    const listeners: Function[] = [];\n\n    if (hasErrors || hasValues || hasDirty) {\n      listeners.push(\n        alepha.events.on(\"form:change\", (event) => {\n          if (event.id === form.id) {\n            if (!path || event.path === path) {\n              // `initial: true` marks a programmatic reset (e.g. parent\n              // re-rendering with fresh data via `setInitialValues`). Treat\n              // it like a reset: clear dirty, don't mark dirty.\n              if (hasDirty) {\n                if (event.initial) {\n                  setDirty(false);\n                } else {\n                  setDirty(true);\n                }\n              }\n              if (hasErrors) {\n                setError(undefined);\n              }\n            }\n            if (hasValues) {\n              setValues(form.currentValues);\n            }\n          }\n        }),\n      );\n    }\n\n    if (hasLoading) {\n      listeners.push(\n        alepha.events.on(\"form:submit:begin\", (event) => {\n          if (event.id === form.id) {\n            setLoading(true);\n          }\n        }),\n        alepha.events.on(\"form:submit:end\", (event) => {\n          if (event.id === form.id) {\n            setLoading(false);\n          }\n        }),\n      );\n    }\n\n    if (hasValues || hasDirty) {\n      listeners.push(\n        alepha.events.on(\"form:submit:success\", (event) => {\n          if (event.id === form.id) {\n            if (hasValues) {\n              setValues(event.values);\n            }\n            if (hasDirty) {\n              setDirty(false);\n            }\n          }\n        }),\n      );\n    }\n\n    if (hasDirty) {\n      listeners.push(\n        alepha.events.on(\"form:reset\", (event) => {\n          if (event.id === form.id) {\n            setDirty(false);\n          }\n        }),\n      );\n    }\n\n    if (hasErrors) {\n      listeners.push(\n        alepha.events.on(\"form:submit:error\", (event) => {\n          if (event.id === form.id) {\n            if (\n              !path ||\n              (event.error instanceof TypeBoxError &&\n                event.error.value.path === path)\n            ) {\n              setError(event.error);\n            }\n          }\n        }),\n      );\n    }\n\n    return () => {\n      for (const unsub of listeners) {\n        unsub();\n      }\n    };\n  }, []);\n\n  return {\n    dirty,\n    loading,\n    error,\n    values,\n  } as Pick<UseFormStateReturn, Keys>;\n};\n","import type { TObject } from \"alepha\";\nimport type { ReactNode } from \"react\";\nimport { useFormState } from \"../hooks/useFormState.ts\";\nimport type { FormModel } from \"../services/FormModel.ts\";\n\nconst FormState = <T extends TObject>(props: {\n  form: FormModel<T>;\n  children: (state: { loading: boolean; dirty: boolean }) => ReactNode;\n}) => {\n  const formState = useFormState(props.form);\n  return props.children({\n    loading: formState.loading,\n    dirty: formState.dirty,\n  });\n};\n\nexport default FormState;\n","import { TypeBoxError } from \"alepha\";\n\nexport class FormValidationError extends TypeBoxError {\n  readonly name = \"ValidationError\";\n\n  constructor(options: {\n    message: string;\n    path: string;\n  }) {\n    super({\n      message: options.message,\n      instancePath: options.path,\n      schemaPath: \"\",\n      keyword: \"not\",\n      params: {},\n    });\n  }\n}\n","import { useAlepha } from \"alepha/react\";\nimport { useEffect, useState } from \"react\";\nimport type { BaseInputField } from \"../services/FormModel.ts\";\n\n/**\n * Hook to subscribe to a single form field's value.\n * Only re-renders when this specific field changes.\n *\n * @returns A tuple of [value, setValue] similar to useState.\n */\nexport const useFieldValue = (\n  input: BaseInputField,\n): [any, (value: any) => void] => {\n  const alepha = useAlepha();\n  const [value, setValue] = useState(input?.initialValue);\n\n  useEffect(() => {\n    if (!input?.form || !alepha.isBrowser()) {\n      return;\n    }\n\n    return alepha.events.on(\"form:change\", (ev) => {\n      if (ev.id === input.form.id && ev.path === input.path) {\n        setValue(ev.value);\n      }\n    });\n  }, []);\n\n  const setFieldValue = (newValue: any) => {\n    input.set(newValue);\n  };\n\n  return [value, setFieldValue];\n};\n","import type { TArray } from \"alepha\";\nimport {\n  $inject,\n  Alepha,\n  type Static,\n  type TObject,\n  type TSchema,\n  t,\n} from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport type { InputHTMLAttributes } from \"react\";\n\n/**\n * FormModel is a dynamic form handler that generates form inputs based on a provided TypeBox schema.\n * It manages form state, handles input changes, and processes form submissions with validation.\n *\n * It means to be injected and used within React components to provide a structured way to create and manage forms.\n *\n * @see {@link useForm}\n */\nexport class FormModel<T extends TObject> {\n  protected readonly log = $logger();\n  protected readonly alepha = $inject(Alepha);\n  protected readonly values: Record<string, any> = {};\n  protected readonly initialValues: Record<string, any> = {};\n  protected submitInProgress = false;\n\n  public input: SchemaToInput<T>;\n\n  constructor(\n    public readonly id: string,\n    public readonly options: FormCtrlOptions<T>,\n  ) {\n    this.options = options;\n\n    // Initialize with schema defaults first, then override with initialValues\n    const schemaDefaults = this.extractSchemaDefaults(options.schema);\n    if (Object.keys(schemaDefaults).length > 0) {\n      Object.assign(this.values, schemaDefaults);\n    }\n\n    if (options.initialValues) {\n      // Decode against a partial of the schema so callers can supply incomplete\n      // initial values (the form's whole job is to collect them). Codecs still\n      // run on whatever's provided; missing fields stay undefined and only the\n      // full schema is enforced at submit time.\n      const decoded = this.alepha.codec.decode(\n        t.partial(options.schema),\n        options.initialValues,\n      ) as Record<string, any>;\n      Object.assign(this.values, decoded);\n    }\n\n    this.initialValues = { ...this.values };\n\n    this.input = this.createProxyFromSchema(options, options.schema, {\n      store: this.values,\n      parent: \"\",\n    });\n  }\n\n  /**\n   * Extract default values from a TypeBox schema.\n   * Recursively handles nested objects.\n   */\n  protected extractSchemaDefaults(\n    schema: TObject,\n    prefix: string = \"\",\n  ): Record<string, any> {\n    const defaults: Record<string, any> = {};\n\n    if (!schema.properties) {\n      return defaults;\n    }\n\n    for (const [key, propSchema] of Object.entries(schema.properties)) {\n      const fullKey = prefix ? `${prefix}.${key}` : key;\n\n      if (\"default\" in propSchema && propSchema.default !== undefined) {\n        defaults[fullKey] = propSchema.default;\n      } else if (\n        propSchema &&\n        \"type\" in propSchema &&\n        propSchema.type === \"object\" &&\n        \"properties\" in propSchema\n      ) {\n        // Recursively extract defaults from nested objects\n        const nestedDefaults = this.extractSchemaDefaults(\n          propSchema as TObject,\n          fullKey,\n        );\n        Object.assign(defaults, nestedDefaults);\n      }\n    }\n\n    return defaults;\n  }\n\n  public get currentValues(): Record<string, any> {\n    return this.restructureValues(this.values);\n  }\n\n  public get props() {\n    return {\n      id: this.id,\n      noValidate: true,\n      onSubmit: (ev?: FormEventLike) => {\n        ev?.preventDefault?.();\n        this.submit();\n      },\n      onReset: (event: FormEventLike) => this.reset(event),\n    };\n  }\n\n  public readonly setInitialValues = (values: Record<string, any>) => {\n    // Same partial-decode rationale as the constructor — initial values may be\n    // incomplete; full schema is enforced only at submit time.\n    const decoded = this.alepha.codec.decode(\n      t.partial(this.options.schema),\n      values,\n    ) as Record<string, any>;\n\n    // Snapshot the OLD keys before we wipe — without this, fields that\n    // had a value but are absent from the new initialValues never emit\n    // form:change and useFieldValue subscribers keep showing the stale\n    // value. Mirrors the union-of-keys pattern in reset() below.\n    const oldKeys = new Set(Object.keys(this.values));\n\n    for (const key in this.initialValues) {\n      delete (this.initialValues as Record<string, any>)[key];\n    }\n    Object.assign(this.initialValues, decoded);\n\n    for (const key in this.values) {\n      delete this.values[key];\n    }\n    Object.assign(this.values, { ...this.initialValues });\n\n    const keys = new Set<string>([...oldKeys, ...Object.keys(this.values)]);\n    for (const key of keys) {\n      const path = `/${key.replaceAll(\".\", \"/\")}`;\n      this.alepha.events.emit(\n        \"form:change\",\n        { id: this.id, path, value: this.values[key], initial: true },\n        { catch: true },\n      );\n    }\n  };\n\n  public readonly reset = (event?: FormEventLike) => {\n    event?.preventDefault?.();\n    // Snapshot all keys that need notification — both keys present\n    // before reset (so subscribers learn the cleared value) and keys\n    // restored from initialValues. Without the union, fields that were\n    // typed but absent from initialValues stay visually stale.\n    const keys = new Set<string>([\n      ...Object.keys(this.values),\n      ...Object.keys(this.initialValues),\n    ]);\n    for (const key in this.values) {\n      delete this.values[key];\n    }\n    Object.assign(this.values, { ...this.initialValues });\n    for (const key of keys) {\n      const path = `/${key.replaceAll(\".\", \"/\")}`;\n      this.alepha.events.emit(\n        \"form:change\",\n        { id: this.id, path, value: this.values[key] },\n        { catch: true },\n      );\n    }\n    this.alepha.events.emit(\"form:reset\", { id: this.id }, { catch: true });\n    this.options.onReset?.();\n  };\n\n  public readonly submit = async () => {\n    if (this.submitInProgress) {\n      this.log.warn(\n        \"Form submission already in progress, ignoring duplicate submit.\",\n      );\n      return;\n    }\n\n    // Lifecycle events are best-effort NOTIFICATIONS (loading spinners, toasts,\n    // analytics). A misbehaving listener must never break form state or reject\n    // submit() — hence `{ catch: true }` on every emit below. Without it, a\n    // throwing `react:action:error`/`form:submit:error` listener would skip the\n    // `form:submit:end` \"loading off\" signal and leave submit buttons stuck in\n    // their loading state forever.\n    await this.alepha.events.emit(\n      \"react:action:begin\",\n      { type: \"form\", id: this.id },\n      { catch: true },\n    );\n    await this.alepha.events.emit(\n      \"form:submit:begin\",\n      { id: this.id },\n      { catch: true },\n    );\n\n    this.submitInProgress = true;\n\n    const options = this.options;\n\n    try {\n      let values: Record<string, any> = this.restructureValues(this.values);\n\n      if (t.schema.isSchema(options.schema)) {\n        values = this.alepha.codec.decode(options.schema, values) as Record<\n          string,\n          any\n        >;\n      }\n\n      await options.handler(values as any);\n\n      await this.alepha.events.emit(\n        \"react:action:success\",\n        { type: \"form\", id: this.id },\n        { catch: true },\n      );\n      await this.alepha.events.emit(\n        \"form:submit:success\",\n        { id: this.id, values },\n        { catch: true },\n      );\n    } catch (error) {\n      this.log.error(\"Form submission error:\", error);\n\n      // A throwing onError callback must not abort the lifecycle either.\n      try {\n        options.onError?.(error as Error);\n      } catch (handlerError) {\n        this.log.error(\"Form onError handler threw:\", handlerError);\n      }\n\n      await this.alepha.events.emit(\n        \"react:action:error\",\n        { type: \"form\", id: this.id, error: error as Error },\n        { catch: true },\n      );\n      await this.alepha.events.emit(\n        \"form:submit:error\",\n        { error: error as Error, id: this.id },\n        { catch: true },\n      );\n    } finally {\n      this.submitInProgress = false;\n\n      // The \"loading off\" signals live in `finally` so they ALWAYS fire,\n      // even if something above threw — guaranteeing the begin/end pairing\n      // that drives submit-button loading state.\n      await this.alepha.events.emit(\n        \"react:action:end\",\n        { type: \"form\", id: this.id },\n        { catch: true },\n      );\n      await this.alepha.events.emit(\n        \"form:submit:end\",\n        { id: this.id },\n        { catch: true },\n      );\n    }\n  };\n\n  /**\n   * Restructures flat keys like \"address.city\" into nested objects like { address: { city: ... } }\n   * Values are already typed from onChange, so no conversion is needed.\n   */\n  protected restructureValues(store: Record<string, any>): Record<string, any> {\n    const values: Record<string, any> = {};\n\n    for (const [key, value] of Object.entries(store)) {\n      if (key.includes(\".\")) {\n        // nested object: restructure flat key to nested structure\n        this.restructureNestedValue(values, key, value);\n      } else {\n        // value is already typed, just copy it\n        values[key] = value;\n      }\n    }\n\n    return values;\n  }\n\n  /**\n   * Helper to restructure a flat key like \"address.city\" into nested object structure.\n   * The value is already typed, so we just assign it to the nested path.\n   */\n  protected restructureNestedValue(\n    values: Record<string, any>,\n    key: string,\n    value: any,\n  ) {\n    const pathSegments = key.split(\".\");\n    const finalPropertyKey = pathSegments.pop();\n    if (!finalPropertyKey) {\n      return;\n    }\n\n    let currentObjectLevel = values;\n\n    // traverse/create the nested structure\n    for (const segment of pathSegments) {\n      currentObjectLevel[segment] ??= {};\n      currentObjectLevel = currentObjectLevel[segment];\n    }\n\n    // value is already typed from onChange, just assign it\n    currentObjectLevel[finalPropertyKey] = value;\n  }\n\n  protected createProxyFromSchema<T extends TObject>(\n    options: FormCtrlOptions<T>,\n    schema: TSchema,\n    context: {\n      parent: string;\n      store: Record<string, any>;\n    },\n  ): SchemaToInput<T> {\n    const parent = context.parent || \"\";\n    return new Proxy<SchemaToInput<T>>({} as SchemaToInput<T>, {\n      get: (_, prop: string) => {\n        if (!options.schema || !t.schema.isObject(schema)) {\n          return {};\n        }\n\n        if (prop in schema.properties) {\n          // // it's a nested object, create another proxy\n          // if (t.schema.isObject(schema.properties[prop])) {\n          //   return this.createProxyFromSchema(\n          //     options,\n          //     schema.properties[prop],\n          //     {\n          //       parent: parent ? `${parent}.${prop}` : prop,\n          //       store: context.store,\n          //     },\n          //   );\n          // }\n\n          return this.createInputFromSchema<T>(\n            prop as keyof Static<T> & string,\n            options,\n            schema,\n            schema.required?.includes(prop as string) || false,\n            context,\n          );\n        }\n      },\n    });\n  }\n\n  protected createInputFromSchema<T extends TObject>(\n    name: keyof Static<T> & string,\n    options: FormCtrlOptions<T>,\n    schema: TObject,\n    required: boolean,\n    context: {\n      parent: string;\n      store: Record<string, any>;\n    },\n  ): BaseInputField {\n    const parent = context.parent || \"\";\n    const field = schema.properties?.[name];\n    if (!field) {\n      return {\n        path: \"\",\n        required,\n        initialValue: undefined,\n        props: {} as InputHTMLAttributes<unknown>,\n        schema: schema,\n        set: () => {},\n        form: this,\n      };\n    }\n\n    const isRequired = schema.required?.includes(name) ?? false;\n    const key = parent ? `${parent}.${name}` : name;\n    const path = `/${key.replaceAll(\".\", \"/\")}`;\n\n    const set = (value: any) => {\n      const typedValue = this.getValueFromInput(value, field);\n      context.store[key] = typedValue;\n      if (options.onChange) {\n        options.onChange(key, typedValue, context.store);\n      }\n      this.alepha.events.emit(\n        \"form:change\",\n        { id: this.id, path: path, value: typedValue },\n        { catch: true },\n      );\n    };\n\n    const attr: InputHTMLAttributesLike = {\n      name: key,\n    };\n\n    // Use the form's runtime id (always set — comes from `useId()` when\n    // no explicit `options.id` was provided). This guarantees stable\n    // per-field DOM ids without forcing callers to pass `id`.\n    attr.id = `${this.id}-${key}`;\n    (attr as any)[\"data-testid\"] = attr.id;\n\n    if (t.schema.isString(field)) {\n      if (field.maxLength != null) {\n        attr.maxLength = Number(field.maxLength);\n      }\n\n      if (field.minLength != null) {\n        attr.minLength = Number(field.minLength);\n      }\n    }\n\n    if (isRequired) {\n      attr.required = true;\n    }\n\n    if (\"description\" in field && typeof field.description === \"string\") {\n      attr[\"aria-label\"] = field.description;\n    }\n\n    if (t.schema.isInteger(field) || t.schema.isNumber(field)) {\n      attr.type = \"number\";\n    } else if (name === \"password\") {\n      attr.type = \"password\";\n    } else if (name === \"email\") {\n      attr.type = \"email\";\n    } else if (name === \"url\") {\n      attr.type = \"url\";\n    } else if (t.schema.isString(field)) {\n      if (field.format === \"binary\") {\n        attr.type = \"file\";\n      } else if (field.format === \"date\") {\n        attr.type = \"date\";\n      } else if (field.format === \"time\") {\n        attr.type = \"time\";\n      } else if (field.format === \"date-time\") {\n        attr.type = \"datetime-local\";\n      } else {\n        attr.type = \"text\";\n      }\n    } else if (t.schema.isBoolean(field)) {\n      attr.type = \"checkbox\";\n    }\n\n    if (options.onCreateField) {\n      const customAttr = options.onCreateField(name, field);\n      Object.assign(attr, customAttr);\n    }\n\n    // if type = object, add items: { [key: string]: InputField }\n    if (t.schema.isObject(field)) {\n      return {\n        path,\n        props: attr,\n        schema: field,\n        set,\n        form: this,\n        required,\n        initialValue: context.store[key],\n        items: this.createProxyFromSchema(options, field, {\n          parent: key,\n          store: context.store,\n        }),\n      } as ObjectInputField<any>;\n    }\n\n    // if type = array, add items: InputField[]\n    if (t.schema.isArray(field)) {\n      return {\n        path,\n        props: attr,\n        schema: field,\n        set,\n        form: this,\n        required,\n        initialValue: context.store[key],\n        items: [], // <- will be populated dynamically in the UI\n      } as ArrayInputField<any>;\n    }\n\n    return {\n      path,\n      props: attr,\n      schema: field,\n      set,\n      form: this,\n      required,\n      initialValue: context.store[key],\n    };\n  }\n\n  /**\n   * Convert an input value to the correct type based on the schema.\n   * Handles raw DOM values (strings, booleans from checkboxes, Files, etc.)\n   */\n  protected getValueFromInput(input: any, schema: TSchema): any {\n    // Treat null/undefined as \"unset\" for every schema. Without this the\n    // string branch below stringifies them to \"null\"/\"undefined\" (and\n    // the date branches throw on `new Date(undefined)`), which then\n    // round-trips into controlled inputs as literal text — most\n    // visible after the Clear (X) affordance in Control sets\n    // value=undefined and the input promptly displays \"undefined\".\n    if (input === null || input === undefined) {\n      return undefined;\n    }\n    if (input instanceof File) {\n      // for file inputs, return the File object directly\n      if (t.schema.isString(schema) && schema.format === \"binary\") {\n        return input;\n      }\n      // for now, ignore other formats\n      return null;\n    }\n\n    if (t.schema.isBoolean(schema)) {\n      // Handle string representations from Select components (Yes/No dropdown)\n      if (input === \"true\") return true;\n      if (input === \"false\") return false;\n      if (input === \"\" || input === null || input === undefined)\n        return undefined;\n      // Handle actual boolean values\n      return !!input;\n    }\n\n    if (t.schema.isNumber(schema)) {\n      const num = Number(input);\n      return Number.isNaN(num) ? null : num;\n    }\n\n    if (t.schema.isString(schema)) {\n      if (schema.format === \"date\") {\n        return new Date(input).toISOString().slice(0, 10); // For date input\n      }\n      if (schema.format === \"time\") {\n        return new Date(`1970-01-01T${input}`).toISOString().slice(11, 16); // For time input\n      }\n      if (schema.format === \"date-time\") {\n        return new Date(input).toISOString(); // For datetime-local input\n      }\n      return String(input);\n    }\n\n    return input; // fallback for other types\n  }\n}\n\nexport type SchemaToInput<T extends TObject> = {\n  [K in keyof T[\"properties\"]]: InputField<T[\"properties\"][K]>;\n};\n\nexport interface FormEventLike {\n  preventDefault?: () => void;\n  stopPropagation?: () => void;\n}\n\nexport type InputField<T extends TSchema> = T extends TObject\n  ? ObjectInputField<T>\n  : T extends TArray<infer U>\n    ? ArrayInputField<U>\n    : BaseInputField;\n\nexport interface BaseInputField {\n  path: string;\n  required: boolean;\n  initialValue: any;\n  props: InputHTMLAttributesLike;\n  schema: TSchema;\n  set: (value: any) => void;\n  form: FormModel<any>;\n  items?: any;\n}\n\nexport interface ObjectInputField<T extends TObject> extends BaseInputField {\n  items: SchemaToInput<T>;\n}\n\nexport interface ArrayInputField<T extends TSchema> extends BaseInputField {\n  items: Array<InputField<T>>;\n}\n\nexport type InputHTMLAttributesLike = Pick<\n  InputHTMLAttributes<unknown>,\n  | \"id\"\n  | \"name\"\n  | \"type\"\n  | \"value\"\n  | \"required\"\n  | \"maxLength\"\n  | \"minLength\"\n  | \"aria-label\"\n> & {\n  value?: any;\n};\n\nexport type FormCtrlOptions<T extends TObject> = {\n  /**\n   * The schema defining the structure and validation rules for the form.\n   * This should be a TypeBox schema object.\n   */\n  schema: T;\n\n  /**\n   * Callback function to handle form submission.\n   * This function will receive the parsed and validated form values.\n   */\n  handler: (values: Static<T>) => unknown;\n\n  /**\n   * Optional initial values for the form fields.\n   * This can be used to pre-populate the form with existing data.\n   */\n  initialValues?: Partial<Static<T>>;\n\n  /**\n   * Optional function to create custom field attributes.\n   * This can be used to add custom validation, styles, or other attributes.\n   */\n  onCreateField?: (\n    name: keyof Static<T> & string,\n    schema: TSchema,\n  ) => InputHTMLAttributes<unknown>;\n\n  /**\n   * If defined, this will generate a unique ID for each field, prefixed with this string.\n   *\n   * > \"username\" with id=\"form-123\" will become \"form-123-username\".\n   *\n   * If omitted, IDs will not be generated.\n   */\n  id?: string;\n\n  onError?: (error: Error) => void;\n\n  onChange?: (key: string, value: any, store: Record<string, any>) => void;\n\n  onReset?: () => void;\n};\n","import type { TObject } from \"alepha\";\nimport { useAlepha } from \"alepha/react\";\nimport { useEffect, useId, useMemo, useRef } from \"react\";\nimport { type FormCtrlOptions, FormModel } from \"../services/FormModel.ts\";\n\n/**\n * Custom hook to create a form with validation and field management.\n * This hook uses TypeBox schemas to define the structure and validation rules for the form.\n * It provides a way to handle form submission, field creation, and value management.\n *\n * @example\n * ```tsx\n * import { t } from \"alepha\";\n *\n * const form = useForm({\n *   schema: t.object({\n *     username: t.text(),\n *     password: t.text(),\n *   }),\n *   handler: (values) => {\n *     console.log(\"Form submitted with values:\", values);\n *   },\n * });\n *\n * return (\n *   <form {...form.props}>\n *     <input {...form.input.username.props} />\n *     <input {...form.input.password.props} />\n *     <button type=\"submit\">Submit</button>\n *   </form>\n * );\n * ```\n */\n/**\n * Shallow / structural equality for form initial-value objects. Form values\n * are plain data (strings, numbers, arrays, plain objects) so JSON.stringify\n * is both fast enough and exact. Wrapped in try/catch to fall back to\n * reference equality if anything exotic sneaks in (e.g. circular refs).\n */\nconst stableEqual = (a: unknown, b: unknown): boolean => {\n  if (a === b) return true;\n  if (a == null || b == null) return false;\n  try {\n    return JSON.stringify(a) === JSON.stringify(b);\n  } catch {\n    return false;\n  }\n};\n\nexport const useForm = <T extends TObject>(\n  options: FormCtrlOptions<T>,\n  deps: any[] = [],\n): FormModel<T> => {\n  const alepha = useAlepha();\n  const formId = useId();\n  const initialValuesRef = useRef(options.initialValues);\n\n  const form = useMemo(() => {\n    return alepha.inject(FormModel<T>, {\n      lifetime: \"transient\",\n      args: [options.id || formId, options],\n    });\n  }, deps);\n\n  useEffect(() => {\n    // Reference inequality alone is unsafe: callers commonly build the\n    // `initialValues` object inline at the top of their render, which yields\n    // a fresh reference every commit. Reinitializing on every render wipes\n    // user-typed values via `setInitialValues` while leaving the DOM stale,\n    // producing the \"I filled the form but submit says it's empty\" bug.\n    //\n    // Deep-equality (JSON-compare) catches the common case where the inline\n    // literal is rebuilt with the same content. Callers who legitimately\n    // need to swap initial values mid-edit (e.g. editing quest A → quest B)\n    // still see a different JSON shape and trigger the reinit.\n    if (stableEqual(initialValuesRef.current, options.initialValues)) {\n      return;\n    }\n    initialValuesRef.current = options.initialValues;\n    if (options.initialValues) {\n      form.setInitialValues(options.initialValues as Record<string, any>);\n    }\n  }, [options.initialValues]);\n\n  return form;\n};\n","import type { TObject } from \"alepha\";\nimport { useAlepha } from \"alepha/react\";\nimport { useRouter, useRouterState } from \"alepha/react/router\";\nimport { useEffect, useRef } from \"react\";\nimport type { FormModel } from \"../services/FormModel.ts\";\n\nexport interface UseFormQuerySyncOptions<TKey extends string> {\n  /**\n   * Form field keys to mirror to/from the URL query. Fields not listed\n   * here stay local to the form and never leak into the address bar.\n   */\n  keys: readonly TKey[];\n}\n\n/**\n * Two-way bind a `useForm` instance to the URL query params, keyed\n * per-field (so the URL stays human-readable: `?status=new&zone=ops`).\n *\n * Direction 1 — URL → form:\n * - On mount AND every time one of the watched query keys changes\n *   (typically via browser back/forward or external `router.push`),\n *   call `form.input[key].set(value)` for each listed key. Missing /\n *   empty params clear the field (set to `undefined`).\n *\n * Direction 2 — form → URL:\n * - Subscribe to the form's `form:change` event for the listed keys.\n *   Each emission writes the current values for all listed keys to the\n *   URL via `router.setQueryParams` (replace-state, no history spam).\n *   Empty values (`undefined` / `\"\"`) are stripped from the URL so the\n *   address bar stays clean.\n *\n * Replaces ad-hoc `localStorage` filter persistence: the URL becomes\n * the canonical store, so the view is shareable via copy-paste and\n * navigable via back/forward.\n *\n * @example\n * const form = useForm({ schema: t.object({ status: t.string(), q: t.string() }) });\n * useFormQuerySync(form, { keys: [\"status\", \"q\"] });\n */\nexport const useFormQuerySync = <T extends TObject, TKey extends string>(\n  form: FormModel<T>,\n  options: UseFormQuerySyncOptions<TKey>,\n): void => {\n  const alepha = useAlepha();\n  const router = useRouter();\n  const state = useRouterState();\n  const keys = options.keys;\n\n  // URL → form. Recompute a stable signature of the watched slice of\n  // router.query so the effect fires precisely when it changes.\n  const querySig = keys\n    .map((k) => {\n      const raw = state.query?.[k];\n      return typeof raw === \"string\" ? raw : \"\";\n    })\n    .join(\"\u0000\");\n\n  // First-mount semantics differ from later URL changes: when the URL\n  // is empty AND the form has an initial value (e.g. status: \"new\"),\n  // preserve that initial value — and write it back to the URL so the\n  // URL becomes the source of truth from then on. Without this guard\n  // the mount would clear the form's defaults, defeating the whole\n  // \"default lane\" pattern.\n  const initialized = useRef(false);\n  useEffect(() => {\n    const isFirstRun = !initialized.current;\n    initialized.current = true;\n    const values = (form as unknown as { currentValues: Record<string, any> })\n      .currentValues;\n    const missingInitials: Record<string, string> = {};\n    for (const key of keys) {\n      const raw = state.query?.[key];\n      const next = typeof raw === \"string\" && raw !== \"\" ? raw : undefined;\n      const current = values[key];\n      if (\n        isFirstRun &&\n        next === undefined &&\n        current != null &&\n        current !== \"\"\n      ) {\n        // URL missing this key on first mount but the form has a\n        // default — keep the default, queue it to be written below.\n        missingInitials[key] = String(current);\n        continue;\n      }\n      // Skip when already in sync — avoids bouncing form:change ↔\n      // setQueryParams and re-triggering subscribers.\n      if ((current ?? undefined) !== next) {\n        const input = (form.input as Record<string, any>)[key];\n        if (input && typeof input.set === \"function\") {\n          input.set(next);\n        }\n      }\n    }\n    if (isFirstRun && Object.keys(missingInitials).length > 0) {\n      // Merge with whatever URL params ARE present so we don't clobber\n      // unrelated keys the page also uses.\n      const merged: Record<string, string> = {};\n      for (const key of keys) {\n        const raw = state.query?.[key];\n        if (typeof raw === \"string\" && raw !== \"\") {\n          merged[key] = raw;\n        }\n      }\n      for (const [k, v] of Object.entries(missingInitials)) {\n        merged[k] = v;\n      }\n      router.setQueryParams(merged);\n    }\n    // querySig is the meaningful trigger; form/keys/router are stable.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [querySig]);\n\n  // form → URL. Listen for changes on the watched keys only.\n  useEffect(() => {\n    if (!alepha.isBrowser()) return;\n    const off = alepha.events.on(\"form:change\", (e: any) => {\n      if (e.id !== form.id) return;\n      if (!keys.includes(e.path)) return;\n      const next: Record<string, string> = {};\n      const values = (form as unknown as { currentValues: Record<string, any> })\n        .currentValues;\n      for (const key of keys) {\n        const value = values[key];\n        if (value != null && value !== \"\") {\n          next[key] = String(value);\n        }\n      }\n      // Replace-state (default) — filters shouldn't pollute history.\n      router.setQueryParams(next);\n    });\n    return off;\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [alepha, form, router]);\n};\n","import type { TObject } from \"alepha\";\nimport { useAlepha } from \"alepha/react\";\nimport { useEffect, useState } from \"react\";\nimport type { FormModel } from \"../services/FormModel.ts\";\n\n/**\n * Hook to subscribe to all form values.\n * Re-renders on every field change — use only when needed (debug panels, live previews).\n */\nexport const useFormValues = <T extends TObject>(\n  form: FormModel<T>,\n): Record<string, any> => {\n  const alepha = useAlepha();\n  const [values, setValues] = useState<Record<string, any>>(form.currentValues);\n\n  useEffect(() => {\n    if (!alepha.isBrowser()) {\n      return;\n    }\n\n    return alepha.events.on(\"form:change\", (ev) => {\n      if (ev.id === form.id) {\n        setValues(form.currentValues);\n      }\n    });\n  }, []);\n\n  return values;\n};\n","/**\n * Converts a path or identifier string into a pretty display name.\n * For paths like \"/contacts/0/name\", extracts just the field name \"Name\".\n * Handles camelCase and snake_case conversion to Title Case.\n *\n * @example\n * prettyName(\"/userName\") // \"User Name\"\n * prettyName(\"/contacts/0/email\") // \"Email\"\n * prettyName(\"/address/streetName\") // \"Street Name\"\n * prettyName(\"first_name\") // \"First Name\"\n */\nexport const prettyName = (name: string): string => {\n  const segments = name.split(\"/\").filter((s) => s && !/^\\d+$/.test(s));\n  const fieldName = segments[segments.length - 1] || name.replaceAll(\"/\", \"\");\n  return fieldName\n    .replace(/([a-z])([A-Z])/g, \"$1 $2\")\n    .replace(/_/g, \" \")\n    .replace(/\\b\\w/g, (c) => c.toUpperCase());\n};\n","import { type TSchema, TypeBoxError } from \"alepha\";\nimport type { BaseInputField } from \"./FormModel.ts\";\nimport { prettyName } from \"./prettyName.ts\";\n\n/**\n * Semantic icon hint derived from schema metadata. UI layers map this\n * to their own icon set — this module is headless and ships no JSX.\n */\nexport type IconHint =\n  | \"email\"\n  | \"password\"\n  | \"phone\"\n  | \"url\"\n  | \"number\"\n  | \"calendar\"\n  | \"clock\"\n  | \"list\"\n  | \"text\"\n  | \"user\"\n  | \"file\"\n  | \"switch\";\n\nexport interface FieldConstraints {\n  minLength?: number;\n  maxLength?: number;\n  minimum?: number;\n  maximum?: number;\n  pattern?: string;\n}\n\nexport interface FieldMeta {\n  id?: string;\n  label: string;\n  description?: string;\n  error?: string;\n  required: boolean;\n  type?: string;\n  format?: string;\n  isEnum: boolean;\n  isArray: boolean;\n  isObject: boolean;\n  isArrayOfObjects: boolean;\n  enum?: readonly unknown[];\n  iconHint?: IconHint;\n  constraints: FieldConstraints;\n  testId?: string;\n  schema: TSchema;\n  /**\n   * Raw `$control` value from the schema, untyped here. The UI layer\n   * (`alepha/react/ui`) provides the strict {@link SchemaControl} type and\n   * a `resolveSchemaControl` helper to evaluate the function form.\n   */\n  control?: unknown;\n}\n\nexport interface ParseFieldOptions {\n  label?: string;\n  description?: string;\n  error?: Error;\n}\n\n/**\n * Derives a {@link FieldMeta} from an `InputField` (from `useForm`) plus\n * optional overrides. Pure — no React, no JSX, no UI library coupling.\n *\n * UI components consume this metadata to render labels, descriptions,\n * error messages, icons, and validation constraints.\n */\nexport const parseField = (\n  input: BaseInputField,\n  options: ParseFieldOptions = {},\n): FieldMeta => {\n  const schema = input.schema as TSchema & {\n    type?: string;\n    format?: string;\n    title?: string;\n    description?: string;\n    enum?: readonly unknown[];\n    minLength?: number;\n    maxLength?: number;\n    minimum?: number;\n    maximum?: number;\n    pattern?: string;\n    properties?: unknown;\n    items?: { properties?: unknown };\n    $control?: unknown;\n  };\n\n  const label =\n    options.label ??\n    (typeof schema.title === \"string\" ? schema.title : undefined) ??\n    prettyName(input.path);\n\n  const description =\n    options.description ??\n    (typeof schema.description === \"string\" ? schema.description : undefined);\n\n  const error =\n    options.error instanceof TypeBoxError\n      ? (options.error as TypeBoxError).value?.message\n      : undefined;\n\n  const type = schema.type;\n  const format = typeof schema.format === \"string\" ? schema.format : undefined;\n  const isEnum = Array.isArray(schema.enum);\n  const isArray = type === \"array\";\n  const isObject = type === \"object\" && Boolean(schema.properties);\n  const isArrayOfObjects =\n    isArray && Boolean(schema.items && (schema.items as any).properties);\n\n  const name = input.props.name;\n  const iconHint = inferIconHint({ type, format, name, isEnum, isArray });\n\n  const constraints: FieldConstraints = {};\n  if (typeof schema.minLength === \"number\")\n    constraints.minLength = schema.minLength;\n  if (typeof schema.maxLength === \"number\")\n    constraints.maxLength = schema.maxLength;\n  if (typeof schema.minimum === \"number\") constraints.minimum = schema.minimum;\n  if (typeof schema.maximum === \"number\") constraints.maximum = schema.maximum;\n  if (typeof schema.pattern === \"string\") constraints.pattern = schema.pattern;\n\n  return {\n    id: input.props.id,\n    label,\n    description,\n    error,\n    required: input.required,\n    type,\n    format,\n    isEnum,\n    isArray,\n    isObject,\n    isArrayOfObjects,\n    enum: schema.enum,\n    iconHint,\n    constraints,\n    testId: (input.props as Record<string, unknown>)[\"data-testid\"] as\n      | string\n      | undefined,\n    schema: input.schema,\n    control: schema.$control,\n  };\n};\n\nconst inferIconHint = (params: {\n  type?: string;\n  format?: string;\n  name?: string;\n  isEnum: boolean;\n  isArray: boolean;\n}): IconHint | undefined => {\n  const { type, format, name, isEnum, isArray } = params;\n\n  if (format === \"email\") return \"email\";\n  if (format === \"url\" || format === \"uri\") return \"url\";\n  if (format === \"tel\" || format === \"phone\") return \"phone\";\n  if (format === \"date\" || format === \"date-time\") return \"calendar\";\n  if (format === \"time\") return \"clock\";\n\n  if (name?.toLowerCase().includes(\"password\")) return \"password\";\n  if (name?.toLowerCase().includes(\"email\")) return \"email\";\n  if (name?.toLowerCase().includes(\"phone\")) return \"phone\";\n\n  if (type === \"boolean\") return \"switch\";\n  if (type === \"number\" || type === \"integer\") return \"number\";\n  if (isEnum || isArray) return \"list\";\n  if (type === \"string\") return \"text\";\n\n  return undefined;\n};\n","import { $module } from \"alepha\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport { default as FormState } from \"./components/FormState.tsx\";\nexport * from \"./errors/FormValidationError.ts\";\nexport * from \"./hooks/useFieldValue.ts\";\nexport * from \"./hooks/useForm.ts\";\nexport * from \"./hooks/useFormQuerySync.ts\";\nexport * from \"./hooks/useFormState.ts\";\nexport * from \"./hooks/useFormValues.ts\";\nexport * from \"./services/FormModel.ts\";\nexport * from \"./services/parseField.ts\";\nexport * from \"./services/prettyName.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\ndeclare module \"alepha\" {\n  interface Hooks {\n    \"form:change\": {\n      id: string;\n      path: string;\n      value: any;\n      /**\n       * Programmatic reset (e.g. `setInitialValues` after the parent updates\n       * its state). Subscribers tracking dirty state should ignore these.\n       */\n      initial?: boolean;\n    };\n    \"form:submit:begin\": { id: string };\n    \"form:submit:success\": { id: string; values: Record<string, any> };\n    \"form:submit:error\": { id: string; error: Error };\n    \"form:submit:end\": { id: string };\n    \"form:reset\": { id: string };\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Type-safe forms with validation.\n *\n * **Features:**\n * - Form state management\n * - TypeBox schema validation\n * - Field-level error handling\n * - Submit handling with loading state\n * - Form reset\n *\n * @module alepha.react.form\n */\nexport const AlephaReactForm = $module({\n  name: \"alepha.react.form\",\n});\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/react/form/hooks/useFormState.ts","../../../src/react/form/components/FormState.tsx","../../../src/react/form/errors/FormValidationError.ts","../../../src/react/form/hooks/useFieldValue.ts","../../../src/react/form/services/FormModel.ts","../../../src/react/form/hooks/useForm.ts","../../../src/react/form/hooks/useFormQuerySync.ts","../../../src/react/form/hooks/useFormValues.ts","../../../src/react/form/services/prettyName.ts","../../../src/react/form/services/parseField.ts","../../../src/react/form/index.ts"],"sourcesContent":["import { type TObject, TypeBoxError } from \"alepha\";\nimport { useAlepha } from \"alepha/react\";\nimport { useEffect, useState } from \"react\";\nimport type { FormModel } from \"../services/FormModel.ts\";\n\nexport interface UseFormStateReturn {\n  loading: boolean;\n  dirty: boolean;\n  values?: Record<string, any>;\n  error?: Error;\n}\n\nexport const useFormState = <\n  T extends TObject,\n  Keys extends keyof UseFormStateReturn,\n>(\n  target: FormModel<T> | { form: FormModel<T>; path: string },\n  _events: Keys[] = [\"loading\", \"dirty\", \"error\"] as Keys[],\n): Pick<UseFormStateReturn, Keys> => {\n  const alepha = useAlepha();\n  const events = _events as string[];\n\n  const [dirty, setDirty] = useState(false);\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<Error | undefined>(undefined);\n  const [values, setValues] = useState<Record<string, any> | undefined>(\n    undefined,\n  );\n\n  const form = \"form\" in target ? target.form : target;\n  const path = \"path\" in target ? target.path : undefined;\n\n  const hasValues = events.includes(\"values\");\n  const hasErrors = events.includes(\"error\");\n  const hasDirty = events.includes(\"dirty\");\n  const hasLoading = events.includes(\"loading\");\n\n  useEffect(() => {\n    const listeners: Function[] = [];\n\n    if (hasErrors || hasValues || hasDirty) {\n      listeners.push(\n        alepha.events.on(\"form:change\", (event) => {\n          if (event.id === form.id) {\n            if (!path || event.path === path) {\n              // `initial: true` marks a programmatic reset (e.g. parent\n              // re-rendering with fresh data via `setInitialValues`). Treat\n              // it like a reset: clear dirty, don't mark dirty.\n              if (hasDirty) {\n                if (event.initial) {\n                  setDirty(false);\n                } else {\n                  setDirty(true);\n                }\n              }\n              if (hasErrors) {\n                setError(undefined);\n              }\n            }\n            if (hasValues) {\n              setValues(form.currentValues);\n            }\n          }\n        }),\n      );\n    }\n\n    if (hasLoading) {\n      listeners.push(\n        alepha.events.on(\"form:submit:begin\", (event) => {\n          if (event.id === form.id) {\n            setLoading(true);\n          }\n        }),\n        alepha.events.on(\"form:submit:end\", (event) => {\n          if (event.id === form.id) {\n            setLoading(false);\n          }\n        }),\n      );\n    }\n\n    if (hasValues || hasDirty) {\n      listeners.push(\n        alepha.events.on(\"form:submit:success\", (event) => {\n          if (event.id === form.id) {\n            if (hasValues) {\n              setValues(event.values);\n            }\n            if (hasDirty) {\n              setDirty(false);\n            }\n          }\n        }),\n      );\n    }\n\n    if (hasDirty) {\n      listeners.push(\n        alepha.events.on(\"form:reset\", (event) => {\n          if (event.id === form.id) {\n            setDirty(false);\n          }\n        }),\n      );\n    }\n\n    if (hasErrors) {\n      listeners.push(\n        alepha.events.on(\"form:submit:error\", (event) => {\n          if (event.id === form.id) {\n            if (\n              !path ||\n              (event.error instanceof TypeBoxError &&\n                event.error.value.path === path)\n            ) {\n              setError(event.error);\n            }\n          }\n        }),\n      );\n    }\n\n    return () => {\n      for (const unsub of listeners) {\n        unsub();\n      }\n    };\n  }, []);\n\n  return {\n    dirty,\n    loading,\n    error,\n    values,\n  } as Pick<UseFormStateReturn, Keys>;\n};\n","import type { TObject } from \"alepha\";\nimport type { ReactNode } from \"react\";\nimport { useFormState } from \"../hooks/useFormState.ts\";\nimport type { FormModel } from \"../services/FormModel.ts\";\n\nconst FormState = <T extends TObject>(props: {\n  form: FormModel<T>;\n  children: (state: { loading: boolean; dirty: boolean }) => ReactNode;\n}) => {\n  const formState = useFormState(props.form);\n  return props.children({\n    loading: formState.loading,\n    dirty: formState.dirty,\n  });\n};\n\nexport default FormState;\n","import { TypeBoxError } from \"alepha\";\n\nexport class FormValidationError extends TypeBoxError {\n  readonly name = \"ValidationError\";\n\n  constructor(options: {\n    message: string;\n    path: string;\n  }) {\n    super({\n      message: options.message,\n      instancePath: options.path,\n      params: {},\n    });\n  }\n}\n","import { useAlepha } from \"alepha/react\";\nimport { useEffect, useState } from \"react\";\nimport type { BaseInputField } from \"../services/FormModel.ts\";\n\n/**\n * Hook to subscribe to a single form field's value.\n * Only re-renders when this specific field changes.\n *\n * @returns A tuple of [value, setValue] similar to useState.\n */\nexport const useFieldValue = (\n  input: BaseInputField,\n): [any, (value: any) => void] => {\n  const alepha = useAlepha();\n  const [value, setValue] = useState(input?.initialValue);\n\n  useEffect(() => {\n    if (!input?.form || !alepha.isBrowser()) {\n      return;\n    }\n\n    return alepha.events.on(\"form:change\", (ev) => {\n      if (ev.id === input.form.id && ev.path === input.path) {\n        setValue(ev.value);\n      }\n    });\n  }, []);\n\n  const setFieldValue = (newValue: any) => {\n    input.set(newValue);\n  };\n\n  return [value, setFieldValue];\n};\n","import type { TArray } from \"alepha\";\nimport {\n  $inject,\n  Alepha,\n  coerceObject,\n  type Static,\n  type TObject,\n  type TSchema,\n  z,\n} from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport type { InputHTMLAttributes } from \"react\";\n\n/**\n * FormModel is a dynamic form handler that generates form inputs based on a provided TypeBox schema.\n * It manages form state, handles input changes, and processes form submissions with validation.\n *\n * It means to be injected and used within React components to provide a structured way to create and manage forms.\n *\n * @see {@link useForm}\n */\nexport class FormModel<T extends TObject> {\n  protected readonly log = $logger();\n  protected readonly alepha = $inject(Alepha);\n  protected readonly values: Record<string, any> = {};\n  protected readonly initialValues: Record<string, any> = {};\n  protected submitInProgress = false;\n\n  public input: SchemaToInput<T>;\n\n  constructor(\n    public readonly id: string,\n    public readonly options: FormCtrlOptions<T>,\n  ) {\n    this.options = options;\n\n    // Initialize with schema defaults first, then override with initialValues\n    const schemaDefaults = this.extractSchemaDefaults(options.schema);\n    if (Object.keys(schemaDefaults).length > 0) {\n      Object.assign(this.values, schemaDefaults);\n    }\n\n    if (options.initialValues) {\n      // Decode against a partial of the schema so callers can supply incomplete\n      // initial values (the form's whole job is to collect them). Codecs still\n      // run on whatever's provided; missing fields stay undefined and only the\n      // full schema is enforced at submit time.\n      const decoded = this.alepha.codec.decode(\n        options.schema.partial(),\n        options.initialValues,\n      ) as Record<string, any>;\n      Object.assign(this.values, decoded);\n    }\n\n    this.initialValues = { ...this.values };\n\n    this.input = this.createProxyFromSchema(options, options.schema, {\n      store: this.values,\n      parent: \"\",\n    });\n  }\n\n  /**\n   * Extract default values from a zod object schema.\n   * Recursively handles nested objects, unwrapping optional/nullable/default.\n   */\n  protected extractSchemaDefaults(\n    schema: TObject,\n    prefix: string = \"\",\n  ): Record<string, any> {\n    const defaults: Record<string, any> = {};\n    const shape = (schema as any).shape as Record<string, any> | undefined;\n\n    if (!shape) {\n      return defaults;\n    }\n\n    for (const [key, propSchema] of Object.entries(shape)) {\n      const fullKey = prefix ? `${prefix}.${key}` : key;\n\n      // Unwrap optional / nullable / default wrappers to surface a default\n      // value and any nested object schema.\n      let inner: any = propSchema;\n      let defaultValue: unknown;\n      while (inner) {\n        if (z.schema.isDefault(inner)) {\n          const dv = inner._zod.def.defaultValue;\n          defaultValue = typeof dv === \"function\" ? dv() : dv;\n          break;\n        }\n        if (z.schema.isOptional(inner) || z.schema.isNullable(inner)) {\n          inner = inner.unwrap();\n          continue;\n        }\n        break;\n      }\n\n      if (defaultValue !== undefined) {\n        defaults[fullKey] = defaultValue;\n      } else if (z.schema.isObject(inner)) {\n        // Recursively extract defaults from nested objects\n        Object.assign(\n          defaults,\n          this.extractSchemaDefaults(inner as TObject, fullKey),\n        );\n      }\n    }\n\n    return defaults;\n  }\n\n  public get currentValues(): Record<string, any> {\n    return this.restructureValues(this.values);\n  }\n\n  public get props() {\n    return {\n      id: this.id,\n      noValidate: true,\n      onSubmit: (ev?: FormEventLike) => {\n        ev?.preventDefault?.();\n        this.submit();\n      },\n      onReset: (event: FormEventLike) => this.reset(event),\n    };\n  }\n\n  public readonly setInitialValues = (values: Record<string, any>) => {\n    // Same partial-decode rationale as the constructor — initial values may be\n    // incomplete; full schema is enforced only at submit time.\n    const decoded = this.alepha.codec.decode(\n      this.options.schema.partial(),\n      values,\n    ) as Record<string, any>;\n\n    // Snapshot the OLD keys before we wipe — without this, fields that\n    // had a value but are absent from the new initialValues never emit\n    // form:change and useFieldValue subscribers keep showing the stale\n    // value. Mirrors the union-of-keys pattern in reset() below.\n    const oldKeys = new Set(Object.keys(this.values));\n\n    for (const key in this.initialValues) {\n      delete (this.initialValues as Record<string, any>)[key];\n    }\n    Object.assign(this.initialValues, decoded);\n\n    for (const key in this.values) {\n      delete this.values[key];\n    }\n    Object.assign(this.values, { ...this.initialValues });\n\n    const keys = new Set<string>([...oldKeys, ...Object.keys(this.values)]);\n    for (const key of keys) {\n      const path = `/${key.replaceAll(\".\", \"/\")}`;\n      this.alepha.events.emit(\n        \"form:change\",\n        { id: this.id, path, value: this.values[key], initial: true },\n        { catch: true },\n      );\n    }\n  };\n\n  public readonly reset = (event?: FormEventLike) => {\n    event?.preventDefault?.();\n    // Snapshot all keys that need notification — both keys present\n    // before reset (so subscribers learn the cleared value) and keys\n    // restored from initialValues. Without the union, fields that were\n    // typed but absent from initialValues stay visually stale.\n    const keys = new Set<string>([\n      ...Object.keys(this.values),\n      ...Object.keys(this.initialValues),\n    ]);\n    for (const key in this.values) {\n      delete this.values[key];\n    }\n    Object.assign(this.values, { ...this.initialValues });\n    for (const key of keys) {\n      const path = `/${key.replaceAll(\".\", \"/\")}`;\n      this.alepha.events.emit(\n        \"form:change\",\n        { id: this.id, path, value: this.values[key] },\n        { catch: true },\n      );\n    }\n    this.alepha.events.emit(\"form:reset\", { id: this.id }, { catch: true });\n    this.options.onReset?.();\n  };\n\n  public readonly submit = async () => {\n    if (this.submitInProgress) {\n      this.log.warn(\n        \"Form submission already in progress, ignoring duplicate submit.\",\n      );\n      return;\n    }\n\n    // Lifecycle events are best-effort NOTIFICATIONS (loading spinners, toasts,\n    // analytics). A misbehaving listener must never break form state or reject\n    // submit() — hence `{ catch: true }` on every emit below. Without it, a\n    // throwing `react:action:error`/`form:submit:error` listener would skip the\n    // `form:submit:end` \"loading off\" signal and leave submit buttons stuck in\n    // their loading state forever.\n    await this.alepha.events.emit(\n      \"react:action:begin\",\n      { type: \"form\", id: this.id },\n      { catch: true },\n    );\n    await this.alepha.events.emit(\n      \"form:submit:begin\",\n      { id: this.id },\n      { catch: true },\n    );\n\n    this.submitInProgress = true;\n\n    const options = this.options;\n\n    try {\n      let values: Record<string, any> = this.restructureValues(this.values);\n\n      if (z.schema.isSchema(options.schema)) {\n        // HTML form controls produce strings; coerce them to the schema's\n        // scalar types (number/boolean) at this string boundary before strict\n        // decoding — otherwise a `z.number()` field would reject its \"42\" input.\n        values = this.alepha.codec.decode(\n          options.schema,\n          coerceObject(options.schema, values),\n        ) as Record<string, any>;\n      }\n\n      await options.handler(values as any);\n\n      await this.alepha.events.emit(\n        \"react:action:success\",\n        { type: \"form\", id: this.id },\n        { catch: true },\n      );\n      await this.alepha.events.emit(\n        \"form:submit:success\",\n        { id: this.id, values },\n        { catch: true },\n      );\n    } catch (error) {\n      this.log.error(\"Form submission error:\", error);\n\n      // A throwing onError callback must not abort the lifecycle either.\n      try {\n        options.onError?.(error as Error);\n      } catch (handlerError) {\n        this.log.error(\"Form onError handler threw:\", handlerError);\n      }\n\n      await this.alepha.events.emit(\n        \"react:action:error\",\n        { type: \"form\", id: this.id, error: error as Error },\n        { catch: true },\n      );\n      await this.alepha.events.emit(\n        \"form:submit:error\",\n        { error: error as Error, id: this.id },\n        { catch: true },\n      );\n    } finally {\n      this.submitInProgress = false;\n\n      // The \"loading off\" signals live in `finally` so they ALWAYS fire,\n      // even if something above threw — guaranteeing the begin/end pairing\n      // that drives submit-button loading state.\n      await this.alepha.events.emit(\n        \"react:action:end\",\n        { type: \"form\", id: this.id },\n        { catch: true },\n      );\n      await this.alepha.events.emit(\n        \"form:submit:end\",\n        { id: this.id },\n        { catch: true },\n      );\n    }\n  };\n\n  /**\n   * Restructures flat keys like \"address.city\" into nested objects like { address: { city: ... } }\n   * Values are already typed from onChange, so no conversion is needed.\n   */\n  protected restructureValues(store: Record<string, any>): Record<string, any> {\n    const values: Record<string, any> = {};\n\n    for (const [key, value] of Object.entries(store)) {\n      if (key.includes(\".\")) {\n        // nested object: restructure flat key to nested structure\n        this.restructureNestedValue(values, key, value);\n      } else {\n        // value is already typed, just copy it\n        values[key] = value;\n      }\n    }\n\n    return values;\n  }\n\n  /**\n   * Helper to restructure a flat key like \"address.city\" into nested object structure.\n   * The value is already typed, so we just assign it to the nested path.\n   */\n  protected restructureNestedValue(\n    values: Record<string, any>,\n    key: string,\n    value: any,\n  ) {\n    const pathSegments = key.split(\".\");\n    const finalPropertyKey = pathSegments.pop();\n    if (!finalPropertyKey) {\n      return;\n    }\n\n    let currentObjectLevel = values;\n\n    // traverse/create the nested structure\n    for (const segment of pathSegments) {\n      currentObjectLevel[segment] ??= {};\n      currentObjectLevel = currentObjectLevel[segment];\n    }\n\n    // value is already typed from onChange, just assign it\n    currentObjectLevel[finalPropertyKey] = value;\n  }\n\n  protected createProxyFromSchema<T extends TObject>(\n    options: FormCtrlOptions<T>,\n    schema: TSchema,\n    context: {\n      parent: string;\n      store: Record<string, any>;\n    },\n  ): SchemaToInput<T> {\n    const parent = context.parent || \"\";\n    return new Proxy<SchemaToInput<T>>({} as SchemaToInput<T>, {\n      get: (_, prop: string) => {\n        if (!options.schema || !z.schema.isObject(schema)) {\n          return {};\n        }\n\n        if (prop in schema.properties) {\n          // // it's a nested object, create another proxy\n          // if (z.schema.isObject(schema.properties[prop])) {\n          //   return this.createProxyFromSchema(\n          //     options,\n          //     schema.properties[prop],\n          //     {\n          //       parent: parent ? `${parent}.${prop}` : prop,\n          //       store: context.store,\n          //     },\n          //   );\n          // }\n\n          return this.createInputFromSchema<T>(\n            prop as keyof Static<T> & string,\n            options,\n            schema,\n            z.schema.requiredKeys(schema).includes(prop as string) || false,\n            context,\n          );\n        }\n      },\n    });\n  }\n\n  protected createInputFromSchema<T extends TObject>(\n    name: keyof Static<T> & string,\n    options: FormCtrlOptions<T>,\n    schema: TObject,\n    required: boolean,\n    context: {\n      parent: string;\n      store: Record<string, any>;\n    },\n  ): BaseInputField {\n    const parent = context.parent || \"\";\n    const rawField = schema.properties?.[name];\n    if (!rawField) {\n      return {\n        path: \"\",\n        required,\n        initialValue: undefined,\n        props: {} as InputHTMLAttributes<unknown>,\n        schema: schema,\n        set: () => {},\n        form: this,\n      };\n    }\n    // Peel optional/nullable/default wrappers so the structural guards below\n    // (`isObject`/`isArray`/`isString`/…, `.maxLength`, format) see the real\n    // schema. Optionality is tracked separately via `isRequired`/`required`.\n    const field = z.schema.unwrap(rawField) as typeof rawField;\n\n    const isRequired = z.schema.requiredKeys(schema).includes(name) ?? false;\n    const key = parent ? `${parent}.${name}` : name;\n    const path = `/${key.replaceAll(\".\", \"/\")}`;\n\n    const set = (value: any) => {\n      const typedValue = this.getValueFromInput(value, field);\n      context.store[key] = typedValue;\n      if (options.onChange) {\n        options.onChange(key, typedValue, context.store);\n      }\n      this.alepha.events.emit(\n        \"form:change\",\n        { id: this.id, path: path, value: typedValue },\n        { catch: true },\n      );\n    };\n\n    const attr: InputHTMLAttributesLike = {\n      name: key,\n    };\n\n    // Use the form's runtime id (always set — comes from `useId()` when\n    // no explicit `options.id` was provided). This guarantees stable\n    // per-field DOM ids without forcing callers to pass `id`.\n    attr.id = `${this.id}-${key}`;\n    (attr as any)[\"data-testid\"] = attr.id;\n\n    if (z.schema.isString(field)) {\n      if (field.maxLength != null) {\n        attr.maxLength = Number(field.maxLength);\n      }\n\n      if (field.minLength != null) {\n        attr.minLength = Number(field.minLength);\n      }\n    }\n\n    if (isRequired) {\n      attr.required = true;\n    }\n\n    if (\"description\" in field && typeof field.description === \"string\") {\n      attr[\"aria-label\"] = field.description;\n    }\n\n    if (z.schema.isInteger(field) || z.schema.isNumber(field)) {\n      attr.type = \"number\";\n    } else if (name === \"password\") {\n      attr.type = \"password\";\n    } else if (name === \"email\") {\n      attr.type = \"email\";\n    } else if (name === \"url\") {\n      attr.type = \"url\";\n    } else if (z.schema.isString(field)) {\n      if (z.schema.format(field) === \"binary\") {\n        attr.type = \"file\";\n      } else if (z.schema.format(field) === \"date\") {\n        attr.type = \"date\";\n      } else if (z.schema.format(field) === \"time\") {\n        attr.type = \"time\";\n      } else if (z.schema.format(field) === \"date-time\") {\n        attr.type = \"datetime-local\";\n      } else {\n        attr.type = \"text\";\n      }\n    } else if (z.schema.isBoolean(field)) {\n      attr.type = \"checkbox\";\n    }\n\n    if (options.onCreateField) {\n      const customAttr = options.onCreateField(name, field);\n      Object.assign(attr, customAttr);\n    }\n\n    // if type = object, add items: { [key: string]: InputField }\n    if (z.schema.isObject(field)) {\n      return {\n        path,\n        props: attr,\n        schema: field,\n        set,\n        form: this,\n        required,\n        initialValue: context.store[key],\n        items: this.createProxyFromSchema(options, field, {\n          parent: key,\n          store: context.store,\n        }),\n      } as ObjectInputField<any>;\n    }\n\n    // if type = array, add items: InputField[]\n    if (z.schema.isArray(field)) {\n      return {\n        path,\n        props: attr,\n        schema: field,\n        set,\n        form: this,\n        required,\n        initialValue: context.store[key],\n        items: [], // <- will be populated dynamically in the UI\n      } as ArrayInputField<any>;\n    }\n\n    return {\n      path,\n      props: attr,\n      schema: field,\n      set,\n      form: this,\n      required,\n      initialValue: context.store[key],\n    };\n  }\n\n  /**\n   * Convert an input value to the correct type based on the schema.\n   * Handles raw DOM values (strings, booleans from checkboxes, Files, etc.)\n   */\n  protected getValueFromInput(input: any, schema: TSchema): any {\n    // Treat null/undefined as \"unset\" for every schema. Without this the\n    // string branch below stringifies them to \"null\"/\"undefined\" (and\n    // the date branches throw on `new Date(undefined)`), which then\n    // round-trips into controlled inputs as literal text — most\n    // visible after the Clear (X) affordance in Control sets\n    // value=undefined and the input promptly displays \"undefined\".\n    if (input === null || input === undefined) {\n      return undefined;\n    }\n    if (input instanceof File) {\n      // for file inputs, return the File object directly\n      if (z.schema.isString(schema) && z.schema.format(schema) === \"binary\") {\n        return input;\n      }\n      // for now, ignore other formats\n      return null;\n    }\n\n    if (z.schema.isBoolean(schema)) {\n      // Handle string representations from Select components (Yes/No dropdown)\n      if (input === \"true\") return true;\n      if (input === \"false\") return false;\n      if (input === \"\" || input === null || input === undefined)\n        return undefined;\n      // Handle actual boolean values\n      return !!input;\n    }\n\n    if (z.schema.isNumber(schema)) {\n      const num = Number(input);\n      return Number.isNaN(num) ? null : num;\n    }\n\n    if (z.schema.isString(schema)) {\n      if (z.schema.format(schema) === \"date\") {\n        return new Date(input).toISOString().slice(0, 10); // For date input\n      }\n      if (z.schema.format(schema) === \"time\") {\n        return new Date(`1970-01-01T${input}`).toISOString().slice(11, 16); // For time input\n      }\n      if (z.schema.format(schema) === \"date-time\") {\n        return new Date(input).toISOString(); // For datetime-local input\n      }\n      return String(input);\n    }\n\n    return input; // fallback for other types\n  }\n}\n\nexport type SchemaToInput<T extends TObject> = {\n  [K in keyof T[\"properties\"]]: InputField<T[\"properties\"][K]>;\n};\n\nexport interface FormEventLike {\n  preventDefault?: () => void;\n  stopPropagation?: () => void;\n}\n\nexport type InputField<T extends TSchema> = T extends TObject\n  ? ObjectInputField<T>\n  : T extends TArray<infer U>\n    ? ArrayInputField<U>\n    : BaseInputField;\n\nexport interface BaseInputField {\n  path: string;\n  required: boolean;\n  initialValue: any;\n  props: InputHTMLAttributesLike;\n  schema: TSchema;\n  set: (value: any) => void;\n  form: FormModel<any>;\n  items?: any;\n}\n\nexport interface ObjectInputField<T extends TObject> extends BaseInputField {\n  items: SchemaToInput<T>;\n}\n\nexport interface ArrayInputField<T extends TSchema> extends BaseInputField {\n  items: Array<InputField<T>>;\n}\n\nexport type InputHTMLAttributesLike = Pick<\n  InputHTMLAttributes<unknown>,\n  | \"id\"\n  | \"name\"\n  | \"type\"\n  | \"value\"\n  | \"required\"\n  | \"maxLength\"\n  | \"minLength\"\n  | \"aria-label\"\n> & {\n  value?: any;\n};\n\nexport type FormCtrlOptions<T extends TObject> = {\n  /**\n   * The schema defining the structure and validation rules for the form.\n   * This should be a TypeBox schema object.\n   */\n  schema: T;\n\n  /**\n   * Callback function to handle form submission.\n   * This function will receive the parsed and validated form values.\n   */\n  handler: (values: Static<T>) => unknown;\n\n  /**\n   * Optional initial values for the form fields.\n   * This can be used to pre-populate the form with existing data.\n   */\n  initialValues?: Partial<Static<T>>;\n\n  /**\n   * Optional function to create custom field attributes.\n   * This can be used to add custom validation, styles, or other attributes.\n   */\n  onCreateField?: (\n    name: keyof Static<T> & string,\n    schema: TSchema,\n  ) => InputHTMLAttributes<unknown>;\n\n  /**\n   * If defined, this will generate a unique ID for each field, prefixed with this string.\n   *\n   * > \"username\" with id=\"form-123\" will become \"form-123-username\".\n   *\n   * If omitted, IDs will not be generated.\n   */\n  id?: string;\n\n  onError?: (error: Error) => void;\n\n  onChange?: (key: string, value: any, store: Record<string, any>) => void;\n\n  onReset?: () => void;\n};\n","import type { TObject } from \"alepha\";\nimport { useAlepha } from \"alepha/react\";\nimport { useEffect, useId, useMemo, useRef } from \"react\";\nimport { type FormCtrlOptions, FormModel } from \"../services/FormModel.ts\";\n\n/**\n * Custom hook to create a form with validation and field management.\n * This hook uses TypeBox schemas to define the structure and validation rules for the form.\n * It provides a way to handle form submission, field creation, and value management.\n *\n * @example\n * ```tsx\n * import { z } from \"alepha\";\n *\n * const form = useForm({\n *   schema: z.object({\n *     username: z.text(),\n *     password: z.text(),\n *   }),\n *   handler: (values) => {\n *     console.log(\"Form submitted with values:\", values);\n *   },\n * });\n *\n * return (\n *   <form {...form.props}>\n *     <input {...form.input.username.props} />\n *     <input {...form.input.password.props} />\n *     <button type=\"submit\">Submit</button>\n *   </form>\n * );\n * ```\n */\n/**\n * Shallow / structural equality for form initial-value objects. Form values\n * are plain data (strings, numbers, arrays, plain objects) so JSON.stringify\n * is both fast enough and exact. Wrapped in try/catch to fall back to\n * reference equality if anything exotic sneaks in (e.g. circular refs).\n */\nconst stableEqual = (a: unknown, b: unknown): boolean => {\n  if (a === b) return true;\n  if (a == null || b == null) return false;\n  try {\n    return JSON.stringify(a) === JSON.stringify(b);\n  } catch {\n    return false;\n  }\n};\n\nexport const useForm = <T extends TObject>(\n  options: FormCtrlOptions<T>,\n  deps: any[] = [],\n): FormModel<T> => {\n  const alepha = useAlepha();\n  const formId = useId();\n  const initialValuesRef = useRef(options.initialValues);\n\n  const form = useMemo(() => {\n    return alepha.inject(FormModel<T>, {\n      lifetime: \"transient\",\n      args: [options.id || formId, options],\n    });\n  }, deps);\n\n  // The model is memoized once, but callers' handlers close over\n  // render-scoped state (\"const [rows, setRows] = useState(...)\" then\n  // \"handler: () => onNext(rows)\"). Invoking the mount-time closure submits\n  // the INITIAL state — edits silently vanish. Keep the callbacks fresh on\n  // every commit so submit always sees the latest render's closures.\n  useEffect(() => {\n    Object.assign(form.options, {\n      handler: options.handler,\n      onError: options.onError,\n      onChange: options.onChange,\n      onReset: options.onReset,\n      onCreateField: options.onCreateField,\n    });\n  });\n\n  useEffect(() => {\n    // Reference inequality alone is unsafe: callers commonly build the\n    // `initialValues` object inline at the top of their render, which yields\n    // a fresh reference every commit. Reinitializing on every render wipes\n    // user-typed values via `setInitialValues` while leaving the DOM stale,\n    // producing the \"I filled the form but submit says it's empty\" bug.\n    //\n    // Deep-equality (JSON-compare) catches the common case where the inline\n    // literal is rebuilt with the same content. Callers who legitimately\n    // need to swap initial values mid-edit (e.g. editing quest A → quest B)\n    // still see a different JSON shape and trigger the reinit.\n    if (stableEqual(initialValuesRef.current, options.initialValues)) {\n      return;\n    }\n    initialValuesRef.current = options.initialValues;\n    if (options.initialValues) {\n      form.setInitialValues(options.initialValues as Record<string, any>);\n    }\n  }, [options.initialValues]);\n\n  return form;\n};\n","import type { TObject } from \"alepha\";\nimport { useAlepha } from \"alepha/react\";\nimport { useRouter, useRouterState } from \"alepha/react/router\";\nimport { useEffect, useRef } from \"react\";\nimport type { FormModel } from \"../services/FormModel.ts\";\n\nexport interface UseFormQuerySyncOptions<TKey extends string> {\n  /**\n   * Form field keys to mirror to/from the URL query. Fields not listed\n   * here stay local to the form and never leak into the address bar.\n   */\n  keys: readonly TKey[];\n}\n\n/**\n * Two-way bind a `useForm` instance to the URL query params, keyed\n * per-field (so the URL stays human-readable: `?status=new&zone=ops`).\n *\n * Direction 1 — URL → form:\n * - On mount AND every time one of the watched query keys changes\n *   (typically via browser back/forward or external `router.push`),\n *   call `form.input[key].set(value)` for each listed key. Missing /\n *   empty params clear the field (set to `undefined`).\n *\n * Direction 2 — form → URL:\n * - Subscribe to the form's `form:change` event for the listed keys.\n *   Each emission writes the current values for all listed keys to the\n *   URL via `router.setQueryParams` (replace-state, no history spam).\n *   Empty values (`undefined` / `\"\"`) are stripped from the URL so the\n *   address bar stays clean.\n *\n * Replaces ad-hoc `localStorage` filter persistence: the URL becomes\n * the canonical store, so the view is shareable via copy-paste and\n * navigable via back/forward.\n *\n * @example\n * const form = useForm({ schema: z.object({ status: z.string(), q: z.string() }) });\n * useFormQuerySync(form, { keys: [\"status\", \"q\"] });\n */\nexport const useFormQuerySync = <T extends TObject, TKey extends string>(\n  form: FormModel<T>,\n  options: UseFormQuerySyncOptions<TKey>,\n): void => {\n  const alepha = useAlepha();\n  const router = useRouter();\n  const state = useRouterState();\n  const keys = options.keys;\n\n  // URL → form. Recompute a stable signature of the watched slice of\n  // router.query so the effect fires precisely when it changes.\n  const querySig = keys\n    .map((k) => {\n      const raw = state.query?.[k];\n      return typeof raw === \"string\" ? raw : \"\";\n    })\n    .join(\"\u0000\");\n\n  // First-mount semantics differ from later URL changes: when the URL\n  // is empty AND the form has an initial value (e.g. status: \"new\"),\n  // preserve that initial value — and write it back to the URL so the\n  // URL becomes the source of truth from then on. Without this guard\n  // the mount would clear the form's defaults, defeating the whole\n  // \"default lane\" pattern.\n  const initialized = useRef(false);\n  useEffect(() => {\n    const isFirstRun = !initialized.current;\n    initialized.current = true;\n    const values = (form as unknown as { currentValues: Record<string, any> })\n      .currentValues;\n    const missingInitials: Record<string, string> = {};\n    for (const key of keys) {\n      const raw = state.query?.[key];\n      const next = typeof raw === \"string\" && raw !== \"\" ? raw : undefined;\n      const current = values[key];\n      if (\n        isFirstRun &&\n        next === undefined &&\n        current != null &&\n        current !== \"\"\n      ) {\n        // URL missing this key on first mount but the form has a\n        // default — keep the default, queue it to be written below.\n        missingInitials[key] = String(current);\n        continue;\n      }\n      // Skip when already in sync — avoids bouncing form:change ↔\n      // setQueryParams and re-triggering subscribers.\n      if ((current ?? undefined) !== next) {\n        const input = (form.input as Record<string, any>)[key];\n        if (input && typeof input.set === \"function\") {\n          input.set(next);\n        }\n      }\n    }\n    if (isFirstRun && Object.keys(missingInitials).length > 0) {\n      // Merge with whatever URL params ARE present so we don't clobber\n      // unrelated keys the page also uses.\n      const merged: Record<string, string> = {};\n      for (const key of keys) {\n        const raw = state.query?.[key];\n        if (typeof raw === \"string\" && raw !== \"\") {\n          merged[key] = raw;\n        }\n      }\n      for (const [k, v] of Object.entries(missingInitials)) {\n        merged[k] = v;\n      }\n      router.setQueryParams(merged);\n    }\n    // querySig is the meaningful trigger; form/keys/router are stable.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [querySig]);\n\n  // form → URL. Listen for changes on the watched keys only.\n  useEffect(() => {\n    if (!alepha.isBrowser()) return;\n    const off = alepha.events.on(\"form:change\", (e: any) => {\n      if (e.id !== form.id) return;\n      if (!keys.includes(e.path)) return;\n      const next: Record<string, string> = {};\n      const values = (form as unknown as { currentValues: Record<string, any> })\n        .currentValues;\n      for (const key of keys) {\n        const value = values[key];\n        if (value != null && value !== \"\") {\n          next[key] = String(value);\n        }\n      }\n      // Replace-state (default) — filters shouldn't pollute history.\n      router.setQueryParams(next);\n    });\n    return off;\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [alepha, form, router]);\n};\n","import type { TObject } from \"alepha\";\nimport { useAlepha } from \"alepha/react\";\nimport { useEffect, useState } from \"react\";\nimport type { FormModel } from \"../services/FormModel.ts\";\n\n/**\n * Hook to subscribe to all form values.\n * Re-renders on every field change — use only when needed (debug panels, live previews).\n */\nexport const useFormValues = <T extends TObject>(\n  form: FormModel<T>,\n): Record<string, any> => {\n  const alepha = useAlepha();\n  const [values, setValues] = useState<Record<string, any>>(form.currentValues);\n\n  useEffect(() => {\n    if (!alepha.isBrowser()) {\n      return;\n    }\n\n    return alepha.events.on(\"form:change\", (ev) => {\n      if (ev.id === form.id) {\n        setValues(form.currentValues);\n      }\n    });\n  }, []);\n\n  return values;\n};\n","/**\n * Converts a path or identifier string into a pretty display name.\n * For paths like \"/contacts/0/name\", extracts just the field name \"Name\".\n * Handles camelCase and snake_case conversion to Title Case.\n *\n * @example\n * prettyName(\"/userName\") // \"User Name\"\n * prettyName(\"/contacts/0/email\") // \"Email\"\n * prettyName(\"/address/streetName\") // \"Street Name\"\n * prettyName(\"first_name\") // \"First Name\"\n */\nexport const prettyName = (name: string): string => {\n  const segments = name.split(\"/\").filter((s) => s && !/^\\d+$/.test(s));\n  const fieldName = segments[segments.length - 1] || name.replaceAll(\"/\", \"\");\n  return fieldName\n    .replace(/([a-z])([A-Z])/g, \"$1 $2\")\n    .replace(/_/g, \" \")\n    .replace(/\\b\\w/g, (c) => c.toUpperCase());\n};\n","import { type TSchema, TypeBoxError, z } from \"alepha\";\nimport type { BaseInputField } from \"./FormModel.ts\";\nimport { prettyName } from \"./prettyName.ts\";\n\n/**\n * Semantic icon hint derived from schema metadata. UI layers map this\n * to their own icon set — this module is headless and ships no JSX.\n */\nexport type IconHint =\n  | \"email\"\n  | \"password\"\n  | \"phone\"\n  | \"url\"\n  | \"number\"\n  | \"calendar\"\n  | \"clock\"\n  | \"list\"\n  | \"text\"\n  | \"user\"\n  | \"file\"\n  | \"switch\";\n\nexport interface FieldConstraints {\n  minLength?: number;\n  maxLength?: number;\n  minimum?: number;\n  maximum?: number;\n  pattern?: string;\n}\n\nexport interface FieldMeta {\n  id?: string;\n  label: string;\n  description?: string;\n  error?: string;\n  required: boolean;\n  type?: string;\n  format?: string;\n  isEnum: boolean;\n  isArray: boolean;\n  isObject: boolean;\n  isArrayOfObjects: boolean;\n  enum?: readonly unknown[];\n  iconHint?: IconHint;\n  constraints: FieldConstraints;\n  testId?: string;\n  schema: TSchema;\n  /**\n   * Raw `$control` value from the schema, untyped here. The UI layer\n   * (`alepha/react/ui`) provides the strict {@link SchemaControl} type and\n   * a `resolveSchemaControl` helper to evaluate the function form.\n   */\n  control?: unknown;\n}\n\nexport interface ParseFieldOptions {\n  label?: string;\n  description?: string;\n  error?: Error;\n}\n\n/**\n * Derives a {@link FieldMeta} from an `InputField` (from `useForm`) plus\n * optional overrides. Pure — no React, no JSX, no UI library coupling.\n *\n * UI components consume this metadata to render labels, descriptions,\n * error messages, icons, and validation constraints.\n */\nexport const parseField = (\n  input: BaseInputField,\n  options: ParseFieldOptions = {},\n): FieldMeta => {\n  // Peel optional/nullable/default wrappers: structure, `.meta()`, format and\n  // constraints all live on the inner schema, not the wrapper. `required` is\n  // tracked separately via `input.required`.\n  const schema = z.schema.unwrap(input.schema) as TSchema & {\n    minLength?: number;\n    maxLength?: number;\n    minValue?: number;\n    maxValue?: number;\n  };\n\n  // Title / description / `$control` ride on zod's `.meta()` registry now\n  // (typebox kept them as plain schema properties). Read them from there.\n  const meta = (\n    typeof (schema as any).meta === \"function\" ? (schema as any).meta() : null\n  ) as Record<string, unknown> | null;\n\n  const label =\n    options.label ??\n    (typeof meta?.title === \"string\" ? meta.title : undefined) ??\n    prettyName(input.path);\n\n  const description =\n    options.description ??\n    (typeof meta?.description === \"string\" ? meta.description : undefined);\n\n  const error =\n    options.error instanceof TypeBoxError\n      ? (options.error as TypeBoxError).value?.message\n      : undefined;\n\n  // Structural classification via zod guards (the schema is a real zod schema,\n  // not a JSON-Schema object — `schema.type`/`schema.enum` no longer apply).\n  const isEnum = z.schema.isEnum(schema);\n  const isArray = z.schema.isArray(schema);\n  const isObject = z.schema.isObject(schema);\n  const isInteger = z.schema.isInteger(schema);\n  const isNumber = !isInteger && z.schema.isNumber(schema);\n  const isBoolean = z.schema.isBoolean(schema);\n  const type = isObject\n    ? \"object\"\n    : isArray\n      ? \"array\"\n      : isEnum\n        ? \"string\"\n        : isInteger\n          ? \"integer\"\n          : isNumber\n            ? \"number\"\n            : isBoolean\n              ? \"boolean\"\n              : z.schema.isString(schema)\n                ? \"string\"\n                : undefined;\n\n  const format =\n    typeof z.schema.format(schema) === \"string\"\n      ? z.schema.format(schema)\n      : undefined;\n  const element = (schema as any).element ?? (schema as any).items;\n  const isArrayOfObjects = isArray && z.schema.isObject(element);\n\n  const name = input.props.name;\n  const iconHint = inferIconHint({ type, format, name, isEnum, isArray });\n\n  const constraints: FieldConstraints = {};\n  if (typeof schema.minLength === \"number\")\n    constraints.minLength = schema.minLength;\n  if (typeof schema.maxLength === \"number\")\n    constraints.maxLength = schema.maxLength;\n  if (typeof schema.minValue === \"number\")\n    constraints.minimum = schema.minValue;\n  if (typeof schema.maxValue === \"number\")\n    constraints.maximum = schema.maxValue;\n  const pattern = readPattern(schema);\n  if (pattern) constraints.pattern = pattern;\n\n  return {\n    id: input.props.id,\n    label,\n    description,\n    error,\n    required: input.required,\n    type,\n    format,\n    isEnum,\n    isArray,\n    isObject,\n    isArrayOfObjects,\n    enum: isEnum ? z.schema.enumValues(schema) : undefined,\n    iconHint,\n    constraints,\n    testId: (input.props as Record<string, unknown>)[\"data-testid\"] as\n      | string\n      | undefined,\n    schema: input.schema,\n    control: meta?.$control,\n  };\n};\n\n/** Best-effort read of a `ZodString` regex pattern from its check list. */\nconst readPattern = (schema: unknown): string | undefined => {\n  const checks = (schema as any)?._zod?.def?.checks as\n    | Array<{ _zod?: { def?: { pattern?: RegExp; format?: string } } }>\n    | undefined;\n  if (!Array.isArray(checks)) return undefined;\n  for (const check of checks) {\n    const pattern = check?._zod?.def?.pattern;\n    if (pattern instanceof RegExp) return pattern.source;\n  }\n  return undefined;\n};\n\nconst inferIconHint = (params: {\n  type?: string;\n  format?: string;\n  name?: string;\n  isEnum: boolean;\n  isArray: boolean;\n}): IconHint | undefined => {\n  const { type, format, name, isEnum, isArray } = params;\n\n  if (format === \"email\") return \"email\";\n  if (format === \"url\" || format === \"uri\") return \"url\";\n  if (format === \"tel\" || format === \"phone\") return \"phone\";\n  if (format === \"date\" || format === \"date-time\") return \"calendar\";\n  if (format === \"time\") return \"clock\";\n\n  if (name?.toLowerCase().includes(\"password\")) return \"password\";\n  if (name?.toLowerCase().includes(\"email\")) return \"email\";\n  if (name?.toLowerCase().includes(\"phone\")) return \"phone\";\n\n  if (type === \"boolean\") return \"switch\";\n  if (type === \"number\" || type === \"integer\") return \"number\";\n  if (isEnum || isArray) return \"list\";\n  if (type === \"string\") return \"text\";\n\n  return undefined;\n};\n","import { $module } from \"alepha\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport { default as FormState } from \"./components/FormState.tsx\";\nexport * from \"./errors/FormValidationError.ts\";\nexport * from \"./hooks/useFieldValue.ts\";\nexport * from \"./hooks/useForm.ts\";\nexport * from \"./hooks/useFormQuerySync.ts\";\nexport * from \"./hooks/useFormState.ts\";\nexport * from \"./hooks/useFormValues.ts\";\nexport * from \"./services/FormModel.ts\";\nexport * from \"./services/parseField.ts\";\nexport * from \"./services/prettyName.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\ndeclare module \"alepha\" {\n  interface Hooks {\n    \"form:change\": {\n      id: string;\n      path: string;\n      value: any;\n      /**\n       * Programmatic reset (e.g. `setInitialValues` after the parent updates\n       * its state). Subscribers tracking dirty state should ignore these.\n       */\n      initial?: boolean;\n    };\n    \"form:submit:begin\": { id: string };\n    \"form:submit:success\": { id: string; values: Record<string, any> };\n    \"form:submit:error\": { id: string; error: Error };\n    \"form:submit:end\": { id: string };\n    \"form:reset\": { id: string };\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Type-safe forms with validation.\n *\n * **Features:**\n * - Form state management\n * - TypeBox schema validation\n * - Field-level error handling\n * - Submit handling with loading state\n * - Form reset\n *\n * @module alepha.react.form\n */\nexport const AlephaReactForm = $module({\n  name: \"alepha.react.form\",\n});\n"],"mappings":"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"}