@lobehub/ui 5.57.3 → 6.0.0-beta.1

package/es/FormKit/SubmitFooter.d.mts

@@ -0,0 +1,6 @@
+import { FormSubmitFooterProps } from "../Form/type.mjs";
+//#region src/FormKit/SubmitFooter.d.ts
+declare const SubmitFooter: import("react").NamedExoticComponent<FormSubmitFooterProps>;
+//#endregion
+export { SubmitFooter as default };
+//# sourceMappingURL=SubmitFooter.d.mts.map

package/es/FormKit/SubmitFooter.mjs

@@ -0,0 +1,36 @@
+"use client";
+import { FormContext } from "../Form/context.mjs";
+import FormSubmitFooter from "../Form/components/FormSubmitFooter.mjs";
+import { useFormKitContext } from "./context.mjs";
+import { getInternals } from "./instance.mjs";
+import { useStoreSelector } from "./useStoreSelector.mjs";
+import { memo, useMemo } from "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/FormKit/SubmitFooter.tsx
+const SubmitFooter = memo((props) => {
+	const { form, layout, variant } = useFormKitContext();
+	const { engine } = getInternals(form);
+	const status = useStoreSelector(engine, (e) => e.getStatus());
+	const legacyContext = useMemo(() => ({
+		hasUnsavedChanges: status.dirty,
+		layout,
+		requestReset: () => form.reset(),
+		submitLoading: status.submitting,
+		variant
+	}), [
+		form,
+		layout,
+		status.dirty,
+		status.submitting,
+		variant
+	]);
+	return /* @__PURE__ */ jsx(FormContext, {
+		value: legacyContext,
+		children: /* @__PURE__ */ jsx(FormSubmitFooter, { ...props })
+	});
+});
+SubmitFooter.displayName = "FormSubmitFooter";
+//#endregion
+export { SubmitFooter as default };
+
+//# sourceMappingURL=SubmitFooter.mjs.map

package/es/FormKit/SubmitFooter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubmitFooter.mjs","names":[],"sources":["../../src/FormKit/SubmitFooter.tsx"],"sourcesContent":["'use client';\n\nimport { memo, useMemo } from 'react';\n\nimport FormSubmitFooter from '../Form/components/FormSubmitFooter';\nimport { FormContext } from '../Form/context';\nimport type { FormSubmitFooterProps } from '../Form/type';\nimport { useFormKitContext } from './context';\nimport { getInternals } from './instance';\nimport { useStoreSelector } from './useStoreSelector';\n\nconst SubmitFooter = memo<FormSubmitFooterProps>((props) => {\n  const { form, layout, variant } = useFormKitContext();\n  const { engine } = getInternals(form);\n  const status = useStoreSelector(engine, (e) => e.getStatus());\n\n  const legacyContext = useMemo(\n    () => ({\n      hasUnsavedChanges: status.dirty,\n      layout,\n      requestReset: () => form.reset(),\n      submitLoading: status.submitting,\n      variant,\n    }),\n    [form, layout, status.dirty, status.submitting, variant],\n  );\n\n  return (\n    <FormContext value={legacyContext}>\n      <FormSubmitFooter {...props} />\n    </FormContext>\n  );\n});\n\nSubmitFooter.displayName = 'FormSubmitFooter';\n\nexport default SubmitFooter;\n"],"mappings":";;;;;;;;;AAWA,MAAM,eAAe,MAA6B,UAAU;CAC1D,MAAM,EAAE,MAAM,QAAQ,YAAY,kBAAkB;CACpD,MAAM,EAAE,WAAW,aAAa,IAAI;CACpC,MAAM,SAAS,iBAAiB,SAAS,MAAM,EAAE,UAAU,CAAC;CAE5D,MAAM,gBAAgB,eACb;EACL,mBAAmB,OAAO;EAC1B;EACA,oBAAoB,KAAK,MAAM;EAC/B,eAAe,OAAO;EACtB;CACF,IACA;EAAC;EAAM;EAAQ,OAAO;EAAO,OAAO;EAAY;CAAO,CACzD;CAEA,OACE,oBAAC,aAAD;EAAa,OAAO;EAClB,UAAA,oBAAC,kBAAD,EAAkB,GAAI,MAAQ,CAAA;CACnB,CAAA;AAEjB,CAAC;AAED,aAAa,cAAc"}

package/es/FormKit/binding.mjs

@@ -0,0 +1,23 @@
+//#region src/FormKit/binding.ts
+const isEventLike = (arg) => typeof arg === "object" && arg !== null && "target" in arg && typeof arg.target === "object" && arg.target !== null;
+const defaultGetValue = (arg) => {
+	if (!isEventLike(arg)) return arg;
+	const { target } = arg;
+	return target.type === "checkbox" || target.type === "radio" ? target.checked : target.value;
+};
+const resolveBinding = (child, override) => {
+	const { type } = child;
+	const declared = typeof type === "object" || typeof type === "function" ? type.formBinding : void 0;
+	const props = child.props;
+	const nativeCheckable = type === "input" && (props.type === "checkbox" || props.type === "radio");
+	return {
+		emptyValue: override.emptyValue ?? declared?.emptyValue,
+		getValue: override.getValue ?? declared?.getValue ?? defaultGetValue,
+		trigger: override.trigger ?? declared?.trigger ?? "onChange",
+		valueProp: override.valueProp ?? declared?.valueProp ?? (nativeCheckable ? "checked" : "value")
+	};
+};
+//#endregion
+export { defaultGetValue, resolveBinding };
+
+//# sourceMappingURL=binding.mjs.map

package/es/FormKit/binding.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding.mjs","names":[],"sources":["../../src/FormKit/binding.ts"],"sourcesContent":["import type { ReactElement } from 'react';\n\nimport type { FieldBinding } from './type';\n\nconst isEventLike = (arg: unknown): arg is { target: HTMLInputElement } =>\n  typeof arg === 'object' &&\n  arg !== null &&\n  'target' in arg &&\n  typeof (arg as { target: unknown }).target === 'object' &&\n  (arg as { target: unknown }).target !== null;\n\nexport const defaultGetValue = (arg: unknown) => {\n  if (!isEventLike(arg)) return arg;\n  const { target } = arg;\n  return target.type === 'checkbox' || target.type === 'radio' ? target.checked : target.value;\n};\n\nexport interface ResolvedBinding {\n  emptyValue: unknown;\n  getValue: (...args: any[]) => unknown;\n  trigger: string;\n  valueProp: string;\n}\n\nexport const resolveBinding = (child: ReactElement, override: FieldBinding): ResolvedBinding => {\n  const { type } = child;\n  const declared =\n    typeof type === 'object' || typeof type === 'function'\n      ? (type as { formBinding?: FieldBinding }).formBinding\n      : undefined;\n  const props = child.props as { type?: string };\n  const nativeCheckable = type === 'input' && (props.type === 'checkbox' || props.type === 'radio');\n\n  return {\n    emptyValue: override.emptyValue ?? declared?.emptyValue,\n    getValue: override.getValue ?? declared?.getValue ?? defaultGetValue,\n    trigger: override.trigger ?? declared?.trigger ?? 'onChange',\n    valueProp: override.valueProp ?? declared?.valueProp ?? (nativeCheckable ? 'checked' : 'value'),\n  };\n};\n"],"mappings":";AAIA,MAAM,eAAe,QACnB,OAAO,QAAQ,YACf,QAAQ,QACR,YAAY,OACZ,OAAQ,IAA4B,WAAW,YAC9C,IAA4B,WAAW;AAE1C,MAAa,mBAAmB,QAAiB;CAC/C,IAAI,CAAC,YAAY,GAAG,GAAG,OAAO;CAC9B,MAAM,EAAE,WAAW;CACnB,OAAO,OAAO,SAAS,cAAc,OAAO,SAAS,UAAU,OAAO,UAAU,OAAO;AACzF;AASA,MAAa,kBAAkB,OAAqB,aAA4C;CAC9F,MAAM,EAAE,SAAS;CACjB,MAAM,WACJ,OAAO,SAAS,YAAY,OAAO,SAAS,aACvC,KAAwC,cACzC,KAAA;CACN,MAAM,QAAQ,MAAM;CACpB,MAAM,kBAAkB,SAAS,YAAY,MAAM,SAAS,cAAc,MAAM,SAAS;CAEzF,OAAO;EACL,YAAY,SAAS,cAAc,UAAU;EAC7C,UAAU,SAAS,YAAY,UAAU,YAAY;EACrD,SAAS,SAAS,WAAW,UAAU,WAAW;EAClD,WAAW,SAAS,aAAa,UAAU,cAAc,kBAAkB,YAAY;CACzF;AACF"}

package/es/FormKit/context.d.mts

@@ -0,0 +1,6 @@
+import "../Form/type.mjs";
+import { FormInstance, FormValues } from "./type.mjs";
+//#region src/FormKit/context.d.ts
+export declare const useFormInstance: <T extends FormValues = FormValues>() => FormInstance<T>;
+//#endregion
+//# sourceMappingURL=context.d.mts.map

package/es/FormKit/context.mjs

@@ -0,0 +1,14 @@
+"use client";
+import { createContext, use } from "react";
+//#region src/FormKit/context.ts
+const FormKitContext = createContext(null);
+const useFormKitContext = () => {
+	const value = use(FormKitContext);
+	if (!value) throw new Error("[@lobehub/ui/form] Form.Field must be rendered inside <Form>");
+	return value;
+};
+const useFormInstance = () => useFormKitContext().form;
+//#endregion
+export { FormKitContext, useFormInstance, useFormKitContext };
+
+//# sourceMappingURL=context.mjs.map

package/es/FormKit/context.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.mjs","names":[],"sources":["../../src/FormKit/context.ts"],"sourcesContent":["'use client';\n\nimport { createContext, use } from 'react';\n\nimport type { FormLayout, FormVariant } from '../Form/type';\nimport type { FormInstance, FormValues } from './type';\n\nexport interface FormKitContextValue {\n  form: FormInstance<any>;\n  layout: FormLayout;\n  variant: FormVariant;\n}\n\nexport const FormKitContext = createContext<FormKitContextValue | null>(null);\n\nexport const useFormKitContext = () => {\n  const value = use(FormKitContext);\n  if (!value) throw new Error('[@lobehub/ui/form] Form.Field must be rendered inside <Form>');\n  return value;\n};\n\nexport const useFormInstance = <T extends FormValues = FormValues>() =>\n  useFormKitContext().form as FormInstance<T>;\n"],"mappings":";;;AAaA,MAAa,iBAAiB,cAA0C,IAAI;AAE5E,MAAa,0BAA0B;CACrC,MAAM,QAAQ,IAAI,cAAc;CAChC,IAAI,CAAC,OAAO,MAAM,IAAI,MAAM,8DAA8D;CAC1F,OAAO;AACT;AAEA,MAAa,wBACX,kBAAkB,CAAC,CAAC"}

package/es/FormKit/engine/tanstack.mjs

@@ -0,0 +1,293 @@
+import { FormApi, getBy, setBy } from "@tanstack/form-core";
+import isEqual from "fast-deep-equal";
+//#region src/FormKit/engine/tanstack.ts
+const toEnginePath = (path) => path.replaceAll(/\.(\d+)(?=\.|$)/g, "[$1]");
+const isSameOrNested = (a, b) => a === b || a.startsWith(`${b}.`) || b.startsWith(`${a}.`);
+const isUnder = (path, root) => path === root || path.startsWith(`${root}.`);
+const createTanstackEngine = (initialValues) => {
+	const form = new FormApi({ defaultValues: initialValues });
+	const fields = /* @__PURE__ */ new Map();
+	const fieldErrors = /* @__PURE__ */ new Map();
+	const formErrors = /* @__PURE__ */ new Map();
+	const serverErrors = /* @__PURE__ */ new Map();
+	const validating = /* @__PURE__ */ new Set();
+	const touched = /* @__PURE__ */ new Set();
+	const listeners = /* @__PURE__ */ new Set();
+	const valueListeners = /* @__PURE__ */ new Set();
+	const snapshots = /* @__PURE__ */ new Map();
+	let formValidator;
+	let baseline = initialValues;
+	let dirtyCache;
+	let inflightSubmit;
+	let submitting = false;
+	let submitCount = 0;
+	let status = {
+		dirty: false,
+		submitCount: 0,
+		submitting: false
+	};
+	const notify = () => {
+		for (const listener of listeners) listener();
+	};
+	const storeSubscription = form.store.subscribe(notify);
+	const getValue = (path) => form.getFieldValue(toEnginePath(path));
+	const getValues = () => form.state.values;
+	const isTouched = (path) => {
+		for (const entry of touched) if (isSameOrNested(entry, path)) return true;
+		return false;
+	};
+	const errorOf = (path) => serverErrors.get(path) ?? fieldErrors.get(path) ?? formErrors.get(path);
+	const getField = (path) => {
+		const next = {
+			error: errorOf(path),
+			touched: isTouched(path),
+			validating: validating.has(path),
+			value: getValue(path)
+		};
+		const prev = snapshots.get(path);
+		if (prev && prev.error === next.error && prev.touched === next.touched && prev.validating === next.validating && Object.is(prev.value, next.value)) return prev;
+		snapshots.set(path, next);
+		return next;
+	};
+	const getStatus = () => {
+		const values = getValues();
+		if (dirtyCache?.values !== values || dirtyCache.baseline !== baseline) dirtyCache = {
+			baseline,
+			dirty: !isEqual(values, baseline),
+			values
+		};
+		const { dirty } = dirtyCache;
+		if (status.dirty !== dirty || status.submitting !== submitting || status.submitCount !== submitCount) status = {
+			dirty,
+			submitCount,
+			submitting
+		};
+		return status;
+	};
+	const shouldValidate = (path, trigger) => {
+		const mode = fields.get(path)?.registration.validateOn ?? "auto";
+		if (trigger === "submit") return true;
+		if (mode === "change") return true;
+		if (mode === "blur") return trigger === "blur";
+		if (mode === "submit") return false;
+		return trigger === "blur" || errorOf(path) !== void 0;
+	};
+	const setOrDelete = (map, path, error) => {
+		if (error === void 0) map.delete(path);
+		else map.set(path, error);
+	};
+	const runField = (path, withFormValidator) => {
+		const runtime = fields.get(path);
+		if (!runtime) return Promise.resolve();
+		runtime.token += 1;
+		const token = runtime.token;
+		const { validate } = runtime.registration;
+		if (!validate && !(withFormValidator && formValidator)) return Promise.resolve();
+		validating.add(path);
+		notify();
+		return (async () => {
+			const values = getValues();
+			const [fieldError, formResult] = await Promise.all([validate?.(getValue(path), values), withFormValidator ? formValidator?.(values) : void 0]);
+			if (runtime.token !== token || fields.get(path) !== runtime) return;
+			setOrDelete(fieldErrors, path, fieldError);
+			if (withFormValidator) setOrDelete(formErrors, path, formResult?.[path]);
+			validating.delete(path);
+			notify();
+		})();
+	};
+	const schedule = (path, trigger) => {
+		const runtime = fields.get(path);
+		if (!runtime || !shouldValidate(path, trigger)) return;
+		clearTimeout(runtime.timer);
+		const debounceMs = runtime.registration.debounceMs ?? 0;
+		if (trigger === "change" && debounceMs > 0) {
+			runtime.token += 1;
+			runtime.timer = setTimeout(() => void runField(path, true), debounceMs);
+			return;
+		}
+		runField(path, true);
+	};
+	const clearErrorsUnder = (path, inclusive = false) => {
+		for (const map of [
+			fieldErrors,
+			formErrors,
+			serverErrors
+		]) for (const key of map.keys()) if (inclusive ? isUnder(key, path) : key.startsWith(`${path}.`)) map.delete(key);
+	};
+	const resetTo = (values) => {
+		clearRuntimeState();
+		baseline = values;
+		form.reset(values);
+		notify();
+	};
+	const emitValueChange = (path, source) => {
+		for (const listener of valueListeners) listener({
+			path,
+			source
+		});
+	};
+	const afterUserChange = (path) => {
+		touched.add(path);
+		serverErrors.delete(path);
+		schedule(path, "change");
+		for (const [other, runtime] of fields) if (other !== path && runtime.registration.deps?.includes(path) && isTouched(other)) runField(other, true);
+		notify();
+	};
+	const validate = async (paths) => {
+		const values = getValues();
+		const formResult = (formValidator ? await formValidator(values) : void 0) ?? {};
+		const targets = paths ?? [.../* @__PURE__ */ new Set([...fields.keys(), ...Object.keys(formResult)])];
+		await Promise.all(targets.map((path) => runField(path, false)));
+		for (const path of targets) setOrDelete(formErrors, path, formResult[path]);
+		notify();
+		const errors = {};
+		for (const path of targets) {
+			const error = errorOf(path);
+			if (error !== void 0) errors[path] = error;
+		}
+		return {
+			errors,
+			valid: Object.keys(errors).length === 0
+		};
+	};
+	const clearRuntimeState = () => {
+		for (const runtime of fields.values()) {
+			clearTimeout(runtime.timer);
+			runtime.token += 1;
+		}
+		fieldErrors.clear();
+		formErrors.clear();
+		serverErrors.clear();
+		validating.clear();
+		touched.clear();
+	};
+	const runSubmit = async (onSubmit) => {
+		submitCount += 1;
+		serverErrors.clear();
+		for (const path of fields.keys()) touched.add(path);
+		let values;
+		let result;
+		do {
+			values = getValues();
+			result = await validate();
+		} while (values !== getValues());
+		if (!result.valid) {
+			notify();
+			return result;
+		}
+		submitting = true;
+		notify();
+		try {
+			await onSubmit?.(values);
+			if (serverErrors.size > 0) return {
+				errors: Object.fromEntries(serverErrors),
+				valid: false
+			};
+			resetTo(getValues());
+		} finally {
+			submitting = false;
+			notify();
+		}
+		return result;
+	};
+	return {
+		blurField: (path) => {
+			touched.add(path);
+			schedule(path, "blur");
+			notify();
+		},
+		destroy: () => {
+			for (const runtime of fields.values()) clearTimeout(runtime.timer);
+			storeSubscription.unsubscribe();
+			listeners.clear();
+			valueListeners.clear();
+		},
+		getField,
+		getStatus,
+		getValue,
+		getValues,
+		isTouched,
+		moveItem: (path, from, to) => {
+			form.moveFieldValues(toEnginePath(path), from, to);
+			touched.add(path);
+			clearErrorsUnder(path);
+			emitValueChange(path, "user");
+			notify();
+		},
+		onValueChange: (listener) => {
+			valueListeners.add(listener);
+			return () => valueListeners.delete(listener);
+		},
+		pushItem: (path, item) => {
+			form.pushFieldValue(toEnginePath(path), item);
+			touched.add(path);
+			emitValueChange(path, "user");
+			notify();
+		},
+		registerField: (path, registration) => {
+			const runtime = {
+				registration,
+				token: 0
+			};
+			fields.set(path, runtime);
+			return () => {
+				if (fields.get(path) !== runtime) return;
+				clearTimeout(runtime.timer);
+				fields.delete(path);
+				fieldErrors.delete(path);
+				validating.delete(path);
+				snapshots.delete(path);
+				notify();
+			};
+		},
+		removeItem: (path, index) => {
+			form.removeFieldValue(toEnginePath(path), index);
+			touched.add(path);
+			clearErrorsUnder(path);
+			emitValueChange(path, "user");
+			notify();
+		},
+		reset: (values) => resetTo(values ?? baseline),
+		resetField: (path) => {
+			for (const [key, runtime] of fields) {
+				if (!isUnder(key, path)) continue;
+				clearTimeout(runtime.timer);
+				runtime.token += 1;
+				validating.delete(key);
+			}
+			for (const entry of touched) if (isUnder(entry, path)) touched.delete(entry);
+			clearErrorsUnder(path, true);
+			form.setFieldValue(toEnginePath(path), getBy(baseline, toEnginePath(path)), { dontUpdateMeta: true });
+			emitValueChange(path, "api");
+			notify();
+		},
+		setErrors: (errors) => {
+			for (const [path, error] of Object.entries(errors)) setOrDelete(serverErrors, path, error);
+			notify();
+		},
+		setFormValidator: (validator) => {
+			formValidator = validator;
+		},
+		setValue: (path, value, source) => {
+			form.setFieldValue(toEnginePath(path), value, { dontUpdateMeta: true });
+			if (source === "api") baseline = setBy(baseline, toEnginePath(path), () => value);
+			emitValueChange(path, source);
+			if (source === "user") afterUserChange(path);
+		},
+		submit: (onSubmit) => {
+			inflightSubmit ??= runSubmit(onSubmit).finally(() => {
+				inflightSubmit = void 0;
+			});
+			return inflightSubmit;
+		},
+		subscribe: (listener) => {
+			listeners.add(listener);
+			return () => listeners.delete(listener);
+		},
+		validate
+	};
+};
+//#endregion
+export { createTanstackEngine };
+
+//# sourceMappingURL=tanstack.mjs.map

package/es/FormKit/engine/tanstack.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tanstack.mjs","names":[],"sources":["../../../src/FormKit/engine/tanstack.ts"],"sourcesContent":["import { FormApi, getBy, setBy } from '@tanstack/form-core';\nimport isEqual from 'fast-deep-equal';\n\nimport type {\n  ChangeSource,\n  CreateEngine,\n  FieldRegistration,\n  FieldSnapshot,\n  FormEngine,\n  FormStatus,\n  FormValidator,\n  ValidateResult,\n  ValidateTrigger,\n  ValueChange,\n} from './types';\n\nconst toEnginePath = (path: string) => path.replaceAll(/\\.(\\d+)(?=\\.|$)/g, '[$1]');\n\nconst isSameOrNested = (a: string, b: string) =>\n  a === b || a.startsWith(`${b}.`) || b.startsWith(`${a}.`);\n\nconst isUnder = (path: string, root: string) => path === root || path.startsWith(`${root}.`);\n\ninterface FieldRuntime {\n  registration: FieldRegistration;\n  timer?: ReturnType<typeof setTimeout>;\n  token: number;\n}\n\nexport const createTanstackEngine: CreateEngine = (initialValues) => {\n  const form = new FormApi({ defaultValues: initialValues });\n\n  const fields = new Map<string, FieldRuntime>();\n  const fieldErrors = new Map<string, string>();\n  const formErrors = new Map<string, string>();\n  const serverErrors = new Map<string, string>();\n  const validating = new Set<string>();\n  const touched = new Set<string>();\n  const listeners = new Set<() => void>();\n  const valueListeners = new Set<(change: ValueChange) => void>();\n  const snapshots = new Map<string, FieldSnapshot>();\n\n  let formValidator: FormValidator | undefined;\n  let baseline = initialValues;\n  let dirtyCache: { baseline: unknown; dirty: boolean; values: unknown } | undefined;\n  let inflightSubmit: Promise<ValidateResult> | undefined;\n  let submitting = false;\n  let submitCount = 0;\n  let status: FormStatus = { dirty: false, submitCount: 0, submitting: false };\n\n  const notify = () => {\n    for (const listener of listeners) listener();\n  };\n  const storeSubscription = form.store.subscribe(notify);\n\n  const getValue = (path: string) => form.getFieldValue(toEnginePath(path) as never) as unknown;\n  const getValues = () => form.state.values as Record<string, unknown>;\n  const isTouched = (path: string) => {\n    for (const entry of touched) if (isSameOrNested(entry, path)) return true;\n    return false;\n  };\n  const errorOf = (path: string) =>\n    serverErrors.get(path) ?? fieldErrors.get(path) ?? formErrors.get(path);\n\n  const getField = (path: string): FieldSnapshot => {\n    const next: FieldSnapshot = {\n      error: errorOf(path),\n      touched: isTouched(path),\n      validating: validating.has(path),\n      value: getValue(path),\n    };\n    const prev = snapshots.get(path);\n    if (\n      prev &&\n      prev.error === next.error &&\n      prev.touched === next.touched &&\n      prev.validating === next.validating &&\n      Object.is(prev.value, next.value)\n    )\n      return prev;\n    snapshots.set(path, next);\n    return next;\n  };\n\n  const getStatus = (): FormStatus => {\n    const values = getValues();\n    if (dirtyCache?.values !== values || dirtyCache.baseline !== baseline)\n      dirtyCache = { baseline, dirty: !isEqual(values, baseline), values };\n    const { dirty } = dirtyCache;\n    if (\n      status.dirty !== dirty ||\n      status.submitting !== submitting ||\n      status.submitCount !== submitCount\n    )\n      status = { dirty, submitCount, submitting };\n    return status;\n  };\n\n  const shouldValidate = (path: string, trigger: ValidateTrigger) => {\n    const mode = fields.get(path)?.registration.validateOn ?? 'auto';\n    if (trigger === 'submit') return true;\n    if (mode === 'change') return true;\n    if (mode === 'blur') return trigger === 'blur';\n    if (mode === 'submit') return false;\n    return trigger === 'blur' || errorOf(path) !== undefined;\n  };\n\n  const setOrDelete = (map: Map<string, string>, path: string, error: string | undefined) => {\n    if (error === undefined) map.delete(path);\n    else map.set(path, error);\n  };\n\n  const runField = (path: string, withFormValidator: boolean): Promise<void> => {\n    const runtime = fields.get(path);\n    if (!runtime) return Promise.resolve();\n    runtime.token += 1;\n    const token = runtime.token;\n    const { validate } = runtime.registration;\n    if (!validate && !(withFormValidator && formValidator)) return Promise.resolve();\n\n    validating.add(path);\n    notify();\n    return (async () => {\n      const values = getValues();\n      const [fieldError, formResult] = await Promise.all([\n        validate?.(getValue(path), values),\n        withFormValidator ? formValidator?.(values) : undefined,\n      ]);\n      if (runtime.token !== token || fields.get(path) !== runtime) return;\n      setOrDelete(fieldErrors, path, fieldError);\n      if (withFormValidator) setOrDelete(formErrors, path, formResult?.[path]);\n      validating.delete(path);\n      notify();\n    })();\n  };\n\n  const schedule = (path: string, trigger: ValidateTrigger) => {\n    const runtime = fields.get(path);\n    if (!runtime || !shouldValidate(path, trigger)) return;\n    clearTimeout(runtime.timer);\n    const debounceMs = runtime.registration.debounceMs ?? 0;\n    if (trigger === 'change' && debounceMs > 0) {\n      runtime.token += 1;\n      runtime.timer = setTimeout(() => void runField(path, true), debounceMs);\n      return;\n    }\n    void runField(path, true);\n  };\n\n  const clearErrorsUnder = (path: string, inclusive = false) => {\n    for (const map of [fieldErrors, formErrors, serverErrors])\n      for (const key of map.keys())\n        if (inclusive ? isUnder(key, path) : key.startsWith(`${path}.`)) map.delete(key);\n  };\n\n  const resetTo = (values: Record<string, unknown>) => {\n    clearRuntimeState();\n    baseline = values;\n    form.reset(values);\n    notify();\n  };\n\n  const emitValueChange = (path: string, source: ChangeSource) => {\n    for (const listener of valueListeners) listener({ path, source });\n  };\n\n  const afterUserChange = (path: string) => {\n    touched.add(path);\n    serverErrors.delete(path);\n    schedule(path, 'change');\n    for (const [other, runtime] of fields) {\n      if (other !== path && runtime.registration.deps?.includes(path) && isTouched(other))\n        void runField(other, true);\n    }\n    notify();\n  };\n\n  const validate = async (paths?: string[]): Promise<ValidateResult> => {\n    const values = getValues();\n    const formResult = (formValidator ? await formValidator(values) : undefined) ?? {};\n    const targets = paths ?? [...new Set([...fields.keys(), ...Object.keys(formResult)])];\n    await Promise.all(targets.map((path) => runField(path, false)));\n    for (const path of targets) setOrDelete(formErrors, path, formResult[path]);\n    notify();\n    const errors: Record<string, string> = {};\n    for (const path of targets) {\n      const error = errorOf(path);\n      if (error !== undefined) errors[path] = error;\n    }\n    return { errors, valid: Object.keys(errors).length === 0 };\n  };\n\n  const clearRuntimeState = () => {\n    for (const runtime of fields.values()) {\n      clearTimeout(runtime.timer);\n      runtime.token += 1;\n    }\n    fieldErrors.clear();\n    formErrors.clear();\n    serverErrors.clear();\n    validating.clear();\n    touched.clear();\n  };\n\n  const runSubmit = async (onSubmit?: (values: Record<string, unknown>) => unknown) => {\n    submitCount += 1;\n    serverErrors.clear();\n    for (const path of fields.keys()) touched.add(path);\n    let values: Record<string, unknown>;\n    let result: ValidateResult;\n    do {\n      values = getValues();\n      result = await validate();\n      // Async validators must finish against unchanged values before submission.\n    } while (values !== getValues());\n    if (!result.valid) {\n      notify();\n      return result;\n    }\n    submitting = true;\n    notify();\n    try {\n      await onSubmit?.(values);\n      if (serverErrors.size > 0) return { errors: Object.fromEntries(serverErrors), valid: false };\n      resetTo(getValues());\n    } finally {\n      submitting = false;\n      notify();\n    }\n    return result;\n  };\n\n  const engine: FormEngine = {\n    blurField: (path) => {\n      touched.add(path);\n      schedule(path, 'blur');\n      notify();\n    },\n    destroy: () => {\n      for (const runtime of fields.values()) clearTimeout(runtime.timer);\n      storeSubscription.unsubscribe();\n      listeners.clear();\n      valueListeners.clear();\n    },\n    getField,\n    getStatus,\n    getValue,\n    getValues,\n    isTouched,\n    moveItem: (path, from, to) => {\n      form.moveFieldValues(toEnginePath(path) as never, from, to);\n      touched.add(path);\n      clearErrorsUnder(path);\n      emitValueChange(path, 'user');\n      notify();\n    },\n    onValueChange: (listener) => {\n      valueListeners.add(listener);\n      return () => valueListeners.delete(listener);\n    },\n    pushItem: (path, item) => {\n      form.pushFieldValue(toEnginePath(path) as never, item as never);\n      touched.add(path);\n      emitValueChange(path, 'user');\n      notify();\n    },\n    registerField: (path, registration) => {\n      const runtime: FieldRuntime = { registration, token: 0 };\n      fields.set(path, runtime);\n      return () => {\n        if (fields.get(path) !== runtime) return;\n        clearTimeout(runtime.timer);\n        fields.delete(path);\n        fieldErrors.delete(path);\n        validating.delete(path);\n        snapshots.delete(path);\n        notify();\n      };\n    },\n    removeItem: (path, index) => {\n      void form.removeFieldValue(toEnginePath(path) as never, index);\n      touched.add(path);\n      clearErrorsUnder(path);\n      emitValueChange(path, 'user');\n      notify();\n    },\n    reset: (values) => resetTo(values ?? baseline),\n    resetField: (path) => {\n      for (const [key, runtime] of fields) {\n        if (!isUnder(key, path)) continue;\n        clearTimeout(runtime.timer);\n        runtime.token += 1;\n        validating.delete(key);\n      }\n      for (const entry of touched) if (isUnder(entry, path)) touched.delete(entry);\n      clearErrorsUnder(path, true);\n      form.setFieldValue(toEnginePath(path) as never, getBy(baseline, toEnginePath(path)), {\n        dontUpdateMeta: true,\n      });\n      emitValueChange(path, 'api');\n      notify();\n    },\n    setErrors: (errors) => {\n      for (const [path, error] of Object.entries(errors)) setOrDelete(serverErrors, path, error);\n      notify();\n    },\n    setFormValidator: (validator) => {\n      formValidator = validator;\n    },\n    setValue: (path, value, source) => {\n      form.setFieldValue(toEnginePath(path) as never, value as never, { dontUpdateMeta: true });\n      if (source === 'api') baseline = setBy(baseline, toEnginePath(path), () => value);\n      emitValueChange(path, source);\n      if (source === 'user') afterUserChange(path);\n    },\n    submit: (onSubmit) => {\n      inflightSubmit ??= runSubmit(onSubmit).finally(() => {\n        inflightSubmit = undefined;\n      });\n      return inflightSubmit;\n    },\n    subscribe: (listener) => {\n      listeners.add(listener);\n      return () => listeners.delete(listener);\n    },\n    validate,\n  };\n\n  return engine;\n};\n"],"mappings":"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"}

package/es/FormKit/engine/types.d.mts

@@ -0,0 +1,5 @@
+//#region src/FormKit/engine/types.d.ts
+export type ValidateTrigger = 'change' | 'blur' | 'submit';
+export type ValidateOn = 'auto' | ValidateTrigger;
+//#endregion
+//# sourceMappingURL=types.d.mts.map

package/es/FormKit/index.d.mts

@@ -0,0 +1,30 @@
+import { FlexBasicProps } from "../Flex/type.mjs";
+import { FormDividerProps, FormFlatGroupProps, FormGroupProps, FormSubmitFooterProps, FormTitleProps } from "../Form/type.mjs";
+import "../index.mjs";
+import { FieldValidate, StandardSchema } from "./schema.mjs";
+import { DeepPartial, FieldBinding, FieldPath, FieldPathValue, FieldRenderProps, FormFieldProps, FormGroupItem, FormInstance, FormProps, FormValidateResult, FormValues, SetValueOptions, UseFormOptions } from "./type.mjs";
+import FormList, { FormListColumn, FormListField, FormListProps, FormListRenderProps } from "./List.mjs";
+import _default from "./Field.mjs";
+import SubmitFooter from "./SubmitFooter.mjs";
+import { useFormInstance } from "./context.mjs";
+import { useForm } from "./useForm.mjs";
+import { useWatch } from "./useWatch.mjs";
+//#region src/FormKit/index.d.ts
+export declare const Form: {
+  <T extends FormValues>({ activeKey, children, className, classNames, collapsible, defaultActiveKey, footer, form, gap, itemMinWidth, items, itemsType, layout, onCollapse, ref, style, styles: customStyles, variant, ...rest }: FormProps<T>): import("react").JSX.Element;
+  displayName: string;
+} & {
+  Divider: import("react").FC<FormDividerProps>;
+  Field: (<T extends FormValues = FormValues>(props: FormFieldProps<T>) => import("react").ReactNode) & {
+    displayName?: string;
+  };
+  FlatGroup: import("react").NamedExoticComponent<FormFlatGroupProps>;
+  Footer: import("react").FC<FlexBasicProps>;
+  Group: import("react").NamedExoticComponent<FormGroupProps>;
+  List: import("react").NamedExoticComponent<FormListProps>;
+  SubmitFooter: import("react").NamedExoticComponent<FormSubmitFooterProps>;
+  Title: import("react").FC<FormTitleProps>;
+};
+//#endregion
+export { type DeepPartial, type FieldBinding, type FieldPath, type FieldPathValue, type FieldRenderProps, type FieldValidate, Form as default, _default as FormField, type FormFieldProps, type FormGroupItem, type FormInstance, FormList, type FormListColumn, type FormListField, type FormListProps, type FormListRenderProps, type FormProps, SubmitFooter as FormSubmitFooter, type FormValidateResult, type FormValues, type SetValueOptions, type StandardSchema, type UseFormOptions, useForm, useFormInstance, useWatch };
+//# sourceMappingURL=index.d.mts.map

package/es/FormKit/index.mjs

@@ -0,0 +1,28 @@
+"use client";
+import FormDivider from "../Form/components/FormDivider.mjs";
+import FormTitle from "../Form/components/FormTitle.mjs";
+import FormFlatGroup from "../Form/components/FormFlatGroup.mjs";
+import FormFooter from "../Form/components/FormFooter.mjs";
+import FormGroup from "../Form/components/FormGroup.mjs";
+import { useFormInstance } from "./context.mjs";
+import FormField from "./Field.mjs";
+import Form$1 from "./Form.mjs";
+import FormList from "./List.mjs";
+import SubmitFooter from "./SubmitFooter.mjs";
+import { useForm } from "./useForm.mjs";
+import { useWatch } from "./useWatch.mjs";
+//#region src/FormKit/index.ts
+const Form = Object.assign(Form$1, {
+	Divider: FormDivider,
+	Field: FormField,
+	FlatGroup: FormFlatGroup,
+	Footer: FormFooter,
+	Group: FormGroup,
+	List: FormList,
+	SubmitFooter,
+	Title: FormTitle
+});
+//#endregion
+export { Form, Form as default, FormField, FormList, SubmitFooter as FormSubmitFooter, useForm, useFormInstance, useWatch };
+
+//# sourceMappingURL=index.mjs.map

package/es/FormKit/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["FormParent","FormSubmitFooter"],"sources":["../../src/FormKit/index.ts"],"sourcesContent":["'use client';\n\nimport FormDivider from '../Form/components/FormDivider';\nimport FormFlatGroup from '../Form/components/FormFlatGroup';\nimport FormFooter from '../Form/components/FormFooter';\nimport FormGroup from '../Form/components/FormGroup';\nimport FormTitle from '../Form/components/FormTitle';\nimport FormField from './Field';\nimport FormParent from './Form';\nimport FormList from './List';\nimport FormSubmitFooter from './SubmitFooter';\n\nexport const Form = Object.assign(FormParent, {\n  Divider: FormDivider,\n  Field: FormField,\n  FlatGroup: FormFlatGroup,\n  Footer: FormFooter,\n  Group: FormGroup,\n  List: FormList,\n  SubmitFooter: FormSubmitFooter,\n  Title: FormTitle,\n});\n\nexport { useFormInstance } from './context';\nexport type { FormListColumn, FormListField, FormListProps, FormListRenderProps } from './List';\nexport type {\n  DeepPartial,\n  FieldBinding,\n  FieldPath,\n  FieldPathValue,\n  FieldRenderProps,\n  FieldValidate,\n  FormFieldProps,\n  FormGroupItem,\n  FormInstance,\n  FormProps,\n  FormValidateResult,\n  FormValues,\n  SetValueOptions,\n  StandardSchema,\n  UseFormOptions,\n} from './type';\nexport { useForm } from './useForm';\nexport { useWatch } from './useWatch';\nexport { FormField, FormList, FormSubmitFooter };\n\nexport default Form;\n"],"mappings":";;;;;;;;;;;;;;AAYA,MAAa,OAAO,OAAO,OAAOA,QAAY;CAC5C,SAAS;CACT,OAAO;CACP,WAAW;CACX,QAAQ;CACR,OAAO;CACP,MAAM;CACQC;CACd,OAAO;AACT,CAAC"}

package/es/FormKit/instance.mjs

@@ -0,0 +1,67 @@
+import { createTanstackEngine } from "./engine/tanstack.mjs";
+import { schemaToFormValidator } from "./schema.mjs";
+//#region src/FormKit/instance.ts
+const internals = /* @__PURE__ */ new WeakMap();
+const getInternals = (form) => {
+	const found = internals.get(form);
+	if (!found) throw new Error("[@lobehub/ui/form] form was not created by useForm");
+	return found;
+};
+const isPlainObject = (value) => {
+	if (typeof value !== "object" || value === null) return false;
+	const proto = Object.getPrototypeOf(value);
+	return proto === Object.prototype || proto === null;
+};
+const leafPaths = (value, prefix = "") => {
+	if (!isPlainObject(value) || prefix && Object.keys(value).length === 0) return prefix ? [prefix] : [];
+	return Object.entries(value).flatMap(([key, child]) => leafPaths(child, prefix ? `${prefix}.${key}` : key));
+};
+const getIn = (value, path) => path.split(".").reduce((acc, key) => acc == null ? void 0 : acc[key], value);
+const setIn = (target, path, value) => {
+	const keys = path.split(".");
+	let cursor = target;
+	keys.slice(0, -1).forEach((key) => {
+		if (!isPlainObject(cursor[key])) cursor[key] = {};
+		cursor = cursor[key];
+	});
+	cursor[keys.at(-1)] = value;
+};
+const createFormInstance = ({ initialValues, schema, validateOn }) => {
+	const engine = createTanstackEngine(initialValues);
+	if (schema) engine.setFormValidator(schemaToFormValidator(schema));
+	const source = (options) => options?.asUser ? "user" : "api";
+	const form = {
+		getValue: ((name) => engine.getValue(name)),
+		getValues: () => engine.getValues(),
+		isDirty: () => engine.getStatus().dirty,
+		isTouched: (name) => engine.isTouched(name),
+		reset: (values) => engine.reset(values),
+		resetField: (name) => engine.resetField(name),
+		setErrors: (errors) => engine.setErrors(errors),
+		setSchema: (next) => engine.setFormValidator(next ? schemaToFormValidator(next) : void 0),
+		setValue: ((name, value, options) => engine.setValue(name, value, source(options))),
+		setValues: (values, options) => {
+			for (const path of leafPaths(values)) engine.setValue(path, getIn(values, path), source(options));
+		},
+		submit: () => engine.submit((values) => internals.get(form)?.onSubmit?.(values)),
+		subscribe: (selector, callback) => {
+			let selected = selector(engine.getValues());
+			return engine.subscribe(() => {
+				const next = selector(engine.getValues());
+				if (Object.is(next, selected)) return;
+				selected = next;
+				callback(next);
+			});
+		},
+		validate: (names) => engine.validate(names)
+	};
+	internals.set(form, {
+		engine,
+		validateOn
+	});
+	return form;
+};
+//#endregion
+export { createFormInstance, getIn, getInternals, leafPaths, setIn };
+
+//# sourceMappingURL=instance.mjs.map

package/es/FormKit/instance.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.mjs","names":[],"sources":["../../src/FormKit/instance.ts"],"sourcesContent":["import { createTanstackEngine } from './engine/tanstack';\nimport type { FormEngine, ValidateOn } from './engine/types';\nimport { schemaToFormValidator } from './schema';\nimport type { FormInstance, FormValues } from './type';\n\ninterface InstanceInternals {\n  engine: FormEngine;\n  onSubmit?: (values: FormValues) => unknown;\n  validateOn: ValidateOn;\n}\n\nconst internals = new WeakMap<object, InstanceInternals>();\n\nexport const getInternals = (form: object): InstanceInternals => {\n  const found = internals.get(form);\n  if (!found) throw new Error('[@lobehub/ui/form] form was not created by useForm');\n  return found;\n};\n\nconst isPlainObject = (value: unknown): value is Record<string, unknown> => {\n  if (typeof value !== 'object' || value === null) return false;\n  const proto = Object.getPrototypeOf(value);\n  return proto === Object.prototype || proto === null;\n};\n\nexport const leafPaths = (value: unknown, prefix = ''): string[] => {\n  if (!isPlainObject(value) || (prefix && Object.keys(value).length === 0))\n    return prefix ? [prefix] : [];\n  return Object.entries(value).flatMap(([key, child]) =>\n    leafPaths(child, prefix ? `${prefix}.${key}` : key),\n  );\n};\n\nexport const getIn = (value: unknown, path: string): unknown =>\n  path\n    .split('.')\n    .reduce<unknown>((acc, key) => (acc == null ? undefined : (acc as any)[key]), value);\n\nexport const setIn = (target: Record<string, unknown>, path: string, value: unknown) => {\n  const keys = path.split('.');\n  let cursor: Record<string, unknown> = target;\n  keys.slice(0, -1).forEach((key) => {\n    if (!isPlainObject(cursor[key])) cursor[key] = {};\n    cursor = cursor[key] as Record<string, unknown>;\n  });\n  cursor[keys.at(-1)!] = value;\n};\n\ninterface CreateOptions {\n  initialValues: FormValues;\n  schema?: Parameters<typeof schemaToFormValidator>[0];\n  validateOn: ValidateOn;\n}\n\nexport const createFormInstance = <T extends FormValues>({\n  initialValues,\n  schema,\n  validateOn,\n}: CreateOptions): FormInstance<T> => {\n  const engine = createTanstackEngine(initialValues);\n  if (schema) engine.setFormValidator(schemaToFormValidator(schema));\n  const source = (options?: { asUser?: boolean }) => (options?.asUser ? 'user' : 'api');\n\n  const form: FormInstance<T> = {\n    getValue: ((name: string) => engine.getValue(name)) as FormInstance<T>['getValue'],\n    getValues: () => engine.getValues() as T,\n    isDirty: () => engine.getStatus().dirty,\n    isTouched: (name) => engine.isTouched(name),\n    reset: (values) => engine.reset(values),\n    resetField: (name) => engine.resetField(name),\n    setErrors: (errors) => engine.setErrors(errors as Record<string, string | undefined>),\n    setSchema: (next) => engine.setFormValidator(next ? schemaToFormValidator(next) : undefined),\n    setValue: ((name: string, value: unknown, options?: { asUser?: boolean }) =>\n      engine.setValue(name, value, source(options))) as FormInstance<T>['setValue'],\n    setValues: (values, options) => {\n      for (const path of leafPaths(values))\n        engine.setValue(path, getIn(values, path), source(options));\n    },\n    submit: () =>\n      engine.submit((values) => internals.get(form)?.onSubmit?.(values)) as ReturnType<\n        FormInstance<T>['submit']\n      >,\n    subscribe: (selector, callback) => {\n      let selected = selector(engine.getValues() as T);\n      return engine.subscribe(() => {\n        const next = selector(engine.getValues() as T);\n        if (Object.is(next, selected)) return;\n        selected = next;\n        callback(next);\n      });\n    },\n    validate: (names) => engine.validate(names) as ReturnType<FormInstance<T>['validate']>,\n  };\n\n  internals.set(form, { engine, validateOn });\n  return form;\n};\n"],"mappings":";;;AAWA,MAAM,4BAAY,IAAI,QAAmC;AAEzD,MAAa,gBAAgB,SAAoC;CAC/D,MAAM,QAAQ,UAAU,IAAI,IAAI;CAChC,IAAI,CAAC,OAAO,MAAM,IAAI,MAAM,oDAAoD;CAChF,OAAO;AACT;AAEA,MAAM,iBAAiB,UAAqD;CAC1E,IAAI,OAAO,UAAU,YAAY,UAAU,MAAM,OAAO;CACxD,MAAM,QAAQ,OAAO,eAAe,KAAK;CACzC,OAAO,UAAU,OAAO,aAAa,UAAU;AACjD;AAEA,MAAa,aAAa,OAAgB,SAAS,OAAiB;CAClE,IAAI,CAAC,cAAc,KAAK,KAAM,UAAU,OAAO,KAAK,KAAK,CAAC,CAAC,WAAW,GACpE,OAAO,SAAS,CAAC,MAAM,IAAI,CAAC;CAC9B,OAAO,OAAO,QAAQ,KAAK,CAAC,CAAC,SAAS,CAAC,KAAK,WAC1C,UAAU,OAAO,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,CACpD;AACF;AAEA,MAAa,SAAS,OAAgB,SACpC,KACG,MAAM,GAAG,CAAC,CACV,QAAiB,KAAK,QAAS,OAAO,OAAO,KAAA,IAAa,IAAY,MAAO,KAAK;AAEvF,MAAa,SAAS,QAAiC,MAAc,UAAmB;CACtF,MAAM,OAAO,KAAK,MAAM,GAAG;CAC3B,IAAI,SAAkC;CACtC,KAAK,MAAM,GAAG,EAAE,CAAC,CAAC,SAAS,QAAQ;EACjC,IAAI,CAAC,cAAc,OAAO,IAAI,GAAG,OAAO,OAAO,CAAC;EAChD,SAAS,OAAO;CAClB,CAAC;CACD,OAAO,KAAK,GAAG,EAAE,KAAM;AACzB;AAQA,MAAa,sBAA4C,EACvD,eACA,QACA,iBACoC;CACpC,MAAM,SAAS,qBAAqB,aAAa;CACjD,IAAI,QAAQ,OAAO,iBAAiB,sBAAsB,MAAM,CAAC;CACjE,MAAM,UAAU,YAAoC,SAAS,SAAS,SAAS;CAE/E,MAAM,OAAwB;EAC5B,YAAY,SAAiB,OAAO,SAAS,IAAI;EACjD,iBAAiB,OAAO,UAAU;EAClC,eAAe,OAAO,UAAU,CAAC,CAAC;EAClC,YAAY,SAAS,OAAO,UAAU,IAAI;EAC1C,QAAQ,WAAW,OAAO,MAAM,MAAM;EACtC,aAAa,SAAS,OAAO,WAAW,IAAI;EAC5C,YAAY,WAAW,OAAO,UAAU,MAA4C;EACpF,YAAY,SAAS,OAAO,iBAAiB,OAAO,sBAAsB,IAAI,IAAI,KAAA,CAAS;EAC3F,YAAY,MAAc,OAAgB,YACxC,OAAO,SAAS,MAAM,OAAO,OAAO,OAAO,CAAC;EAC9C,YAAY,QAAQ,YAAY;GAC9B,KAAK,MAAM,QAAQ,UAAU,MAAM,GACjC,OAAO,SAAS,MAAM,MAAM,QAAQ,IAAI,GAAG,OAAO,OAAO,CAAC;EAC9D;EACA,cACE,OAAO,QAAQ,WAAW,UAAU,IAAI,IAAI,CAAC,EAAE,WAAW,MAAM,CAAC;EAGnE,YAAY,UAAU,aAAa;GACjC,IAAI,WAAW,SAAS,OAAO,UAAU,CAAM;GAC/C,OAAO,OAAO,gBAAgB;IAC5B,MAAM,OAAO,SAAS,OAAO,UAAU,CAAM;IAC7C,IAAI,OAAO,GAAG,MAAM,QAAQ,GAAG;IAC/B,WAAW;IACX,SAAS,IAAI;GACf,CAAC;EACH;EACA,WAAW,UAAU,OAAO,SAAS,KAAK;CAC5C;CAEA,UAAU,IAAI,MAAM;EAAE;EAAQ;CAAW,CAAC;CAC1C,OAAO;AACT"}

package/es/FormKit/schema.d.mts

@@ -0,0 +1,32 @@
+//#region src/FormKit/schema.d.ts
+export interface StandardSchemaIssue {
+  message: string;
+  path?: ReadonlyArray<PropertyKey | {
+    key: PropertyKey;
+  }>;
+}
+export interface StandardSchema<Input = unknown, Output = Input> {
+  readonly '~standard': {
+    readonly types?: {
+      readonly input: Input;
+      readonly output: Output;
+    };
+    readonly validate: (value: unknown) => {
+      readonly issues?: undefined;
+      readonly value: Output;
+    } | {
+      readonly issues: ReadonlyArray<StandardSchemaIssue>;
+    } | Promise<{
+      readonly issues?: undefined;
+      readonly value: Output;
+    } | {
+      readonly issues: ReadonlyArray<StandardSchemaIssue>;
+    }>;
+    readonly vendor: string;
+    readonly version: 1;
+  };
+}
+export type InferSchemaInput<S> = S extends StandardSchema<infer I, any> ? I : never;
+export type FieldValidate = StandardSchema | ((value: any, values: any) => string | undefined | Promise<string | undefined>);
+//#endregion
+//# sourceMappingURL=schema.d.mts.map

package/es/FormKit/schema.mjs

@@ -0,0 +1,23 @@
+//#region src/FormKit/schema.ts
+const isStandardSchema = (value) => typeof value === "object" && value !== null && "~standard" in value;
+const issuePath = (issue) => (issue.path ?? []).map((segment) => String(typeof segment === "object" ? segment.key : segment)).join(".");
+const schemaToFormValidator = (schema) => async (values) => {
+	const result = await schema["~standard"].validate(values);
+	if (!result.issues) return void 0;
+	const errors = {};
+	for (const issue of result.issues) {
+		const path = issuePath(issue);
+		if (errors[path] === void 0) errors[path] = issue.message;
+	}
+	return errors;
+};
+const toFieldValidator = (validate) => {
+	if (!isStandardSchema(validate)) return validate;
+	return async (value) => {
+		return (await validate["~standard"].validate(value)).issues?.[0]?.message;
+	};
+};
+//#endregion
+export { isStandardSchema, schemaToFormValidator, toFieldValidator };
+
+//# sourceMappingURL=schema.mjs.map