@zeno-lib/forms 0.9.1 → 0.10.1

package/dist/create-zeno-form.d.mts

@@ -2,7 +2,6 @@ import { FieldControlProps } from "./lib/use-field-control.mjs";
 import { ValidationMode } from "./lib/validation-modes.mjs";
 import { AppFieldExtendedReactFieldGroupApi, AppFieldExtendedReactFormApi, BaseFormOptions, DeepKeys, DeepValue, FieldsMap, FormAsyncValidateOrFn, FormOptions, FormValidateOrFn, WithFormProps } from "@tanstack/react-form";
 import { ComponentProps, PropsWithChildren, ReactNode } from "react";
-//#region src/create-zeno-form.d.ts
 type StandardSchema<T> = {
   readonly "~standard": {
     readonly validate: (value: unknown) => unknown;
@@ -144,4 +143,4 @@ export declare function createZenoForm<FC extends Record<string, AnyComponent>,
     form: AppFieldExtendedReactFormApi<[unknown] extends [TFormData] ? any : TFormData, [FormValidateOrFn<TFormData> | undefined] extends [TOnMount] ? [TOnMount] extends [TOnMount & (FormValidateOrFn<TFormData> | undefined)] ? any : TOnMount : TOnMount, [FormValidateOrFn<TFormData> | undefined] extends [TOnChange] ? [TOnChange] extends [TOnChange & (FormValidateOrFn<TFormData> | undefined)] ? any : TOnChange : TOnChange, [FormValidateOrFn<TFormData> | undefined] extends [TOnChangeAsync] ? [TOnChangeAsync] extends [TOnChangeAsync & (FormValidateOrFn<TFormData> | undefined)] ? any : TOnChangeAsync : TOnChangeAsync, [FormValidateOrFn<TFormData> | undefined] extends [TOnBlur] ? [TOnBlur] extends [TOnBlur & (FormValidateOrFn<TFormData> | undefined)] ? any : TOnBlur : TOnBlur, [FormValidateOrFn<TFormData> | undefined] extends [TOnBlurAsync] ? [TOnBlurAsync] extends [TOnBlurAsync & (FormValidateOrFn<TFormData> | undefined)] ? any : TOnBlurAsync : TOnBlurAsync, [FormValidateOrFn<TFormData> | undefined] extends [TOnSubmit] ? [TOnSubmit] extends [TOnSubmit & (FormValidateOrFn<TFormData> | undefined)] ? any : TOnSubmit : TOnSubmit, [FormValidateOrFn<TFormData> | undefined] extends [TOnSubmitAsync] ? [TOnSubmitAsync] extends [TOnSubmitAsync & (FormValidateOrFn<TFormData> | undefined)] ? any : TOnSubmitAsync : TOnSubmitAsync, [FormValidateOrFn<TFormData> | undefined] extends [TOnDynamic] ? [TOnDynamic] extends [TOnDynamic & (FormValidateOrFn<TFormData> | undefined)] ? any : TOnDynamic : TOnDynamic, [FormValidateOrFn<TFormData> | undefined] extends [TOnDynamicAsync] ? [TOnDynamicAsync] extends [TOnDynamicAsync & (FormValidateOrFn<TFormData> | undefined)] ? any : TOnDynamicAsync : TOnDynamicAsync, [FormValidateOrFn<TFormData> | undefined] extends [TOnServer] ? [TOnServer] extends [TOnServer & (FormValidateOrFn<TFormData> | undefined)] ? any : TOnServer : TOnServer, [unknown] extends [TSubmitMeta] ? any : TSubmitMeta, [unknown] extends [FC] ? any : FC, [unknown] extends [FMC] ? any : FMC>;
   }>>;
 };
-//#endregion
+export {};

package/dist/create-zeno-form.mjs

@@ -15,7 +15,7 @@ import { blurThenChangeLogic } from "./lib/validation-logic.mjs";
 import { createFormHook } from "@tanstack/react-form";
 import { useMemo } from "react";
 import { jsx } from "react/jsx-runtime";
-//#region src/create-zeno-form.tsx
+// src/create-zeno-form.tsx
 function buildValidatorsFromSchema(schema, mode) {
 	switch (mode) {
 		case "blur": return { onBlur: schema };
@@ -191,5 +191,4 @@ function createZenoForm(config) {
 		withForm
 	};
 }
-//#endregion
 export { createZenoForm };

package/dist/form-element.d.mts

@@ -1,5 +1,4 @@
 import { ComponentProps, ReactNode } from "react";
-//#region src/form-element.d.ts
 type FormProviderProps = {
   children: ReactNode;
   /**
@@ -22,5 +21,4 @@ type FormProps = Omit<ComponentProps<"form">, "onSubmit"> & {
   disabled?: boolean;
 };
 declare function Form({ children, className, disabled, ...props }: FormProps): import("react").JSX.Element;
-//#endregion
 export { Form, FormProvider };

package/dist/form-element.mjs

@@ -5,7 +5,7 @@ import { reportSubmitError } from "./lib/submit-error.mjs";
 import { focusFirstInvalid, restoreFocus } from "./lib/focus-first-invalid.mjs";
 import { useMemo } from "react";
 import { jsx } from "react/jsx-runtime";
-//#region src/form-element.tsx
+// src/form-element.tsx
 function FormProvider({ children, disabled = false, form }) {
 	const { store } = form;
 	const scope = useMemo(() => ({
@@ -49,5 +49,4 @@ function Form({ children, className, disabled = false, ...props }) {
 		})
 	});
 }
-//#endregion
 export { Form, FormProvider };

package/dist/lib/action-result.d.mts

@@ -1,4 +1,3 @@
-//#region src/lib/action-result.d.ts
 type ActionError = {
   readonly fieldErrors: Readonly<Record<string, readonly string[]>>;
   readonly formErrors: readonly string[];
@@ -18,5 +17,4 @@ type ActionIssue = {
 };
 declare function toFieldName(path: ActionIssue["path"]): string;
 declare function toActionError(issues: readonly ActionIssue[]): ActionError;
-//#endregion
 export { type ActionError, type ActionIssue, type ActionResult, toActionError, toFieldName };

package/dist/lib/action-result.mjs

@@ -1,4 +1,4 @@
-//#region src/lib/action-result.ts
+// src/lib/action-result.ts
 function toFieldName(path) {
 	let name = "";
 	for (const segment of path ?? []) {
@@ -28,5 +28,4 @@ function toActionError(issues) {
 		formErrors
 	};
 }
-//#endregion
 export { toActionError, toFieldName };

package/dist/lib/apply-validation-error.d.mts

@@ -1,6 +1,4 @@
 import { ValidationError } from "./validation-error.mjs";
 import { AnyFormApi } from "@tanstack/react-form";
-//#region src/lib/apply-validation-error.d.ts
 declare function applyValidationError(formApi: AnyFormApi, error: ValidationError): void;
-//#endregion
 export { applyValidationError };

package/dist/lib/apply-validation-error.mjs

@@ -1,4 +1,4 @@
-//#region src/lib/apply-validation-error.ts
+// src/lib/apply-validation-error.ts
 function clearWhenEdited(formApi, name, entry) {
 	const rejected = formApi.getFieldValue(name);
 	const subscription = formApi.store.subscribe(() => {
@@ -37,5 +37,4 @@ function applyValidationError(formApi, error) {
 		form: error.formError
 	} });
 }
-//#endregion
 export { applyValidationError };

package/dist/lib/aria.d.mts

@@ -1,3 +1 @@
-//#region src/lib/aria.d.ts
-export declare function describedBy(...entries: [unknown, string][]): string | undefined;
-//#endregion
+export declare function describedBy(...entries: [unknown, string][]): string | undefined;

package/dist/lib/aria.mjs

@@ -1,7 +1,6 @@
-//#region src/lib/aria.ts
+// src/lib/aria.ts
 function describedBy(...entries) {
 	const ids = entries.filter(([show]) => Boolean(show)).map(([, id]) => id);
 	return ids.length > 0 ? ids.join(" ") : void 0;
 }
-//#endregion
 export { describedBy };

package/dist/lib/contexts.d.mts

@@ -1,5 +1,3 @@
-//#region src/lib/contexts.d.ts
 declare const fieldContext: import("react").Context<import("@tanstack/react-form").AnyFieldApi>, formContext: import("react").Context<import("@tanstack/react-form").AnyFormApi>, useFieldContext: <TData>() => import("@tanstack/react-form").FieldApi<any, string, TData, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any, any>, useFormContext: () => import("@tanstack/react-form").ReactFormExtendedApi<Record<string, never>, any, any, any, any, any, any, any, any, any, any, any>;
 export declare const FormProvider: import("react").Provider<import("@tanstack/react-form").AnyFormApi>;
-//#endregion
 export { fieldContext, formContext, useFieldContext, useFormContext };

package/dist/lib/contexts.mjs

@@ -1,7 +1,6 @@
 "use client";
 import { createFormHookContexts } from "@tanstack/react-form";
-//#region src/lib/contexts.ts
+// src/lib/contexts.ts
 const { fieldContext, formContext, useFieldContext, useFormContext } = createFormHookContexts();
 const FormProvider = formContext.Provider;
-//#endregion
 export { FormProvider, fieldContext, formContext, useFieldContext, useFormContext };

package/dist/lib/date-value.d.mts

@@ -1,4 +1,3 @@
-//#region src/lib/date-value.d.ts
 /**
  * What a date field stores for a picked day:
  * - `"date"`: a `Date`, at local midnight.
@@ -20,5 +19,4 @@ declare function parseDateValue(value: unknown): Date | undefined;
 declare function formatIsoDate(date: Date): string;
 /** The value to store for `date`, a day picked in local time. */
 declare function toDateValue(date: Date, type: DateValueType): Date | string;
-//#endregion
 export { type DateValueType, formatIsoDate, parseDateValue, toDateValue };

package/dist/lib/date-value.mjs

@@ -1,5 +1,5 @@
-//#region src/lib/date-value.ts
-const ISO_DATE = /^(\d{4})-(\d{2})-(\d{2})$/;
+// src/lib/date-value.ts
+const ISO_DATE = /^(\d{4})-(\d{2})-(\d{2})$/u;
 function pad(value, length) {
 	return String(value).padStart(length, "0");
 }
@@ -33,5 +33,4 @@ function toDateValue(date, type) {
 	if (type === "iso-datetime") return date.toISOString();
 	return date;
 }
-//#endregion
 export { formatIsoDate, parseDateValue, toDateValue };

package/dist/lib/default-props.d.mts

@@ -1,7 +1,5 @@
-//#region src/lib/default-props.d.ts
 /**
  * The props a component renders with: `props` over `defaults`. A prop passed
  * as `undefined` keeps its default, as a destructuring default would.
  */
-export declare function withDefaultProps<P extends object>(defaults: Partial<P> | undefined, props: P): P;
-//#endregion
+export declare function withDefaultProps<P extends object>(defaults: Partial<P> | undefined, props: P): P;

package/dist/lib/default-props.mjs

@@ -1,4 +1,4 @@
-//#region src/lib/default-props.ts
+// src/lib/default-props.ts
 /**
 * The props a component renders with: `props` over `defaults`. A prop passed
 * as `undefined` keeps its default, as a destructuring default would.
@@ -9,5 +9,4 @@ function withDefaultProps(defaults, props) {
 	for (const [key, value] of Object.entries(props)) if (value !== void 0) merged[key] = value;
 	return merged;
 }
-//#endregion
 export { withDefaultProps };

package/dist/lib/empty-value.d.mts

@@ -1,6 +1,6 @@
 import { StandardSchemaLike } from "./schema-required.mjs";
 import { AnyFieldApi } from "@tanstack/react-form";
-//#region src/lib/empty-value.d.ts
+declare function toPathKeys(name: string): PropertyKey[];
 declare function emptyValueFor(schema: StandardSchemaLike | undefined, values: unknown, name: string, fallback: unknown): unknown;
 declare function withEmptyStartValues(schema: StandardSchemaLike, defaults: Record<string, unknown>): Record<string, unknown>;
 /**
@@ -8,5 +8,11 @@ declare function withEmptyStartValues(schema: StandardSchemaLike, defaults: Reco
  * the field's value, since the same schema decides both.
  */
 declare function getEmptyValue<T>(field: AnyFieldApi, fallback: T): T;
-//#endregion
-export { emptyValueFor, getEmptyValue, withEmptyStartValues };
+/**
+ * What a text control stores once its text is cleared: `null` where the field
+ * starts at `null` (a nullable string), so it saves as none, and `""`
+ * otherwise. Read from the schema's shape rather than by validating the form,
+ * so the other fields' values never change it.
+ */
+declare function getNoTextValue(field: AnyFieldApi): string | null;
+export { emptyValueFor, getEmptyValue, getNoTextValue, toPathKeys, withEmptyStartValues };

package/dist/lib/empty-value.mjs

@@ -2,9 +2,9 @@ import { toFieldName } from "./action-result.mjs";
 import { extractZodDefaultAt } from "./schema-defaults.mjs";
 import { validateSync } from "./schema-required.mjs";
 import { getFormSchema } from "./validation-modes.mjs";
-//#region src/lib/empty-value.ts
-const NAME_SEGMENT = /[^.[\]]+/g;
-const INDEX = /^\d+$/;
+// src/lib/empty-value.ts
+const NAME_SEGMENT = /[^.[\]]+/gu;
+const INDEX = /^\d+$/u;
 function toPathKeys(name) {
 	return (name.match(NAME_SEGMENT) ?? []).map((part) => INDEX.test(part) ? Number(part) : part);
 }
@@ -88,5 +88,15 @@ function withEmptyStartValues(schema, defaults) {
 function getEmptyValue(field, fallback) {
 	return emptyValueFor(getFormSchema(field.form), field.form.state.values, field.name, fallback);
 }
-//#endregion
-export { emptyValueFor, getEmptyValue, withEmptyStartValues };
+/**
+* What a text control stores once its text is cleared: `null` where the field
+* starts at `null` (a nullable string), so it saves as none, and `""`
+* otherwise. Read from the schema's shape rather than by validating the form,
+* so the other fields' values never change it.
+*/
+function getNoTextValue(field) {
+	const schema = getFormSchema(field.form);
+	const start = schema ? extractZodDefaultAt(schema, toPathKeys(field.name)) : { ok: false };
+	return start.ok && start.value === null ? null : "";
+}
+export { emptyValueFor, getEmptyValue, getNoTextValue, toPathKeys, withEmptyStartValues };

package/dist/lib/field-hints.d.mts

@@ -0,0 +1,16 @@
+import { AnyFieldApi } from "@tanstack/react-form";
+/**
+ * What a field reads from the column its schema comes from, when the column's
+ * hint names it. The `percentage()` and `year()` columns of
+ * `@zeno-lib/db/schema` give one, so `PercentageField` and `YearField` show
+ * and clamp what the column accepts with no props: the scale from the hint,
+ * the bounds from the schema's own `.min()` and `.max()`, a caller's
+ * narrowing included. A prop the field is given wins.
+ */
+type FieldHints = {
+  readonly max?: number | undefined;
+  readonly min?: number | undefined;
+  readonly scale?: "fraction" | "percent" | undefined;
+};
+declare function getFieldHints(field: AnyFieldApi, kind: string): FieldHints;
+export { type FieldHints, getFieldHints };

package/dist/lib/field-hints.mjs

@@ -0,0 +1,23 @@
+import { findZodSchemaAt } from "./schema-defaults.mjs";
+import { getFormSchema } from "./validation-modes.mjs";
+import { toPathKeys } from "./empty-value.mjs";
+// src/lib/field-hints.ts
+const FIELD_HINTS_KEY = Symbol.for("@zeno-lib/field-hints");
+const readHint = (node) => {
+	const hint = globalThis[FIELD_HINTS_KEY]?.get(node);
+	return typeof hint?.field === "string" ? hint : void 0;
+};
+const toBound = (value) => typeof value === "number" && Number.isFinite(value) ? value : void 0;
+function getFieldHints(field, kind) {
+	const schema = getFormSchema(field.form);
+	const found = schema ? findZodSchemaAt(schema, toPathKeys(field.name), readHint) : void 0;
+	if (found?.value.field !== kind) return {};
+	const { scale } = found.value;
+	const { maxValue, minValue } = found.node;
+	return {
+		max: toBound(maxValue),
+		min: toBound(minValue),
+		scale: scale === "fraction" || scale === "percent" ? scale : void 0
+	};
+}
+export { getFieldHints };

package/dist/lib/focus-first-invalid.d.mts

@@ -1,4 +1,3 @@
-//#region src/lib/focus-first-invalid.d.ts
 /**
  * Move focus to the first invalid control inside `root` (a `<form>`): the
  * first element with `aria-invalid="true"`, or, for a group root that can't
@@ -19,5 +18,4 @@ declare function focusFirstInvalid(root: ParentNode | null | undefined): HTMLEle
  * moved focus.
  */
 declare function restoreFocus(element: Element | null): boolean;
-//#endregion
 export { focusFirstInvalid, restoreFocus };

package/dist/lib/focus-first-invalid.mjs

@@ -1,4 +1,4 @@
-//#region src/lib/focus-first-invalid.ts
+// src/lib/focus-first-invalid.ts
 /**
 * Move focus to the first invalid control inside `root` (a `<form>`): the
 * first element with `aria-invalid="true"`, or, for a group root that can't
@@ -33,5 +33,4 @@ function restoreFocus(element) {
 	element.focus({ preventScroll: true });
 	return element.ownerDocument.activeElement === element;
 }
-//#endregion
 export { focusFirstInvalid, restoreFocus };

package/dist/lib/form-disabled.d.mts

@@ -1,5 +1,4 @@
 import { AnyFormApi } from "@tanstack/react-form";
-//#region src/lib/form-disabled.d.ts
 /** Apply `useForm({ disabled })` to `form`. */
 declare function useDisabledOption(form: AnyFormApi, disabled: boolean): void;
 type FormDisabledScope = {
@@ -24,5 +23,4 @@ declare const FormDisabledContext: import("react").Context<FormDisabledScope | n
  * mounted.
  */
 declare function useIsFormDisabled(form?: AnyFormApi): boolean;
-//#endregion
 export { FormDisabledContext, useDisabledOption, useIsFormDisabled };

package/dist/lib/form-disabled.mjs

@@ -1,7 +1,7 @@
 "use client";
 import { formContext } from "./contexts.mjs";
 import { createContext, useCallback, useContext, useLayoutEffect, useSyncExternalStore } from "react";
-//#region src/lib/form-disabled.ts
+// src/lib/form-disabled.ts
 const disabledOption = /* @__PURE__ */ new WeakMap();
 const listeners = /* @__PURE__ */ new WeakMap();
 function subscribe(key, listener) {
@@ -50,5 +50,4 @@ function useIsFormDisabled(form) {
 	const byOption = useSyncExternalStore(subscribeToKey, getSnapshot, getSnapshot);
 	return scope?.disabled === true && (key === void 0 || scope.key === key) || byOption;
 }
-//#endregion
 export { FormDisabledContext, useDisabledOption, useIsFormDisabled };

package/dist/lib/formatted-number.d.mts

@@ -1,4 +1,3 @@
-//#region src/lib/formatted-number.d.ts
 type NumberSeparators = {
   /** Thousands separator, e.g. `’` for `de-CH`, `,` for `en-US`. */
   group: string;
@@ -52,5 +51,4 @@ declare function parseLocaleNumber(text: string, locale?: string): number | null
 declare function mapCaret(raw: string, caret: number, next: string, locale?: string): number;
 /** Round to `digits` decimals without the `1.005 → 1.00` float surprise. */
 declare function roundTo(value: number, digits: number): number;
-//#endregion
 export { type FormatNumberOptions, type NumberSeparators, type ParseTypedOptions, type TypedNumber, formatNumber, getNumberSeparators, mapCaret, parseLocaleNumber, parseTypedNumber, roundTo };

package/dist/lib/formatted-number.mjs

@@ -1,14 +1,14 @@
-//#region src/lib/formatted-number.ts
+// src/lib/formatted-number.ts
 const separatorCache = /* @__PURE__ */ new Map();
-const MINUS_SIGNS = /[-−–]/;
-const LEADING_MINUS = /^[^\d]*[-−–]/;
-const NON_DIGIT = /\D/g;
-const LEADING_ZEROS = /^0+(?=\d)/;
-const DIGIT = /\d/;
-const DIGITS = /\d/g;
-const PARENTHESIZED = /^\s*\(.*\)\s*$/;
-const NOT_NUMERIC = /[^\d.,]/g;
-const UNICODE_MINUS = /\u2212/g;
+const MINUS_SIGNS = /[-−–]/u;
+const LEADING_MINUS = /^[^\d]*[-−–]/u;
+const NON_DIGIT = /\D/gu;
+const LEADING_ZEROS = /^0+(?=\d)/u;
+const DIGIT = /\d/u;
+const DIGITS = /\d/gu;
+const PARENTHESIZED = /^\s*\(.*\)\s*$/u;
+const NOT_NUMERIC = /[^\d.,]/gu;
+const UNICODE_MINUS = /\u2212/gu;
 function getNumberSeparators(locale) {
 	const key = locale ?? "";
 	const cached = separatorCache.get(key);
@@ -134,5 +134,4 @@ function roundTo(value, digits) {
 	const rounded = Math.round((Math.abs(value) + Number.EPSILON) * factor);
 	return Math.sign(value) * rounded / factor;
 }
-//#endregion
 export { formatNumber, getNumberSeparators, mapCaret, parseLocaleNumber, parseTypedNumber, roundTo };

package/dist/lib/item-options.d.mts

@@ -1,4 +1,3 @@
-//#region src/lib/item-options.d.ts
 /** An item whose value isn't its label. */
 type ItemObject<V> = {
   value: V;
@@ -41,5 +40,4 @@ declare function toItemList<T>(items: readonly T[]): ItemList<T>;
 declare function isSameValue(a: unknown, b: unknown, isItemEqualToValue: ValueComparator | undefined): boolean;
 /** The option whose value is `value`, if `items` has it. */
 declare function findOption<T>(list: ItemList<T>, value: unknown, isItemEqualToValue: ValueComparator | undefined): ItemOption<T> | undefined;
-//#endregion
 export { type ItemGroup, type ItemList, type ItemObject, type ItemOption, type ItemValue, type ValueComparator, findOption, isItemGroup, isItemObject, isSameValue, itemLabel, itemValue, toItemList, valueKey };

package/dist/lib/item-options.mjs

@@ -1,4 +1,4 @@
-//#region src/lib/item-options.ts
+// src/lib/item-options.ts
 function isItemObject(item) {
 	return typeof item === "object" && item !== null && "value" in item && "label" in item;
 }
@@ -66,5 +66,4 @@ function findOption(list, value, isItemEqualToValue) {
 	if (hit !== void 0 && isSameValue(itemValue(hit), value, isItemEqualToValue)) return hit;
 	return list.options.find((option) => isSameValue(itemValue(option), value, isItemEqualToValue));
 }
-//#endregion
 export { findOption, isItemGroup, isItemObject, isSameValue, itemLabel, itemValue, toItemList, valueKey };

package/dist/lib/schema-defaults.d.mts

@@ -1,4 +1,3 @@
-//#region src/lib/schema-defaults.d.ts
 type SchemaNode = {
   readonly _zod?: {
     readonly def?: SchemaDef;
@@ -10,6 +9,7 @@ type SchemaDef = {
   readonly shape?: Record<string, SchemaNode>;
   readonly catchall?: SchemaNode;
   readonly in?: SchemaNode;
+  readonly out?: SchemaNode;
   readonly element?: SchemaNode;
   readonly defaultValue?: unknown;
 };
@@ -21,7 +21,10 @@ type ExtractResult = {
 };
 declare function extractZodDefaults(schema: SchemaNode): Record<string, unknown>;
 declare function extractZodDefaultAt(schema: SchemaNode, keys: readonly PropertyKey[]): ExtractResult;
+declare function findZodSchemaAt<T>(schema: SchemaNode, keys: readonly PropertyKey[], read: (node: SchemaNode) => T | undefined): {
+  node: SchemaNode;
+  value: T;
+} | undefined;
 declare function pickSchemaShape<T>(schema: SchemaNode, value: T): T;
 declare function deepMergeDefaults(schemaDefaults: Record<string, unknown>, userDefaults: Record<string, unknown> | undefined): Record<string, unknown>;
-//#endregion
-export { deepMergeDefaults, extractZodDefaultAt, extractZodDefaults, pickSchemaShape };
+export { deepMergeDefaults, extractZodDefaultAt, extractZodDefaults, findZodSchemaAt, pickSchemaShape };

package/dist/lib/schema-defaults.mjs

@@ -1,10 +1,11 @@
-//#region src/lib/schema-defaults.ts
+// src/lib/schema-defaults.ts
 const MAX_WRAPPER_DEPTH = 16;
 function getDef(node) {
 	return node?._zod?.def;
 }
 function extractDefaultForField(node) {
 	let current = node;
+	let isNullable = false;
 	for (let depth = 0; depth < MAX_WRAPPER_DEPTH; depth += 1) {
 		const def = getDef(current);
 		if (!def?.type) return { ok: false };
@@ -14,8 +15,11 @@ function extractDefaultForField(node) {
 				ok: true,
 				value: def.defaultValue
 			};
-			case "optional":
 			case "nullable":
+				isNullable = true;
+				current = def.innerType;
+				continue;
+			case "optional":
 			case "nonoptional":
 			case "readonly":
 				current = def.innerType;
@@ -25,7 +29,7 @@ function extractDefaultForField(node) {
 				continue;
 			case "string": return {
 				ok: true,
-				value: ""
+				value: isNullable ? null : ""
 			};
 			case "array": return {
 				ok: true,
@@ -89,6 +93,35 @@ function extractZodDefaultAt(schema, keys) {
 		return { ok: false };
 	}
 }
+function unwrapped(node) {
+	const def = getDef(node);
+	switch (def?.type) {
+		case "catch":
+		case "default":
+		case "nonoptional":
+		case "nullable":
+		case "optional":
+		case "prefault":
+		case "readonly": return def.innerType;
+		case "pipe": return getDef(def.in)?.type === "transform" ? def.out : def.in;
+		default: return;
+	}
+}
+function findZodSchemaAt(schema, keys, read) {
+	try {
+		let node = schema;
+		for (const key of keys) node = node && childAt(node, key);
+		let current = node && keys.length > 0 ? node : void 0;
+		for (let depth = 0; current && depth < MAX_WRAPPER_DEPTH; depth += 1) {
+			const value = read(current);
+			if (value !== void 0) return {
+				node: current,
+				value
+			};
+			current = unwrapped(current);
+		}
+	} catch {}
+}
 function isPlainObject(value) {
 	return typeof value === "object" && value !== null && Object.getPrototypeOf(value) === Object.prototype;
 }
@@ -145,5 +178,4 @@ function deepMergeDefaults(schemaDefaults, userDefaults) {
 	}
 	return result;
 }
-//#endregion
-export { deepMergeDefaults, extractZodDefaultAt, extractZodDefaults, pickSchemaShape };
+export { deepMergeDefaults, extractZodDefaultAt, extractZodDefaults, findZodSchemaAt, pickSchemaShape };

package/dist/lib/schema-required.d.mts

@@ -1,4 +1,3 @@
-//#region src/lib/schema-required.d.ts
 type PathPart = PropertyKey | {
   readonly key: PropertyKey;
 };
@@ -22,5 +21,4 @@ type StandardSchemaLike = {
 declare function toRequiredPathKey(name: string): string;
 declare function validateSync(schema: StandardSchemaLike, value: unknown): readonly StandardIssue[] | undefined;
 declare function getRequiredPaths(schema: StandardSchemaLike): Set<string>;
-//#endregion
 export { type StandardSchemaLike, getRequiredPaths, toRequiredPathKey, validateSync };

package/dist/lib/schema-required.mjs

@@ -1,7 +1,7 @@
-//#region src/lib/schema-required.ts
+// src/lib/schema-required.ts
 const MAX_PROBE_DEPTH = 16;
-const INDEX_SEGMENT = /^\d+$/;
-const INDEX_IN_NAME = /\[\d+\]|\.(\d+)(?=\.|\[|$)/g;
+const INDEX_SEGMENT = /^\d+$/u;
+const INDEX_IN_NAME = /\[\d+\]|\.\d+(?=\.|\[|$)/gu;
 function pathKey(part) {
 	if (typeof part === "object" && part !== null && "key" in part) return part.key;
 	return part;
@@ -134,5 +134,4 @@ function getRequiredPaths(schema) {
 	}
 	return required;
 }
-//#endregion
 export { getRequiredPaths, toRequiredPathKey, validateSync };

package/dist/lib/submit-action.d.mts

@@ -1,6 +1,5 @@
 import { ActionError, ActionIssue, ActionResult } from "./action-result.mjs";
 import { AnyFormApi } from "@tanstack/react-form";
-//#region src/lib/submit-action.d.ts
 declare function applyActionError(formApi: FormApiLike, error: ActionError): void;
 type SchemaResult<TOutput> = {
   readonly value: TOutput;
@@ -66,5 +65,4 @@ type SubmitActionSchemaOptions<TValues, TOutput, TData> = SubmitActionOptions<TV
  */
 declare function submitAction<TValues, TOutput, TData>(props: SubmitProps<TValues>, action: Action<TOutput, TData>, options: SubmitActionSchemaOptions<TValues, TOutput, TData>): Promise<ActionResult<TData>>;
 declare function submitAction<TValues, TData>(props: SubmitProps<TValues>, action: Action<NoInfer<TValues>, TData>, options?: SubmitActionOptions<TValues, TData>): Promise<ActionResult<TData>>;
-//#endregion
 export { type FormApiLike, type SubmitActionOptions, type SubmitActionSchema, applyActionError, submitAction };

package/dist/lib/submit-action.mjs

@@ -3,7 +3,7 @@ import { toActionError } from "./action-result.mjs";
 import { pickSchemaShape } from "./schema-defaults.mjs";
 import { getFormSchema } from "./validation-modes.mjs";
 import { ValidationError } from "./validation-error.mjs";
-//#region src/lib/submit-action.ts
+// src/lib/submit-action.ts
 function applyActionError(formApi, error) {
 	const fields = {};
 	const formErrors = [...error.formErrors];
@@ -46,5 +46,4 @@ function toFormValues(formApi, data) {
 	const schema = getFormSchema(formApi);
 	return schema ? pickSchemaShape(schema, data) : data;
 }
-//#endregion
 export { applyActionError, submitAction };

package/dist/lib/submit-error.d.mts

@@ -1,4 +1,3 @@
-//#region src/lib/submit-error.d.ts
 type SubmitErrorState = {
   readonly submissionAttempts: number;
   readonly values: unknown;
@@ -32,5 +31,4 @@ declare function setSubmitError(form: SubmitErrorForm, error: unknown): void;
 declare function reportSubmitError(error: unknown): void;
 /** The error `form`'s last submit threw, until it went stale. */
 declare function useSubmitError(form: SubmitErrorForm): SubmitError | undefined;
-//#endregion
 export { type SubmitError, type SubmitErrorForm, reportSubmitError, setSubmitError, useSubmitError };

package/dist/lib/submit-error.mjs

@@ -1,6 +1,6 @@
 "use client";
 import { useCallback, useSyncExternalStore } from "react";
-//#region src/lib/submit-error.ts
+// src/lib/submit-error.ts
 const entries = /* @__PURE__ */ new WeakMap();
 const listeners = /* @__PURE__ */ new WeakMap();
 function notify(key) {
@@ -62,5 +62,4 @@ function useSubmitError(form) {
 	}, [key]);
 	return useSyncExternalStore(subscribe, () => entries.get(key)?.submitError, () => void 0);
 }
-//#endregion
 export { reportSubmitError, setSubmitError, useSubmitError };

package/dist/lib/use-field-control.d.mts

@@ -1,6 +1,5 @@
 import { AnyFieldMeta } from "@tanstack/react-form";
 import { ReactNode } from "react";
-//#region src/lib/use-field-control.d.ts
 type UseFieldControlOptions = {
   /**
    * The description the field renders, if any. The control is described by
@@ -79,5 +78,4 @@ type FieldControl<TValue = unknown> = {
  * state its label, description and error need.
  */
 declare function useFieldControl<TValue = unknown>({ description, disabled, label, required }?: UseFieldControlOptions): FieldControl<TValue>;
-//#endregion
 export { type FieldControl, type FieldControlProps, type UseFieldControlOptions, useFieldControl };

package/dist/lib/use-field-control.mjs

@@ -6,7 +6,7 @@ import { useIsFormDisabled } from "./form-disabled.mjs";
 import { describedBy } from "./aria.mjs";
 import { useHideFieldErrors, useIsFieldRequired, useIsFieldRequiredBySchema, useIsInvalid } from "./use-is-invalid.mjs";
 import { useCallback, useId } from "react";
-//#region src/lib/use-field-control.ts
+// src/lib/use-field-control.ts
 function isEmpty(value) {
 	return value === null || value === void 0 || value === "" || Number.isNaN(value) || Array.isArray(value) && value.length === 0;
 }
@@ -66,5 +66,4 @@ function useFieldControl({ description, disabled, label, required } = {}) {
 		showRequiredIndicator: required ?? schemaRequired
 	};
 }
-//#endregion
 export { useFieldControl };

package/dist/lib/use-form-dialog.d.mts

@@ -1,4 +1,3 @@
-//#region src/lib/use-form-dialog.d.ts
 type FormDialogOpenOptions<TValues> = {
   /**
    * Values to edit in this session. Omit to start from the hook's
@@ -84,5 +83,4 @@ declare function useLeaveGuard({ hasUnsavedChanges, onSave }: UseLeaveGuardOptio
  * fields' ids come from `useId`), else that root's first focusable element.
  */
 declare function findFieldElement(root: ParentNode | null | undefined, name: string): HTMLElement | null;
-//#endregion
 export { type FormDialogController, type FormDialogOpenOptions, type LeaveGuard, type UseFormDialogOptions, type UseLeaveGuardOptions, findFieldElement, useFormDialog, useLeaveGuard };