@neovici/cosmoz-form 2.4.0 → 2.5.0

package/dist/use-async-form-core.d.ts

@@ -1,8 +1,8 @@
 import type { AsyncItemRule } from './async-rule';
 import type { UseForm } from './use-form-core';
 /**
- * Composes with UseForm<T> to add async rules.
- * Returns UseForm<T> & { processing } where processing is true while any
+ * Composes with UseForm<T, C> to add async rules.
+ * Returns UseForm<T, C> & { processing } where processing is true while any
  * async rule is in flight.
  *
  * Async patches call onChange(patch, false) — they do not mark the form touched.
@@ -10,12 +10,12 @@ import type { UseForm } from './use-form-core';
  * patch — sync rules cascade on top of them, which is expected.
  *
  * Usage:
- *   const form = useValidatedForm({ fields, initial, rules });
+ *   const form = useValidatedForm({ fields, initial, rules, context });
  *   const { processing } = useAsyncFormCore(form, asyncRules);
  */
-export declare const useAsyncFormCore: <T extends object>(form: UseForm<T>, asyncRules: readonly AsyncItemRule<T>[] | undefined, opts?: {
-    onError?: (err: unknown, rule: AsyncItemRule<T>) => void;
-}) => UseForm<T> & {
+export declare const useAsyncFormCore: <T extends object, C extends object = object>(form: UseForm<T, C>, asyncRules: readonly AsyncItemRule<T, C>[] | undefined, opts?: {
+    onError?: (err: unknown, rule: AsyncItemRule<T, C>) => void;
+}) => UseForm<T, C> & {
     processing: boolean;
 };
 //# sourceMappingURL=use-async-form-core.d.ts.map

package/dist/use-async-form-core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-async-form-core.d.ts","sourceRoot":"","sources":["../src/use-async-form-core.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,cAAc,CAAC;AAE/D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAU/C;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,MAAM,EAChD,MAAM,OAAO,CAAC,CAAC,CAAC,EAChB,YAAY,SAAS,aAAa,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,EACnD,OAAO;IAAE,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,KAAK,IAAI,CAAA;CAAE,KACjE,OAAO,CAAC,CAAC,CAAC,GAAG;IAAE,UAAU,EAAE,OAAO,CAAA;CAkEpC,CAAC"}
+{"version":3,"file":"use-async-form-core.d.ts","sourceRoot":"","sources":["../src/use-async-form-core.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,cAAc,CAAC;AAE/D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAU/C;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,EAC3E,MAAM,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,EACnB,YAAY,SAAS,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,SAAS,EACtD,OAAO;IAAE,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,CAAA;CAAE,KACpE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG;IAAE,UAAU,EAAE,OAAO,CAAA;CAqEvC,CAAC"}

package/dist/use-async-form-core.js

@@ -6,8 +6,8 @@ const DEFAULT_ON_ERROR = (err) => {
     console.error('[cosmoz-form] async rule error:', err);
 };
 /**
- * Composes with UseForm<T> to add async rules.
- * Returns UseForm<T> & { processing } where processing is true while any
+ * Composes with UseForm<T, C> to add async rules.
+ * Returns UseForm<T, C> & { processing } where processing is true while any
  * async rule is in flight.
  *
  * Async patches call onChange(patch, false) — they do not mark the form touched.
@@ -15,7 +15,7 @@ const DEFAULT_ON_ERROR = (err) => {
  * patch — sync rules cascade on top of them, which is expected.
  *
  * Usage:
- *   const form = useValidatedForm({ fields, initial, rules });
+ *   const form = useValidatedForm({ fields, initial, rules, context });
  *   const { processing } = useAsyncFormCore(form, asyncRules);
  */
 export const useAsyncFormCore = (form, asyncRules, opts) => {
@@ -32,16 +32,17 @@ export const useAsyncFormCore = (form, asyncRules, opts) => {
         for (const runner of runnersRef.current.values())
             runner.cancel();
     }, []);
-    // Dep-check + rule dispatch: runs after every values change
+    // Dep-check + rule dispatch: runs after every values or context change
     useEffect(() => {
         if (!asyncRules?.length)
             return;
+        const context = form.context;
         for (const rule of asyncRules) {
             const [ruleFn, depsFn, runnerFactory = makeTakeLatestRunner] = rule;
             if (!runnersRef.current.has(rule)) {
                 runnersRef.current.set(rule, runnerFactory());
             }
-            const deps = depsFn(form.values);
+            const deps = depsFn(form.values, undefined, context);
             const prev = prevDepsRef.current.get(rule);
             // Skip if deps unchanged (Object.is per element, same as applyRules)
             if (prev != null && !changed(deps, prev)) {
@@ -53,7 +54,8 @@ export const useAsyncFormCore = (form, asyncRules, opts) => {
             if (pendingCount.current === 1)
                 setProcessing(true);
             runner
-                .run(ruleFn, form.values, (patch) => form.onChange(patch, false))
+                .run(ruleFn, form.values, (patch) => form.onChange(patch, false), // intermediate: no touch
+            { context })
                 .then((result) => {
                 if (result !== null) {
                     form.onChange(result, false); // final: no touch
@@ -66,6 +68,6 @@ export const useAsyncFormCore = (form, asyncRules, opts) => {
                     setProcessing(false);
             });
         }
-    }, [form.values]);
+    }, [form.values, form.context]);
     return { ...form, processing };
 };

package/dist/use-form-core.d.ts

@@ -1,7 +1,8 @@
 import { StateUpdater } from '@pionjs/pion';
 import { ItemRule } from './use-items/apply-rules';
-export interface UseForm<T extends object> {
+export interface UseForm<T extends object, C extends object = object> {
     values: T;
+    context: C;
     onReset: () => void;
     onValues: (valueOrFn: T | ((values: T) => T), touched?: boolean) => void;
     onChange: (update: Partial<T> | ((values: T) => Partial<T>), touched?: boolean) => void;
@@ -9,5 +10,5 @@ export interface UseForm<T extends object> {
     touched: boolean;
 }
 export type FormValues<T extends object> = readonly [T, T];
-export declare const useFormCore: <T extends object>(state: FormValues<T>, setState: StateUpdater<FormValues<T>>, rules?: readonly ItemRule<T>[]) => UseForm<T>;
+export declare const useFormCore: <T extends object, C extends object = object>(state: FormValues<T>, setState: StateUpdater<FormValues<T>>, rules?: readonly ItemRule<T, C>[], context?: C, externalTouched?: boolean) => UseForm<T, C>;
 //# sourceMappingURL=use-form-core.d.ts.map

package/dist/use-form-core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-form-core.d.ts","sourceRoot":"","sources":["../src/use-form-core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,YAAY,EAAE,MAAM,cAAc,CAAC;AAElE,OAAO,EAAc,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAG/D,MAAM,WAAW,OAAO,CAAC,CAAC,SAAS,MAAM;IACxC,MAAM,EAAE,CAAC,CAAC;IACV,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,QAAQ,EAAE,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACzE,QAAQ,EAAE,CACT,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,EAChD,OAAO,CAAC,EAAE,OAAO,KACb,IAAI,CAAC;IACV,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,aAAa,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC;IACzD,OAAO,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,MAAM,IAAI,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAE3D,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,MAAM,EAC3C,OAAO,UAAU,CAAC,CAAC,CAAC,EACpB,UAAU,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EACrC,QAAQ,SAAS,QAAQ,CAAC,CAAC,CAAC,EAAE,KAC5B,OAAO,CAAC,CAAC,CA8DX,CAAC"}
+{"version":3,"file":"use-form-core.d.ts","sourceRoot":"","sources":["../src/use-form-core.ts"],"names":[],"mappings":"AACA,OAAO,EACN,YAAY,EAKZ,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAc,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAE/D,MAAM,WAAW,OAAO,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM;IACnE,MAAM,EAAE,CAAC,CAAC;IACV,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,QAAQ,EAAE,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACzE,QAAQ,EAAE,CACT,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,EAChD,OAAO,CAAC,EAAE,OAAO,KACb,IAAI,CAAC;IACV,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,aAAa,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC;IACzD,OAAO,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,MAAM,IAAI,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAE3D,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,EACtE,OAAO,UAAU,CAAC,CAAC,CAAC,EACpB,UAAU,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EACrC,QAAQ,SAAS,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EACjC,UAAU,CAAC,EACX,kBAAkB,OAAO,KACvB,OAAO,CAAC,CAAC,EAAE,CAAC,CA2Fd,CAAC"}

package/dist/use-form-core.js

@@ -1,11 +1,31 @@
-import { useCallback, useMemo } from '@pionjs/pion';
 import { invoke } from '@neovici/cosmoz-utils/function';
+import { useCallback, useEffect, useMemo, useRef, } from '@pionjs/pion';
+import { touch, touched, untouch } from './touch';
 import { applyRules } from './use-items/apply-rules';
-import { touch, untouch, touched } from './touch';
-export const useFormCore = (state, setState, rules) => {
+export const useFormCore = (state, setState, rules, context, externalTouched) => {
     const [, values] = state;
+    // Re-apply rules when context changes, passing oldContext so depsFn comparisons
+    // correctly detect the change (new context vs old context for the same values).
+    const prevContextRef = useRef(undefined);
+    useEffect(() => {
+        const oldContext = prevContextRef.current;
+        prevContextRef.current = context;
+        if (oldContext === undefined)
+            return; // skip mount
+        setState(([initial, values]) => [
+            initial,
+            touch(applyRules({
+                oldItem: values,
+                newItem: values,
+                rules,
+                context,
+                oldContext,
+            }), touched(values)),
+        ]);
+    }, [context]);
     return {
         values,
+        context: (context ?? {}),
         onReset: useCallback(() => setState(([initial]) => [initial, initial]), [setState]),
         onValues: useCallback((valuesOrFn, touched = true) => setState(([initial, prev]) => [
             initial,
@@ -13,8 +33,9 @@ export const useFormCore = (state, setState, rules) => {
                 oldItem: prev,
                 newItem: invoke(valuesOrFn, prev),
                 rules,
+                context,
             }), touched),
-        ]), [rules, setState]),
+        ]), [rules, setState, context]),
         onChange: useCallback((update, touched = true) => setState(([initial, values]) => [
             initial,
             touch(applyRules({
@@ -24,8 +45,9 @@ export const useFormCore = (state, setState, rules) => {
                     ...invoke(update, values),
                 },
                 rules,
+                context,
             }), touched),
-        ]), [rules, setState]),
+        ]), [rules, setState, context]),
         load: useCallback((values, rulesOverride) => {
             if (!values) {
                 setState([values, values]);
@@ -35,9 +57,10 @@ export const useFormCore = (state, setState, rules) => {
                 oldItem: undefined,
                 newItem: values,
                 rules: rulesOverride ?? rules,
+                context,
             }));
             setState([ini, ini]);
-        }, [rules, setState]),
-        touched: useMemo(() => touched(values), [values]),
+        }, [rules, setState, context]),
+        touched: useMemo(() => touched(values) || (externalTouched ?? false), [values, externalTouched]),
     };
 };

package/dist/use-form.d.ts

@@ -1,6 +1,6 @@
 import type { UseForm } from './use-form-core';
 import { ItemRule } from './use-items/apply-rules';
-export declare const processInitial: <T extends object>(initial: T, rules?: readonly ItemRule<T>[]) => T;
+export declare const processInitial: <T extends object, C extends object = object>(initial: T, rules?: readonly ItemRule<T, C>[], context?: C) => T;
 export declare const useForm: <T extends object>(initial: T, rules?: readonly ItemRule<T>[]) => UseForm<T>;
 export { UseForm };
 //# sourceMappingURL=use-form.d.ts.map

package/dist/use-form.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-form.d.ts","sourceRoot":"","sources":["../src/use-form.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAc,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAc,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAE/D,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,MAAM,EAC9C,SAAS,CAAC,EACV,QAAQ,SAAS,QAAQ,CAAC,CAAC,CAAC,EAAE,KAC5B,CAAyE,CAAC;AAE7E,eAAO,MAAM,OAAO,GAAI,CAAC,SAAS,MAAM,EACvC,SAAS,CAAC,EACV,QAAQ,SAAS,QAAQ,CAAC,CAAC,CAAC,EAAE,KAC5B,OAAO,CAAC,CAAC,CAOX,CAAC;AAEF,OAAO,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"use-form.d.ts","sourceRoot":"","sources":["../src/use-form.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAc,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAc,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAE/D,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,EACzE,SAAS,CAAC,EACV,QAAQ,SAAS,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EACjC,UAAU,CAAC,KACT,CAC2E,CAAC;AAE/E,eAAO,MAAM,OAAO,GAAI,CAAC,SAAS,MAAM,EACvC,SAAS,CAAC,EACV,QAAQ,SAAS,QAAQ,CAAC,CAAC,CAAC,EAAE,KAC5B,OAAO,CAAC,CAAC,CAOX,CAAC;AAEF,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/use-form.js

@@ -2,7 +2,7 @@ import { useState } from '@pionjs/pion';
 import { untouch } from './touch';
 import { useFormCore } from './use-form-core';
 import { applyRules } from './use-items/apply-rules';
-export const processInitial = (initial, rules) => untouch(applyRules({ oldItem: undefined, newItem: initial, rules }));
+export const processInitial = (initial, rules, context) => untouch(applyRules({ oldItem: undefined, newItem: initial, rules, context }));
 export const useForm = (initial, rules) => {
     const [state, setState] = useState(() => {
         const ini = processInitial(initial, rules);

package/dist/use-items/apply-rules.d.ts

@@ -1,11 +1,16 @@
-export type Compute<T> = (current: T, item: T | undefined, index: number | undefined, oldIndex: number | undefined) => Partial<T>;
-export type Deps<T> = (current: T, index: number | undefined) => unknown[];
-export type ItemRule<T> = readonly [Compute<T>, Deps<T>?];
-export declare const applyRules: <T extends object>({ oldItem, newItem, rules, index, oldIndex, }: {
+export type Compute<T, C extends object = object> = (current: T, item: T | undefined, index: number | undefined, oldIndex: number | undefined, context?: C) => Partial<T>;
+export type Deps<T, C extends object = object> = (current: T, index: number | undefined, context?: C) => unknown[];
+export type ItemRule<T, C extends object = object> = readonly [
+    Compute<T, C>,
+    Deps<T, C>?
+];
+export declare const applyRules: <T extends object, C extends object = object>({ oldItem, newItem, rules, index, oldIndex, context, oldContext, }: {
     oldItem?: T | undefined;
     newItem: T;
-    rules: readonly ItemRule<T>[] | undefined;
+    rules: readonly ItemRule<T, C>[] | undefined;
     index?: number;
     oldIndex?: number;
+    context?: C;
+    oldContext?: C;
 }) => T;
 //# sourceMappingURL=apply-rules.d.ts.map

package/dist/use-items/apply-rules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apply-rules.d.ts","sourceRoot":"","sources":["../../src/use-items/apply-rules.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,CACxB,OAAO,EAAE,CAAC,EACV,IAAI,EAAE,CAAC,GAAG,SAAS,EACnB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,QAAQ,EAAE,MAAM,GAAG,SAAS,KACxB,OAAO,CAAC,CAAC,CAAC,CAAC;AAChB,MAAM,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,EAAE,CAAC;AAC3E,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE1D,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,MAAM,EAAE,+CAM1C;IACF,OAAO,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC;IACxB,OAAO,EAAE,CAAC,CAAC;IACX,KAAK,EAAE,SAAS,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB,KAAG,CAcH,CAAC"}
+{"version":3,"file":"apply-rules.d.ts","sourceRoot":"","sources":["../../src/use-items/apply-rules.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,OAAO,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,CACnD,OAAO,EAAE,CAAC,EACV,IAAI,EAAE,CAAC,GAAG,SAAS,EACnB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,OAAO,CAAC,EAAE,CAAC,KACP,OAAO,CAAC,CAAC,CAAC,CAAC;AAChB,MAAM,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,CAChD,OAAO,EAAE,CAAC,EACV,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,OAAO,CAAC,EAAE,CAAC,KACP,OAAO,EAAE,CAAC;AACf,MAAM,MAAM,QAAQ,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,SAAS;IAC7D,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IACb,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CACX,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,oEAQrE;IACF,OAAO,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC;IACxB,OAAO,EAAE,CAAC,CAAC;IACX,KAAK,EAAE,SAAS,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,CAAC,CAAC;IACZ,UAAU,CAAC,EAAE,CAAC,CAAC;CACf,KAAG,CAiBH,CAAC"}

package/dist/use-items/apply-rules.js

@@ -1,13 +1,13 @@
 const changed = (values, lastValues) => !lastValues || values.some((value, i) => !Object.is(lastValues[i], value));
-export const applyRules = ({ oldItem, newItem, rules, index, oldIndex = index, }) => {
+export const applyRules = ({ oldItem, newItem, rules, index, oldIndex = index, context, oldContext = context, }) => {
     if (!rules)
         return newItem;
     return rules.reduce((currentItem, [computeFn, depsFn]) => oldItem &&
         depsFn &&
-        !changed(depsFn(currentItem, index), depsFn(oldItem, oldIndex))
+        !changed(depsFn(currentItem, index, context), depsFn(oldItem, oldIndex, oldContext))
         ? currentItem
         : {
             ...currentItem,
-            ...computeFn(currentItem, oldItem, index, oldIndex),
+            ...computeFn(currentItem, oldItem, index, oldIndex, context),
         }, newItem);
 };

package/dist/use-items/use-async-rules.d.ts

@@ -6,11 +6,12 @@ import type { UseItemsCore } from './use-items';
  *
  * Usage:
  *   const core = useItems({ initial, rules });
- *   useAsyncRules(core.items, asyncRules, core.update);
+ *   useAsyncRules(core.items, asyncRules, core.update, { context });
  *   return core;
  */
-export declare const useAsyncRules: <T extends object>(items: T[], asyncRules: readonly AsyncItemRule<T>[] | undefined, update: UseItemsCore<T>["update"], opts?: {
-    onError?: (err: unknown, rule: AsyncItemRule<T>, index: number) => void;
+export declare const useAsyncRules: <T extends object, C extends object = object>(items: T[], asyncRules: readonly AsyncItemRule<T, C>[] | undefined, update: UseItemsCore<T>["update"], opts?: {
+    context?: C;
+    onError?: (err: unknown, rule: AsyncItemRule<T, C>, index: number) => void;
 }) => {
     processing: boolean;
 };

package/dist/use-items/use-async-rules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-async-rules.d.ts","sourceRoot":"","sources":["../../src/use-items/use-async-rules.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,eAAe,CAAC;AAEhE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAuBhD;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,MAAM,EAC7C,OAAO,CAAC,EAAE,EACV,YAAY,SAAS,aAAa,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,EACnD,QAAQ,YAAY,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EACjC,OAAO;IACN,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACxE,KACC;IAAE,UAAU,EAAE,OAAO,CAAA;CA0EvB,CAAC"}
+{"version":3,"file":"use-async-rules.d.ts","sourceRoot":"","sources":["../../src/use-items/use-async-rules.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,eAAe,CAAC;AAEhE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AA6BhD;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,EACxE,OAAO,CAAC,EAAE,EACV,YAAY,SAAS,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,SAAS,EACtD,QAAQ,YAAY,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EACjC,OAAO;IACN,OAAO,CAAC,EAAE,CAAC,CAAC;IACZ,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3E,KACC;IAAE,UAAU,EAAE,OAAO,CAAA;CA2EvB,CAAC"}

package/dist/use-items/use-async-rules.js

@@ -17,10 +17,11 @@ const ensureRuleTracking = (rule, runnersRef, prevDepsRef) => {
  *
  * Usage:
  *   const core = useItems({ initial, rules });
- *   useAsyncRules(core.items, asyncRules, core.update);
+ *   useAsyncRules(core.items, asyncRules, core.update, { context });
  *   return core;
  */
 export const useAsyncRules = (items, asyncRules, update, opts) => {
+    const context = opts?.context;
     const onError = opts?.onError ?? DEFAULT_ON_ERROR;
     const pendingCount = useRef(0);
     const [processing, setProcessing] = useState(false);
@@ -34,7 +35,7 @@ export const useAsyncRules = (items, asyncRules, update, opts) => {
             }
         }
     }, []);
-    // Dep-check + rule dispatch: runs after every items change
+    // Dep-check + rule dispatch: runs after every items or context change
     useEffect(() => {
         if (!asyncRules?.length) {
             return;
@@ -47,7 +48,7 @@ export const useAsyncRules = (items, asyncRules, update, opts) => {
                 if (!runnersForRule.has(idx)) {
                     runnersForRule.set(idx, runnerFactory());
                 }
-                const deps = depsFn(item, idx);
+                const deps = depsFn(item, idx, context);
                 const prev = prevDepsRef.current.get(rule).get(idx);
                 if (prev != null && !changed(deps, prev)) {
                     continue;
@@ -59,7 +60,7 @@ export const useAsyncRules = (items, asyncRules, update, opts) => {
                     setProcessing(true);
                 runner
                     .run(ruleFn, item, (patch) => update(idx, patch), // intermediate: no touch
-                { index: idx })
+                { index: idx, context })
                     .then((result) => {
                     if (result !== null) {
                         update(idx, result);
@@ -73,6 +74,6 @@ export const useAsyncRules = (items, asyncRules, update, opts) => {
                 });
             }
         }
-    }, [items]);
+    }, [items, context]);
     return { processing };
 };

package/dist/use-items/use-items.d.ts

@@ -1,8 +1,10 @@
 import { StateUpdater } from '@pionjs/pion';
 import { ItemRule } from './apply-rules';
-interface Props<T extends object> {
+interface Props<T extends object, C extends object = object> {
     initial: T[];
-    rules?: ItemRule<T>[];
+    rules?: ItemRule<T, C>[];
+    context?: C;
+    touched?: boolean;
 }
 export type UseItemsCore<T extends object> = {
     items: T[];
@@ -16,10 +18,10 @@ export type UseItemsCore<T extends object> = {
     clear: () => void;
     load: (items: T[], rulesOverride?: ItemRule<T>[]) => void;
 };
-export declare const useItemsCore: <T extends object>({ items, setItems, initial, rules, }: Props<T> & {
+export declare const useItemsCore: <T extends object, C extends object = object>({ items, setItems, initial, rules, context, touched: externalTouched, }: Props<T, C> & {
     items: T[];
     setItems: StateUpdater<T[]>;
 }) => UseItemsCore<T>;
-export declare const useItems: <T extends object>({ initial, rules }: Props<T>) => UseItemsCore<T>;
+export declare const useItems: <T extends object, C extends object = object>({ initial, rules, context, touched, }: Props<T, C>) => UseItemsCore<T>;
 export {};
 //# sourceMappingURL=use-items.d.ts.map

package/dist/use-items/use-items.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-items.d.ts","sourceRoot":"","sources":["../../src/use-items/use-items.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAkC,MAAM,cAAc,CAAC;AAE5E,OAAO,EAAc,QAAQ,EAAE,MAAM,eAAe,CAAC;AAErD,UAAU,KAAK,CAAC,CAAC,SAAS,MAAM;IAC/B,OAAO,EAAE,CAAC,EAAE,CAAC;IACb,KAAK,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;CACtB;AAYD,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,MAAM,IAAI;IAC5C,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,QAAQ,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,CACP,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EACxD,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,KACd,IAAI,CAAC;IACV,SAAS,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IACrE,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,IAAI,CAAC;IAC7B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,aAAa,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC;CAC1D,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,MAAM,EAAE,sCAK5C,KAAK,CAAC,CAAC,CAAC,GAAG;IACb,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,QAAQ,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC;CAC5B,KAAG,YAAY,CAAC,CAAC,CA+FjB,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,CAAC,SAAS,MAAM,EAAE,oBAAoB,KAAK,CAAC,CAAC,CAAC,oBAStE,CAAC"}
+{"version":3,"file":"use-items.d.ts","sourceRoot":"","sources":["../../src/use-items/use-items.ts"],"names":[],"mappings":"AACA,OAAO,EACN,YAAY,EAMZ,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAc,QAAQ,EAAE,MAAM,eAAe,CAAC;AAErD,UAAU,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM;IAC1D,OAAO,EAAE,CAAC,EAAE,CAAC;IACb,KAAK,CAAC,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE,CAAC,CAAC;IACZ,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAYD,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,MAAM,IAAI;IAC5C,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,QAAQ,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,CACP,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EACxD,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,KACd,IAAI,CAAC;IACV,SAAS,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IACrE,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,IAAI,CAAC;IAC7B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,aAAa,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC;CAC1D,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,yEAOvE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG;IAChB,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,QAAQ,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC;CAC5B,KAAG,YAAY,CAAC,CAAC,CAmIjB,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,uCAKnE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,oBAkBb,CAAC"}

package/dist/use-items/use-items.js

@@ -1,5 +1,5 @@
 import { invoke } from '@neovici/cosmoz-utils/function';
-import { useCallback, useMemo, useState } from '@pionjs/pion';
+import { useCallback, useEffect, useMemo, useRef, useState, } from '@pionjs/pion';
 import { touch, touched } from '../touch';
 import { applyRules } from './apply-rules';
 const changes = (indexOrChanges, update) => {
@@ -8,11 +8,28 @@ const changes = (indexOrChanges, update) => {
     }
     return [[indexOrChanges, update]];
 };
-export const useItemsCore = ({ items, setItems, initial, rules, }) => {
+export const useItemsCore = ({ items, setItems, initial, rules, context, touched: externalTouched, }) => {
+    // Re-apply rules when context changes, passing oldContext so depsFn comparisons
+    // correctly detect the change (new context vs old context for the same item).
+    const prevContextRef = useRef(undefined);
+    useEffect(() => {
+        const oldContext = prevContextRef.current;
+        prevContextRef.current = context;
+        if (oldContext === undefined)
+            return; // skip mount
+        setItems((currentItems) => currentItems.map((oldItem, index) => touch(applyRules({
+            oldItem,
+            newItem: oldItem,
+            rules,
+            index,
+            context,
+            oldContext,
+        }), touched(oldItem))));
+    }, [context]);
     return {
         items,
         setItems,
-        touched: touched(items),
+        touched: useMemo(() => touched(items) || (externalTouched ?? false), [items, externalTouched]),
         update: useCallback((indexOrChanges, update) => setItems((items = []) => touch(changes(indexOrChanges ?? items.length, update).reduce((acc, [index, update]) => [
             ...acc.slice(0, index),
             touch(applyRules({
@@ -20,9 +37,10 @@ export const useItemsCore = ({ items, setItems, initial, rules, }) => {
                 newItem: { ...acc[index], ...update },
                 rules,
                 index,
+                context,
             })),
             ...acc.slice(index + 1),
-        ], items))), [rules]),
+        ], items))), [rules, context]),
         updateAll: useCallback((updateOrFn) => setItems((items = []) => items.map((oldItem, index) => {
             const newItem = invoke(updateOrFn, oldItem);
             return touch(applyRules({
@@ -30,8 +48,9 @@ export const useItemsCore = ({ items, setItems, initial, rules, }) => {
                 newItem: { ...oldItem, ...newItem },
                 rules,
                 index,
+                context,
             }));
-        })), [rules]),
+        })), [rules, context]),
         remove: useCallback((rindex) => setItems((items = []) => touch([
             ...items.slice(0, rindex),
             ...items.slice(rindex + 1).map((item, index) => applyRules({
@@ -40,19 +59,33 @@ export const useItemsCore = ({ items, setItems, initial, rules, }) => {
                 oldItem: item,
                 index: index + rindex,
                 oldIndex: index + rindex + 1,
+                context,
             })),
-        ])), [rules]),
+        ])), [rules, context]),
         append: useCallback((appendedItems) => setItems((items = []) => touch(items.concat(appendedItems.map((item, index) => applyRules({
             rules,
             newItem: item,
             index: index + items.length,
-        }))))), [rules]),
+            context,
+        }))))), [rules, context]),
         reset: useCallback(() => setItems(initial), [initial]),
         clear: useCallback(() => setItems(touch([])), []),
-        load: useCallback((items, rulesOverride) => setItems(items.map((newItem, index) => applyRules({ newItem, index, rules: rulesOverride ?? rules }))), [rules]),
+        load: useCallback((items, rulesOverride) => setItems(items.map((newItem, index) => applyRules({
+            newItem,
+            index,
+            rules: rulesOverride ?? rules,
+            context,
+        }))), [rules, context]),
     };
 };
-export const useItems = ({ initial, rules }) => {
-    const _initial = useMemo(() => initial.map((newItem, index) => applyRules({ rules, newItem, index })), [initial]), [items, setItems] = useState(_initial);
-    return useItemsCore({ items, setItems, initial: _initial, rules });
+export const useItems = ({ initial, rules, context, touched, }) => {
+    const _initial = useMemo(() => initial.map((newItem, index) => applyRules({ rules, newItem, index, context })), [initial]), [items, setItems] = useState(_initial);
+    return useItemsCore({
+        items,
+        setItems,
+        initial: _initial,
+        rules,
+        context,
+        touched,
+    });
 };

package/dist/use-items/use-validated-items.d.ts

@@ -5,14 +5,16 @@ import { UseItemsCore } from './use-items';
 export type ValidatedItem = Partial<{
     [ERROR]: Errors | undefined;
 }>;
-interface Props<T extends ValidatedItem> {
+interface Props<T extends ValidatedItem, C extends object = object> {
     initial: T[];
-    rules?: ItemRule<T>[];
-    fields: Fields<T>;
+    rules?: ItemRule<T, C>[];
+    fields: Fields<T, C>;
+    context?: C;
+    touched?: boolean;
 }
 export interface UseValidatedItems<T extends object> extends UseItemsCore<T & ValidatedItem> {
     invalid: boolean;
 }
-export declare const useValidatedItems: <T extends object>({ initial, rules, fields, }: Props<T>) => UseValidatedItems<T>;
+export declare const useValidatedItems: <T extends object, C extends object = object>({ initial, rules, fields, context, touched, }: Props<T, C>) => UseValidatedItems<T>;
 export {};
 //# sourceMappingURL=use-validated-items.d.ts.map

package/dist/use-items/use-validated-items.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-validated-items.d.ts","sourceRoot":"","sources":["../../src/use-items/use-validated-items.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAkB,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAY,YAAY,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC;IAAE,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC,CAAC;AACrE,UAAU,KAAK,CAAC,CAAC,SAAS,aAAa;IACtC,OAAO,EAAE,CAAC,EAAE,CAAC;IACb,KAAK,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAClD,SAAQ,YAAY,CAAC,CAAC,GAAG,aAAa,CAAC;IACvC,OAAO,EAAE,OAAO,CAAC;CACjB;AAED,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,MAAM,EAAE,6BAIjD,KAAK,CAAC,CAAC,CAAC,KAAG,iBAAiB,CAAC,CAAC,CAsBhC,CAAC"}
+{"version":3,"file":"use-validated-items.d.ts","sourceRoot":"","sources":["../../src/use-items/use-validated-items.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAkB,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAY,YAAY,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC;IAAE,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC,CAAC;AACrE,UAAU,KAAK,CAAC,CAAC,SAAS,aAAa,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM;IACjE,OAAO,EAAE,CAAC,EAAE,CAAC;IACb,KAAK,CAAC,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,CAAC;IACZ,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAE,SAAQ,YAAY,CACxE,CAAC,GAAG,aAAa,CACjB;IACA,OAAO,EAAE,OAAO,CAAC;CACjB;AAED,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,+CAM5E,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,iBAAiB,CAAC,CAAC,CA4BnC,CAAC"}

package/dist/use-items/use-validated-items.js

@@ -2,12 +2,14 @@ import { useMeta } from '@neovici/cosmoz-utils/hooks/use-meta';
 import { useMemo } from '@pionjs/pion';
 import { ERROR, validateFields } from '../validation';
 import { useItems } from './use-items';
-export const useValidatedItems = ({ initial, rules, fields, }) => {
+export const useValidatedItems = ({ initial, rules, fields, context, touched, }) => {
     const meta = useMeta({ fields }), validation = useMemo(() => [
-        (item) => ({ [ERROR]: validateFields(meta.fields, item) }),
-    ], [meta]), { items, ...rest } = useItems({
+        (item) => ({ [ERROR]: validateFields(meta.fields, item, context) }),
+    ], [meta, context]), { items, ...rest } = useItems({
         initial,
         rules: useMemo(() => [...(rules ?? []), validation], [rules, validation]),
+        context,
+        touched,
     }), invalid = useMemo(() => items.some((i) => i[ERROR]), [items]);
     return {
         ...rest,

package/dist/use-validated-form$.d.ts

@@ -4,11 +4,12 @@ import type { Fields } from './types';
 import { UseValidatedForm } from './use-validated-form';
 export type ProgressValue = string | number;
 export type Progress = [ProgressValue, ProgressValue];
-export interface Props<T extends object> {
-    fields: Fields<T>;
+export interface Props<T extends object, C extends object = object> {
+    fields: Fields<T, C>;
     initial: T;
-    rules?: ItemRule<T>[];
-    asyncRules?: readonly AsyncItemRule<T>[];
+    rules?: ItemRule<T, C>[];
+    asyncRules?: readonly AsyncItemRule<T, C>[];
+    context?: C;
     onSave?: (values: T, initial: T, setProgress?: (p: Progress) => void) => PromiseLike<unknown>;
     allowEmpty?: boolean;
 }
@@ -19,8 +20,8 @@ interface Opts {
     save$?: PromiseLike<unknown>;
     onSave: () => void;
 }
-export interface UseValidatedForm$<T extends object> extends UseValidatedForm<T>, Opts {
+export interface UseValidatedForm$<T extends object, C extends object = object> extends UseValidatedForm<T, C>, Opts {
 }
-declare function useValidatedForm$<T extends object>({ fields, initial, rules, asyncRules, onSave, allowEmpty, }: Props<T>): UseValidatedForm$<T>;
+declare function useValidatedForm$<T extends object, C extends object = object>({ fields, initial, rules, asyncRules, context, onSave, allowEmpty, }: Props<T, C>): UseValidatedForm$<T, C>;
 export { useValidatedForm$ };
 //# sourceMappingURL=use-validated-form$.d.ts.map

package/dist/use-validated-form$.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-validated-form$.d.ts","sourceRoot":"","sources":["../src/use-validated-form$.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC;AAC7B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEtC,OAAO,EAAE,gBAAgB,EAAoB,MAAM,sBAAsB,CAAC;AAE1E,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,CAAC;AAC5C,MAAM,MAAM,QAAQ,GAAG,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;AAEtD,MAAM,WAAW,KAAK,CAAC,CAAC,SAAS,MAAM;IACtC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAClB,OAAO,EAAE,CAAC,CAAC;IACX,KAAK,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,SAAS,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;IACzC,MAAM,CAAC,EAAE,CACR,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,CAAC,EACV,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,KAAK,IAAI,KAC/B,WAAW,CAAC,OAAO,CAAC,CAAC;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,UAAU,IAAI;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,KAAK,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC7B,MAAM,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAClD,SAAQ,gBAAgB,CAAC,CAAC,CAAC,EAAE,IAAI;CAAG;AAErC,iBAAS,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,EAC5C,MAAM,EACN,OAAO,EACP,KAAK,EACL,UAAU,EACV,MAAM,EACN,UAAU,GACV,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAqBjC;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}
+{"version":3,"file":"use-validated-form$.d.ts","sourceRoot":"","sources":["../src/use-validated-form$.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC;AAC7B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEtC,OAAO,EAAE,gBAAgB,EAAoB,MAAM,sBAAsB,CAAC;AAE1E,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,CAAC;AAC5C,MAAM,MAAM,QAAQ,GAAG,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;AAEtD,MAAM,WAAW,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM;IACjE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACrB,OAAO,EAAE,CAAC,CAAC;IACX,KAAK,CAAC,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,SAAS,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IAC5C,OAAO,CAAC,EAAE,CAAC,CAAC;IACZ,MAAM,CAAC,EAAE,CACR,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,CAAC,EACV,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,KAAK,IAAI,KAC/B,WAAW,CAAC,OAAO,CAAC,CAAC;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,UAAU,IAAI;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,KAAK,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC7B,MAAM,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,CAC7E,SAAQ,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI;CAAG;AAExC,iBAAS,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,EACvE,MAAM,EACN,OAAO,EACP,KAAK,EACL,UAAU,EACV,OAAO,EACP,MAAM,EACN,UAAU,GACV,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,CAqBvC;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/use-validated-form$.js

@@ -1,8 +1,8 @@
 import { useCallback, useState } from '@pionjs/pion';
 import { useAsyncFormCore } from './use-async-form-core';
 import { useValidatedForm } from './use-validated-form';
-function useValidatedForm$({ fields, initial, rules, asyncRules, onSave, allowEmpty, }) {
-    const form = useValidatedForm({ fields, initial, rules });
+function useValidatedForm$({ fields, initial, rules, asyncRules, context, onSave, allowEmpty, }) {
+    const form = useValidatedForm({ fields, initial, rules, context });
     const { processing } = useAsyncFormCore(form, asyncRules);
     const { values, invalid } = form;
     const [save$, setSave$] = useState();

package/dist/use-validated-form-core.d.ts

@@ -1,17 +1,19 @@
 import { StateUpdater } from '@pionjs/pion';
-import { validate } from './validation';
-import { UseForm } from './use-form';
 import type { Fields } from './types';
-import type { ItemRule } from './use-items/apply-rules';
+import { UseForm } from './use-form';
 import { FormValues } from './use-form-core';
-export declare const computeRules: <T extends object>(fields: Fields<T>, rules?: readonly ItemRule<T>[]) => ItemRule<T>[];
-type Validate<T extends object> = ReturnType<typeof validate<T>>;
-export interface UseValidatedForm<T extends object> extends UseForm<T>, Validate<T> {
+import type { ItemRule } from './use-items/apply-rules';
+import { validate } from './validation';
+export declare const computeRules: <T extends object, C extends object = object>(fields: Fields<T, C>, rules?: readonly ItemRule<T, C>[]) => ItemRule<T, C>[];
+type Validate<T extends object, C extends object = object> = ReturnType<typeof validate<T, C>>;
+export interface UseValidatedForm<T extends object, C extends object = object> extends UseForm<T, C>, Validate<T, C> {
 }
-interface Props<T extends object> {
-    fields?: Fields<T> | (() => Fields<T>);
-    rules?: readonly ItemRule<T>[];
+interface Props<T extends object, C extends object = object> {
+    fields?: Fields<T, C> | (() => Fields<T, C>);
+    rules?: readonly ItemRule<T, C>[];
+    context?: C;
+    touched?: boolean;
 }
-export declare const useValidatedFormCore: <T extends object>(state: FormValues<T>, setState: StateUpdater<FormValues<T>>, { fields: _fields, rules }: Readonly<Props<T>>) => UseValidatedForm<T>;
+export declare const useValidatedFormCore: <T extends object, C extends object = object>(state: FormValues<T>, setState: StateUpdater<FormValues<T>>, { fields: _fields, rules, context, touched }: Readonly<Props<T, C>>) => UseValidatedForm<T, C>;
 export {};
 //# sourceMappingURL=use-validated-form-core.d.ts.map

package/dist/use-validated-form-core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-validated-form-core.d.ts","sourceRoot":"","sources":["../src/use-validated-form-core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAW,MAAM,cAAc,CAAC;AAErD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAe,MAAM,iBAAiB,CAAC;AAE1D,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,MAAM,EAC5C,QAAQ,MAAM,CAAC,CAAC,CAAC,EACjB,QAAO,SAAS,QAAQ,CAAC,CAAC,CAAC,EAAO,KAChC,QAAQ,CAAC,CAAC,CAAC,EAMb,CAAC;AAEF,KAAK,QAAQ,CAAC,CAAC,SAAS,MAAM,IAAI,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AAEjE,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,MAAM,CACjD,SAAQ,OAAO,CAAC,CAAC,CAAC,EACjB,QAAQ,CAAC,CAAC,CAAC;CAAG;AAEhB,UAAU,KAAK,CAAC,CAAC,SAAS,MAAM;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACvC,KAAK,CAAC,EAAE,SAAS,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;CAC/B;AAED,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,MAAM,EACpD,OAAO,UAAU,CAAC,CAAC,CAAC,EACpB,UAAU,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EACrC,4BAA4B,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAC5C,gBAAgB,CAAC,CAAC,CAUpB,CAAC"}
+{"version":3,"file":"use-validated-form-core.d.ts","sourceRoot":"","sources":["../src/use-validated-form-core.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAW,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,UAAU,EAAe,MAAM,iBAAiB,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,EACvE,QAAQ,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EACpB,QAAO,SAAS,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,EAAO,KACnC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,EAMhB,CAAC;AAEF,KAAK,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,UAAU,CACtE,OAAO,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CACrB,CAAC;AAEF,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,CAC5E,SAAQ,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC;CAAG;AAEzC,UAAU,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7C,KAAK,CAAC,EAAE,SAAS,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IAClC,OAAO,CAAC,EAAE,CAAC,CAAC;IACZ,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,eAAO,MAAM,oBAAoB,GAChC,CAAC,SAAS,MAAM,EAChB,CAAC,SAAS,MAAM,GAAG,MAAM,EAEzB,OAAO,UAAU,CAAC,CAAC,CAAC,EACpB,UAAU,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EACrC,8CAA8C,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KACjE,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAavB,CAAC"}