@cube-dev/ui-kit 0.180.0 → 0.182.0

package/dist/components/form/Form/modern/types.d.ts

@@ -1,7 +1,8 @@
 
+import { ModernFormBrand } from "../backend.js";
 import { FormPath } from "./values.js";
+import { FormValues } from "./read-types.js";
 import { ModernValidationRule } from "./validation.js";
-import { ModernFormBrand } from "../backend.js";
 
 //#region src/components/form/Form/modern/types.d.ts
 type FieldStatus = 'unvalidated' | 'validating' | 'valid' | 'invalid';
@@ -18,9 +19,9 @@ interface FieldState<ErrorValue = unknown> {
   readonly validationRevision: number;
 }
 interface FormState<T extends object, ErrorValue = unknown> {
-  readonly values: Readonly<Partial<T>>;
-  readonly activeValues: Readonly<Partial<T>>;
-  readonly defaultValues: Readonly<Partial<T>>;
+  readonly values: FormValues<T>;
+  readonly activeValues: FormValues<T>;
+  readonly defaultValues: FormValues<T>;
   readonly fields: Readonly<Record<string, FieldState<ErrorValue>>>;
   readonly dirtyFields: ReadonlySet<string>;
   readonly touchedFields: ReadonlySet<string>;
@@ -30,12 +31,19 @@ interface FormState<T extends object, ErrorValue = unknown> {
   readonly isInvalid: boolean;
   readonly isValidating: boolean;
   readonly isSubmitting: boolean;
+  /** Reset would clear edits, touched/validation state, or a submit error; false while submitting. */
+  readonly canReset: boolean;
   readonly submitError: unknown;
   readonly revision: number;
 }
 interface RegistrationOptions<ErrorValue = unknown> {
   readonly rules?: readonly ModernValidationRule<ErrorValue>[];
+  /** Manual function revision, skipping source comparison. Declarative constraints are always compared. */
   readonly rulesKey?: string;
+  /** Field paths that trigger revalidation after this field has been validated. Declare conditional reads too. */
+  readonly dependsOn?: readonly FormPath[];
+  /** External validator inputs, compared by Object.is. */
+  readonly deps?: readonly unknown[];
   readonly validationDelay?: number;
   readonly validateTrigger?: 'onBlur' | 'onChange' | 'onSubmit';
   readonly errorPolicy?: 'first' | 'all';
@@ -67,13 +75,23 @@ interface ModernSubmitContext {
   readonly include: 'active' | 'all';
   readonly signal: AbortSignal;
 }
-interface FormCallbacks<T extends object> {
-  readonly onSubmit?: (values: Readonly<Partial<T>>, context: ModernSubmitContext) => void | Promise<void>;
-  readonly onSubmitFailed?: (error: unknown) => void | Promise<void>;
-  readonly onValuesChange?: (values: Readonly<Partial<T>>, change: FormChange) => void | Promise<void>;
+interface FormCallbacks<T extends object, ErrorValue = unknown> {
+  /** Form.useController commits the latest callback after each render. */
+  readonly onSubmit?: (values: FormValues<T>, context: ModernSubmitContext) => void | Promise<void>;
+  /** Form.useController commits the latest callback after each render. */
+  readonly onSubmitFailed?: (failure: ModernSubmitFailure<ErrorValue>) => void | Promise<void>;
+  /** Form.useController commits the latest callback after each render. */
+  readonly onValuesChange?: (values: FormValues<T>, change: FormChange) => void | Promise<void>;
 }
-interface CallbackBinding<T extends object> {
-  update(callbacks: FormCallbacks<T>): void;
+type ModernSubmitFailure<ErrorValue = unknown> = {
+  status: 'invalid';
+  errors: Readonly<Record<string, readonly ErrorValue[]>>;
+} | {
+  status: 'failed';
+  error: unknown;
+};
+interface CallbackBinding<T extends object, ErrorValue = unknown> {
+  update(callbacks: FormCallbacks<T, ErrorValue>): void;
   release(): void;
 }
 interface ModernFieldValidationResult<ErrorValue = unknown> {
@@ -87,25 +105,22 @@ interface ModernValidationResult<ErrorValue = unknown> {
   readonly isValid: boolean;
   readonly stale: boolean;
 }
-type ModernSubmitResult<ErrorValue = unknown> = {
+type ModernSubmitResult<ErrorValue = unknown> = ModernSubmitFailure<ErrorValue> | {
   status: 'ignored';
   reason: 'submitting';
 } | {
   status: 'stale';
-} | {
-  status: 'invalid';
-  errors: Readonly<Record<string, readonly ErrorValue[]>>;
-} | {
-  status: 'failed';
-  error: unknown;
 } | {
   status: 'submitted';
 };
-interface FormStoreOptions<T extends object> extends FormCallbacks<T> {
+interface FormStoreOptions<T extends object, ErrorValue = unknown> extends FormCallbacks<T, ErrorValue> {
+  /** Initial default policy; later hook renders do not change it. Fields can override it. */
   readonly errorPolicy?: 'first' | 'all';
+  /** Initial values only. Use setDefaultValues/adoptDefaultValues/reset to change them. */
   readonly defaultValues?: Partial<T>;
-  readonly onValuesChange?: (values: Readonly<Partial<T>>, change: FormChange) => void | Promise<void>;
+  /** Initial listener-error handler; later hook renders do not change it. */
   readonly onListenerError?: (error: unknown) => void;
+  /** Initial development-error handler; later hook renders do not change it. */
   readonly onDevelopmentError?: (message: string) => void;
 }
 /** Internal state token owned by the validation pipeline. */
@@ -127,8 +142,8 @@ interface FormStore<T extends object = Record<string, unknown>, ErrorValue = unk
   getFieldSnapshot(path: FormPath): FieldState<ErrorValue> | undefined;
   getValue<K extends keyof T & string>(name: K): T[K] | undefined;
   getValue(path: FormPath): unknown;
-  getValues(): Readonly<Partial<T>>;
-  getActiveValues(): Readonly<Partial<T>>;
+  getValues(): FormValues<T>;
+  getActiveValues(): FormValues<T>;
   subscribe(listener: () => void): () => void;
   subscribeSelector<Selected>(selector: (state: FormState<T, ErrorValue>) => Selected, listener: (value: Selected, previous: Selected) => void, isEqual?: (a: Selected, b: Selected) => boolean): () => void;
   register(path: FormPath, options?: RegistrationOptions<ErrorValue>): RegistrationToken<ErrorValue>;
@@ -140,7 +155,8 @@ interface FormStore<T extends object = Record<string, unknown>, ErrorValue = unk
     include?: 'active' | 'all';
   }): Promise<ModernSubmitResult<ErrorValue>>;
   blur(path: FormPath): void;
-  bindCallbacks(callbacks: FormCallbacks<T>): CallbackBinding<T>;
+  bindCallbacks(callbacks: FormCallbacks<T, ErrorValue>): CallbackBinding<T, ErrorValue>;
+  updateCallbacks(callbacks: FormCallbacks<T, ErrorValue>): void;
   setValue(path: FormPath, value: unknown, options?: SetValueOptions): void;
   setValues(values: Partial<T>, options?: SetValueOptions): void;
   /** Synchronous notification transaction; completed writes commit even if fn throws. */
@@ -169,5 +185,5 @@ interface FormStore<T extends object = Record<string, unknown>, ErrorValue = unk
   };
 }
 //#endregion
-export { FormCallbacks, FormChange, FormState, FormStore, FormStoreOptions, ModernFieldValidationResult, ModernSubmitContext, ModernSubmitResult, ModernValidationResult, SetValueOptions };
+export { FieldState, FormCallbacks, FormChange, FormState, FormStore, FormStoreOptions, ModernFieldValidationResult, ModernSubmitContext, ModernSubmitFailure, ModernSubmitResult, ModernValidationResult, RegistrationOptions, SetValueOptions };
 //# sourceMappingURL=types.d.ts.map

package/dist/components/form/Form/modern/validation.d.ts

@@ -1,12 +1,13 @@
 
 import { FormPath } from "./values.js";
+import { FormValues } from "./read-types.js";
 
 //#region src/components/form/Form/modern/validation.d.ts
 interface ModernValidationContext<T extends object = Record<string, unknown>> {
   readonly name: string;
   readonly signal: AbortSignal;
   getValue(path: FormPath): unknown;
-  getValues(): Readonly<Partial<T>>;
+  getValues(): FormValues<T>;
 }
 /** Library-neutral: return an error, or throw/reject; undefined/null means success. */
 interface ModernValidationRule<ErrorValue = unknown> {

package/dist/components/form/Form/modern/validation.js

@@ -1,12 +1,12 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 import { applyRule } from "../validation.js";
 
 //#region src/components/form/Form/modern/validation.ts
-/** Inline rules are equivalent by content; use rulesKey for closure captures. */
-function rulesSignature(rules = []) {
+/** Compare constraints and function source; captures still need deps/rulesKey. */
+function rulesSignature(rules = [], { hashFunctions = true } = {}) {
 	const seen = /* @__PURE__ */ new Set();
 	const signature = (value) => {
-		if (typeof value === "function") return `function:${value.toString()}`;
+		if (typeof value === "function") return hashFunctions ? `function:${value.toString()}` : "function";
 		if (value instanceof RegExp) return `regexp:${value.source}/${value.flags}`;
 		if (!value || typeof value !== "object") return `${typeof value}:${String(value)}`;
 		if (seen.has(value)) return "cycle";

package/dist/components/form/Form/modern/validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"validation.js","names":[],"sources":["../../../../../src/components/form/Form/modern/validation.ts"],"sourcesContent":["import { applyRule } from '../validation';\n\nimport type { FormPath } from './values';\n\nexport interface ModernValidationContext<\n  T extends object = Record<string, unknown>,\n> {\n  readonly name: string;\n  readonly signal: AbortSignal;\n  getValue(path: FormPath): unknown;\n  getValues(): Readonly<Partial<T>>;\n}\n\n/** Library-neutral: return an error, or throw/reject; undefined/null means success. */\nexport interface ModernValidationRule<ErrorValue = unknown> {\n  required?: boolean;\n  min?: number;\n  max?: number;\n  len?: number;\n  pattern?: RegExp;\n  type?: string;\n  enum?: readonly unknown[];\n  whitespace?: boolean;\n  transform?: (value: any) => unknown;\n  message?: ErrorValue;\n  validator?: (\n    rule: ModernValidationRule<ErrorValue>,\n    value: any,\n    context: ModernValidationContext<any>,\n  ) => ErrorValue | void | Promise<ErrorValue | void>;\n}\n\n/** Inline rules are equivalent by content; use rulesKey for closure captures. */\nexport function rulesSignature<ErrorValue>(\n  rules: readonly ModernValidationRule<ErrorValue>[] = [],\n): string {\n  const seen = new Set<object>();\n  const signature = (value: unknown): string => {\n    if (typeof value === 'function') return `function:${value.toString()}`;\n    if (value instanceof RegExp) return `regexp:${value.source}/${value.flags}`;\n    if (!value || typeof value !== 'object')\n      return `${typeof value}:${String(value)}`;\n    if (seen.has(value)) return 'cycle';\n    seen.add(value);\n    const result = JSON.stringify(\n      Object.keys(value)\n        .filter((key) => key !== 'message')\n        .sort()\n        .map((key) => [key, signature(Reflect.get(value, key))]),\n    );\n    seen.delete(value);\n    return result;\n  };\n  return signature(rules);\n}\n\nexport async function runRules<ErrorValue>(\n  value: unknown,\n  rules: readonly ModernValidationRule<ErrorValue>[],\n  context: ModernValidationContext<any>,\n  policy: 'first' | 'all',\n): Promise<ErrorValue[]> {\n  const errors: ErrorValue[] = [];\n  for (const rule of rules) {\n    if (context.signal.aborted) break;\n    const { validator, transform, ...checks } = rule;\n    try {\n      const transformed = transform ? transform(value) : value;\n      await applyRule(transformed, checks, undefined);\n      if (context.signal.aborted) break;\n      const result = await validator?.(rule, transformed, context);\n      if (result !== undefined && result !== null && result !== '')\n        errors.push(result as ErrorValue);\n    } catch (error) {\n      errors.push(\n        ((error instanceof Error ? error.message || rule.message : error) ??\n          rule.message ??\n          (rule.required ? 'Required' : 'Invalid value')) as ErrorValue,\n      );\n    }\n    if (errors.length && policy === 'first') break;\n  }\n  return errors;\n}\n"],"mappings":";;;;;AAiCA,SAAgB,eACd,QAAqD,EAAE,EAC/C;CACR,MAAM,uBAAO,IAAI,KAAa;CAC9B,MAAM,aAAa,UAA2B;AAC5C,MAAI,OAAO,UAAU,WAAY,QAAO,YAAY,MAAM,UAAU;AACpE,MAAI,iBAAiB,OAAQ,QAAO,UAAU,MAAM,OAAO,GAAG,MAAM;AACpE,MAAI,CAAC,SAAS,OAAO,UAAU,SAC7B,QAAO,GAAG,OAAO,MAAM,GAAG,OAAO,MAAM;AACzC,MAAI,KAAK,IAAI,MAAM,CAAE,QAAO;AAC5B,OAAK,IAAI,MAAM;EACf,MAAM,SAAS,KAAK,UAClB,OAAO,KAAK,MAAM,CACf,QAAQ,QAAQ,QAAQ,UAAU,CAClC,MAAM,CACN,KAAK,QAAQ,CAAC,KAAK,UAAU,QAAQ,IAAI,OAAO,IAAI,CAAC,CAAC,CAAC,CAC3D;AACD,OAAK,OAAO,MAAM;AAClB,SAAO;;AAET,QAAO,UAAU,MAAM;;AAGzB,eAAsB,SACpB,OACA,OACA,SACA,QACuB;CACvB,MAAM,SAAuB,EAAE;AAC/B,MAAK,MAAM,QAAQ,OAAO;AACxB,MAAI,QAAQ,OAAO,QAAS;EAC5B,MAAM,EAAE,WAAW,WAAW,GAAG,WAAW;AAC5C,MAAI;GACF,MAAM,cAAc,YAAY,UAAU,MAAM,GAAG;AACnD,SAAM,UAAU,aAAa,QAAQ,OAAU;AAC/C,OAAI,QAAQ,OAAO,QAAS;GAC5B,MAAM,SAAS,MAAM,YAAY,MAAM,aAAa,QAAQ;AAC5D,OAAI,WAAW,UAAa,WAAW,QAAQ,WAAW,GACxD,QAAO,KAAK,OAAqB;WAC5B,OAAO;AACd,UAAO,MACH,iBAAiB,QAAQ,MAAM,WAAW,KAAK,UAAU,UACzD,KAAK,YACJ,KAAK,WAAW,aAAa,iBACjC;;AAEH,MAAI,OAAO,UAAU,WAAW,QAAS;;AAE3C,QAAO"}
+{"version":3,"file":"validation.js","names":[],"sources":["../../../../../src/components/form/Form/modern/validation.ts"],"sourcesContent":["import { applyRule } from '../validation';\n\nimport type { FormValues } from './read-types';\nimport type { FormPath } from './values';\n\nexport interface ModernValidationContext<\n  T extends object = Record<string, unknown>,\n> {\n  readonly name: string;\n  readonly signal: AbortSignal;\n  getValue(path: FormPath): unknown;\n  getValues(): FormValues<T>;\n}\n\n/** Library-neutral: return an error, or throw/reject; undefined/null means success. */\nexport interface ModernValidationRule<ErrorValue = unknown> {\n  required?: boolean;\n  min?: number;\n  max?: number;\n  len?: number;\n  pattern?: RegExp;\n  type?: string;\n  enum?: readonly unknown[];\n  whitespace?: boolean;\n  transform?: (value: any) => unknown;\n  message?: ErrorValue;\n  validator?: (\n    rule: ModernValidationRule<ErrorValue>,\n    value: any,\n    context: ModernValidationContext<any>,\n  ) => ErrorValue | void | Promise<ErrorValue | void>;\n}\n\n/** Compare constraints and function source; captures still need deps/rulesKey. */\nexport function rulesSignature<ErrorValue>(\n  rules: readonly ModernValidationRule<ErrorValue>[] = [],\n  { hashFunctions = true }: { hashFunctions?: boolean } = {},\n): string {\n  const seen = new Set<object>();\n  const signature = (value: unknown): string => {\n    if (typeof value === 'function')\n      return hashFunctions ? `function:${value.toString()}` : 'function';\n    if (value instanceof RegExp) return `regexp:${value.source}/${value.flags}`;\n    if (!value || typeof value !== 'object')\n      return `${typeof value}:${String(value)}`;\n    if (seen.has(value)) return 'cycle';\n    seen.add(value);\n    const result = JSON.stringify(\n      Object.keys(value)\n        .filter((key) => key !== 'message')\n        .sort()\n        .map((key) => [key, signature(Reflect.get(value, key))]),\n    );\n    seen.delete(value);\n    return result;\n  };\n  return signature(rules);\n}\n\nexport async function runRules<ErrorValue>(\n  value: unknown,\n  rules: readonly ModernValidationRule<ErrorValue>[],\n  context: ModernValidationContext<any>,\n  policy: 'first' | 'all',\n): Promise<ErrorValue[]> {\n  const errors: ErrorValue[] = [];\n  for (const rule of rules) {\n    if (context.signal.aborted) break;\n    const { validator, transform, ...checks } = rule;\n    try {\n      const transformed = transform ? transform(value) : value;\n      await applyRule(transformed, checks, undefined);\n      if (context.signal.aborted) break;\n      const result = await validator?.(rule, transformed, context);\n      if (result !== undefined && result !== null && result !== '')\n        errors.push(result as ErrorValue);\n    } catch (error) {\n      errors.push(\n        ((error instanceof Error ? error.message || rule.message : error) ??\n          rule.message ??\n          (rule.required ? 'Required' : 'Invalid value')) as ErrorValue,\n      );\n    }\n    if (errors.length && policy === 'first') break;\n  }\n  return errors;\n}\n"],"mappings":";;;;;AAkCA,SAAgB,eACd,QAAqD,EAAE,EACvD,EAAE,gBAAgB,SAAsC,EAAE,EAClD;CACR,MAAM,uBAAO,IAAI,KAAa;CAC9B,MAAM,aAAa,UAA2B;AAC5C,MAAI,OAAO,UAAU,WACnB,QAAO,gBAAgB,YAAY,MAAM,UAAU,KAAK;AAC1D,MAAI,iBAAiB,OAAQ,QAAO,UAAU,MAAM,OAAO,GAAG,MAAM;AACpE,MAAI,CAAC,SAAS,OAAO,UAAU,SAC7B,QAAO,GAAG,OAAO,MAAM,GAAG,OAAO,MAAM;AACzC,MAAI,KAAK,IAAI,MAAM,CAAE,QAAO;AAC5B,OAAK,IAAI,MAAM;EACf,MAAM,SAAS,KAAK,UAClB,OAAO,KAAK,MAAM,CACf,QAAQ,QAAQ,QAAQ,UAAU,CAClC,MAAM,CACN,KAAK,QAAQ,CAAC,KAAK,UAAU,QAAQ,IAAI,OAAO,IAAI,CAAC,CAAC,CAAC,CAC3D;AACD,OAAK,OAAO,MAAM;AAClB,SAAO;;AAET,QAAO,UAAU,MAAM;;AAGzB,eAAsB,SACpB,OACA,OACA,SACA,QACuB;CACvB,MAAM,SAAuB,EAAE;AAC/B,MAAK,MAAM,QAAQ,OAAO;AACxB,MAAI,QAAQ,OAAO,QAAS;EAC5B,MAAM,EAAE,WAAW,WAAW,GAAG,WAAW;AAC5C,MAAI;GACF,MAAM,cAAc,YAAY,UAAU,MAAM,GAAG;AACnD,SAAM,UAAU,aAAa,QAAQ,OAAU;AAC/C,OAAI,QAAQ,OAAO,QAAS;GAC5B,MAAM,SAAS,MAAM,YAAY,MAAM,aAAa,QAAQ;AAC5D,OAAI,WAAW,UAAa,WAAW,QAAQ,WAAW,GACxD,QAAO,KAAK,OAAqB;WAC5B,OAAO;AACd,UAAO,MACH,iBAAiB,QAAQ,MAAM,WAAW,KAAK,UAAU,UACzD,KAAK,YACJ,KAAK,WAAW,aAAa,iBACjC;;AAEH,MAAI,OAAO,UAAU,WAAW,QAAS;;AAE3C,QAAO"}

package/dist/components/form/Form/modern/values.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 //#region src/components/form/Form/modern/values.ts
 const ownedContainers = /* @__PURE__ */ new WeakSet();
 function freezeContainer(value) {
@@ -56,6 +56,16 @@ function normalizePath(path) {
 function getFieldKey(path) {
 	return normalizePath(path).map((part) => part.replace(/\\/g, "\\\\").replace(/\./g, "\\.")).join(".");
 }
+/** Inverse of getFieldKey, for stable keys produced by this module. */
+function getFieldPath(key) {
+	const path = [""];
+	for (let index = 0; index < key.length; index++) {
+		const part = key[index];
+		if (part === ".") path.push("");
+		else path[path.length - 1] += part === "\\" ? key[++index] : part;
+	}
+	return Object.freeze(path);
+}
 function readPath(root, path) {
 	let value = root;
 	for (const key of path) {
@@ -68,6 +78,10 @@ function hasPath(root, path) {
 	const parent = readPath(root, path.slice(0, -1));
 	return isContainer(parent) && Object.hasOwn(parent, path[path.length - 1]);
 }
+/** Missing and explicitly undefined values are distinct form states. */
+function pathValueChanged(previous, next, path) {
+	return !Object.is(readPath(previous, path), readPath(next, path)) || hasPath(previous, path) !== hasPath(next, path);
+}
 /** Copy just the ancestor chain. Array deletion leaves indices in place. */
 function writePath(root, path, value, remove = false) {
 	function write(current, depth) {
@@ -140,5 +154,5 @@ function sameMembers(a, b) {
 }
 
 //#endregion
-export { createValueSnapshotter, defineValue, formValueEqual, freezeContainer, getFieldKey, hasPath, isPlainObject, normalizePath, readPath, readonlySet, sameMembers, writePath };
+export { createValueSnapshotter, defineValue, formValueEqual, freezeContainer, getFieldKey, getFieldPath, hasPath, isPlainObject, normalizePath, pathValueChanged, readPath, readonlySet, sameMembers, writePath };
 //# sourceMappingURL=values.js.map

package/dist/components/form/Form/modern/values.js.map

@@ -1 +1 @@
-{"version":3,"file":"values.js","names":[],"sources":["../../../../../src/components/form/Form/modern/values.ts"],"sourcesContent":["/** A string is a literal field name; tuples explicitly address nested values. */\nexport type FormPath = string | readonly (string | number)[];\n\ntype Container = Record<string, unknown> | unknown[];\n\n// Path copies and ingress copies share ownership, including across stores.\n// A WeakSet does not keep old snapshots alive after subscribers release them.\nconst ownedContainers = new WeakSet<object>();\n\nexport function freezeContainer<T extends object>(value: T): T {\n  ownedContainers.add(value);\n  return Object.freeze(value);\n}\n\nexport function isPlainObject(\n  value: unknown,\n): value is Record<string, unknown> {\n  if (!value || typeof value !== 'object') return false;\n  const prototype = Object.getPrototypeOf(value);\n  return prototype === Object.prototype || prototype === null;\n}\n\nfunction isContainer(value: unknown): value is Container {\n  return Array.isArray(value) || isPlainObject(value);\n}\n\nfunction enumerableKeys(value: object): (string | symbol)[] {\n  return Reflect.ownKeys(value).filter((key) =>\n    Object.prototype.propertyIsEnumerable.call(value, key),\n  );\n}\n\n/** Preserve the special non-enumerable descriptor of an array's length. */\nexport function defineValue(\n  container: object,\n  key: PropertyKey,\n  value: unknown,\n) {\n  Object.defineProperty(\n    container,\n    key,\n    Array.isArray(container) && key === 'length'\n      ? { value }\n      : { value, enumerable: true, writable: true, configurable: true },\n  );\n}\n\nfunction emptyCopy(value: Container): Container {\n  return Array.isArray(value)\n    ? new Array(value.length)\n    : Object.create(Object.getPrototypeOf(value));\n}\n\nfunction copyContainer(value: Container): Container {\n  const copy = emptyCopy(value);\n  for (const key of enumerableKeys(value))\n    defineValue(copy, key, Reflect.get(value, key));\n  return copy;\n}\n\n/** The ADR's default dirty comparator: Object.is, then one structural level. */\nexport function formValueEqual(a: unknown, b: unknown): boolean {\n  if (Object.is(a, b)) return true;\n  if (!isContainer(a) || !isContainer(b)) return false;\n  if (Array.isArray(a) !== Array.isArray(b)) return false;\n  if (Array.isArray(a) && Array.isArray(b) && a.length !== b.length)\n    return false;\n  const keys = enumerableKeys(a);\n  return (\n    keys.length === enumerableKeys(b).length &&\n    keys.every(\n      (key) =>\n        Object.hasOwn(b, key) &&\n        Object.is(Reflect.get(a, key), Reflect.get(b, key)),\n    )\n  );\n}\n\nexport function normalizePath(path: FormPath): readonly string[] {\n  const parts = typeof path === 'string' ? [path] : path;\n  if (!parts.length) throw new Error('A form field path must not be empty.');\n  return Object.freeze(\n    Array.from(parts, (part) => {\n      if (\n        typeof part !== 'string' &&\n        (!Number.isSafeInteger(part) || part < 0)\n      ) {\n        throw new Error(\n          'A numeric form path segment must be a non-negative safe integer.',\n        );\n      }\n      const key = String(part);\n      if (key === '__proto__' || key === 'prototype' || key === 'constructor') {\n        throw new Error(`Unsafe form path segment: ${key}`);\n      }\n      return key;\n    }),\n  );\n}\n\n/** Escaping keeps literal dotted names distinct from nested tuple paths. */\nexport function getFieldKey(path: FormPath): string {\n  return normalizePath(path)\n    .map((part) => part.replace(/\\\\/g, '\\\\\\\\').replace(/\\./g, '\\\\.'))\n    .join('.');\n}\n\nexport function readPath(root: unknown, path: readonly string[]): unknown {\n  let value = root;\n  for (const key of path) {\n    if (!isContainer(value) || !Object.hasOwn(value, key)) return undefined;\n    value = Reflect.get(value, key);\n  }\n  return value;\n}\n\nexport function hasPath(root: unknown, path: readonly string[]): boolean {\n  const parent = readPath(root, path.slice(0, -1));\n  return isContainer(parent) && Object.hasOwn(parent, path[path.length - 1]);\n}\n\n/** Copy just the ancestor chain. Array deletion leaves indices in place. */\nexport function writePath(\n  root: object,\n  path: readonly string[],\n  value: unknown,\n  remove = false,\n): object {\n  function write(current: unknown, depth: number): unknown {\n    const key = path[depth];\n    const container = isContainer(current) ? current : undefined;\n    const exists = !!container && Object.hasOwn(container, key);\n    const previous = exists ? Reflect.get(container!, key) : undefined;\n    if (remove && !exists) return current;\n    const last = depth === path.length - 1;\n    const next = last ? value : write(previous, depth + 1);\n    if (!remove && exists && Object.is(previous, next)) return current;\n    if (remove && !last && Object.is(previous, next)) return current;\n    // Array length cannot be removed, even for preserve:false registrations.\n    if (remove && last && Array.isArray(container) && key === 'length')\n      return current;\n    const copy: Container = container\n      ? copyContainer(container)\n      : depth > 0 && /^(0|[1-9]\\d*)$/.test(key)\n        ? []\n        : {};\n    if (remove && last) Reflect.deleteProperty(copy, key);\n    else defineValue(copy, key, next);\n    return freezeContainer(copy);\n  }\n  return write(root, 0) as object;\n}\n\n/**\n * Own plain data without freezing caller-owned objects. Non-plain values (dates,\n * files, ReactNode errors, etc.) are opaque and must be treated as immutable.\n * Reusing an input reference means reusing its value, just like React state.\n */\nexport function createValueSnapshotter() {\n  const copies = new WeakMap<object, unknown>();\n  function snapshot<T>(value: T): T {\n    // Commit the ownership cache only after the entire graph copied. A throwing\n    // getter must not leave an incomplete, mutable snapshot cached for a retry.\n    const pending = new WeakMap<object, object>();\n    const entries: [object, object][] = [];\n    function clone(input: unknown): unknown {\n      if (!isContainer(input) || ownedContainers.has(input)) return input;\n      if (copies.has(input)) return copies.get(input);\n      if (pending.has(input)) return pending.get(input);\n      const copy = emptyCopy(input);\n      pending.set(input, copy);\n      entries.push([input, copy]);\n      for (const key of enumerableKeys(input)) {\n        defineValue(copy, key, clone(Reflect.get(input, key)));\n      }\n      return copy;\n    }\n    const result = clone(value);\n    for (const [input, copy] of entries) {\n      freezeContainer(copy);\n      copies.set(input, copy);\n    }\n    return result as T;\n  }\n  return snapshot;\n}\n\n/** Object.freeze(new Set()) still permits add/delete. Hide the writable set. */\nexport function readonlySet<T>(values: Iterable<T>): ReadonlySet<T> {\n  const set = new Set(values);\n  const view: ReadonlySet<T> = Object.freeze({\n    get size() {\n      return set.size;\n    },\n    has: (value: T) => set.has(value),\n    entries: () => set.entries(),\n    keys: () => set.keys(),\n    values: () => set.values(),\n    [Symbol.iterator]: () => set[Symbol.iterator](),\n    forEach: (\n      callback: (value: T, key: T, set: ReadonlySet<T>) => void,\n      thisArg?: unknown,\n    ) => {\n      set.forEach((value) => callback.call(thisArg, value, value, view));\n    },\n  });\n  return view;\n}\n\nexport function sameMembers<T>(a: ReadonlySet<T>, b: ReadonlySet<T>): boolean {\n  return a.size === b.size && Array.from(a).every((value) => b.has(value));\n}\n"],"mappings":"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"}
+{"version":3,"file":"values.js","names":[],"sources":["../../../../../src/components/form/Form/modern/values.ts"],"sourcesContent":["/** A string is a literal field name; tuples explicitly address nested values. */\nexport type FormPath = string | readonly (string | number)[];\n\ntype Container = Record<string, unknown> | unknown[];\n\n// Path copies and ingress copies share ownership, including across stores.\n// A WeakSet does not keep old snapshots alive after subscribers release them.\nconst ownedContainers = new WeakSet<object>();\n\nexport function freezeContainer<T extends object>(value: T): T {\n  ownedContainers.add(value);\n  return Object.freeze(value);\n}\n\nexport function isPlainObject(\n  value: unknown,\n): value is Record<string, unknown> {\n  if (!value || typeof value !== 'object') return false;\n  const prototype = Object.getPrototypeOf(value);\n  return prototype === Object.prototype || prototype === null;\n}\n\nfunction isContainer(value: unknown): value is Container {\n  return Array.isArray(value) || isPlainObject(value);\n}\n\nfunction enumerableKeys(value: object): (string | symbol)[] {\n  return Reflect.ownKeys(value).filter((key) =>\n    Object.prototype.propertyIsEnumerable.call(value, key),\n  );\n}\n\n/** Preserve the special non-enumerable descriptor of an array's length. */\nexport function defineValue(\n  container: object,\n  key: PropertyKey,\n  value: unknown,\n) {\n  Object.defineProperty(\n    container,\n    key,\n    Array.isArray(container) && key === 'length'\n      ? { value }\n      : { value, enumerable: true, writable: true, configurable: true },\n  );\n}\n\nfunction emptyCopy(value: Container): Container {\n  return Array.isArray(value)\n    ? new Array(value.length)\n    : Object.create(Object.getPrototypeOf(value));\n}\n\nfunction copyContainer(value: Container): Container {\n  const copy = emptyCopy(value);\n  for (const key of enumerableKeys(value))\n    defineValue(copy, key, Reflect.get(value, key));\n  return copy;\n}\n\n/** The ADR's default dirty comparator: Object.is, then one structural level. */\nexport function formValueEqual(a: unknown, b: unknown): boolean {\n  if (Object.is(a, b)) return true;\n  if (!isContainer(a) || !isContainer(b)) return false;\n  if (Array.isArray(a) !== Array.isArray(b)) return false;\n  if (Array.isArray(a) && Array.isArray(b) && a.length !== b.length)\n    return false;\n  const keys = enumerableKeys(a);\n  return (\n    keys.length === enumerableKeys(b).length &&\n    keys.every(\n      (key) =>\n        Object.hasOwn(b, key) &&\n        Object.is(Reflect.get(a, key), Reflect.get(b, key)),\n    )\n  );\n}\n\nexport function normalizePath(path: FormPath): readonly string[] {\n  const parts = typeof path === 'string' ? [path] : path;\n  if (!parts.length) throw new Error('A form field path must not be empty.');\n  return Object.freeze(\n    Array.from(parts, (part) => {\n      if (\n        typeof part !== 'string' &&\n        (!Number.isSafeInteger(part) || part < 0)\n      ) {\n        throw new Error(\n          'A numeric form path segment must be a non-negative safe integer.',\n        );\n      }\n      const key = String(part);\n      if (key === '__proto__' || key === 'prototype' || key === 'constructor') {\n        throw new Error(`Unsafe form path segment: ${key}`);\n      }\n      return key;\n    }),\n  );\n}\n\n/** Escaping keeps literal dotted names distinct from nested tuple paths. */\nexport function getFieldKey(path: FormPath): string {\n  return normalizePath(path)\n    .map((part) => part.replace(/\\\\/g, '\\\\\\\\').replace(/\\./g, '\\\\.'))\n    .join('.');\n}\n\n/** Inverse of getFieldKey, for stable keys produced by this module. */\nexport function getFieldPath(key: string): readonly string[] {\n  const path = [''];\n  for (let index = 0; index < key.length; index++) {\n    const part = key[index];\n    if (part === '.') path.push('');\n    else path[path.length - 1] += part === '\\\\' ? key[++index] : part;\n  }\n  return Object.freeze(path);\n}\n\nexport function readPath(root: unknown, path: readonly string[]): unknown {\n  let value = root;\n  for (const key of path) {\n    if (!isContainer(value) || !Object.hasOwn(value, key)) return undefined;\n    value = Reflect.get(value, key);\n  }\n  return value;\n}\n\nexport function hasPath(root: unknown, path: readonly string[]): boolean {\n  const parent = readPath(root, path.slice(0, -1));\n  return isContainer(parent) && Object.hasOwn(parent, path[path.length - 1]);\n}\n\n/** Missing and explicitly undefined values are distinct form states. */\nexport function pathValueChanged(\n  previous: object,\n  next: object,\n  path: readonly string[],\n): boolean {\n  return (\n    !Object.is(readPath(previous, path), readPath(next, path)) ||\n    hasPath(previous, path) !== hasPath(next, path)\n  );\n}\n\n/** Copy just the ancestor chain. Array deletion leaves indices in place. */\nexport function writePath(\n  root: object,\n  path: readonly string[],\n  value: unknown,\n  remove = false,\n): object {\n  function write(current: unknown, depth: number): unknown {\n    const key = path[depth];\n    const container = isContainer(current) ? current : undefined;\n    const exists = !!container && Object.hasOwn(container, key);\n    const previous = exists ? Reflect.get(container!, key) : undefined;\n    if (remove && !exists) return current;\n    const last = depth === path.length - 1;\n    const next = last ? value : write(previous, depth + 1);\n    if (!remove && exists && Object.is(previous, next)) return current;\n    if (remove && !last && Object.is(previous, next)) return current;\n    // Array length cannot be removed, even for preserve:false registrations.\n    if (remove && last && Array.isArray(container) && key === 'length')\n      return current;\n    const copy: Container = container\n      ? copyContainer(container)\n      : depth > 0 && /^(0|[1-9]\\d*)$/.test(key)\n        ? []\n        : {};\n    if (remove && last) Reflect.deleteProperty(copy, key);\n    else defineValue(copy, key, next);\n    return freezeContainer(copy);\n  }\n  return write(root, 0) as object;\n}\n\n/**\n * Own plain data without freezing caller-owned objects. Non-plain values (dates,\n * files, ReactNode errors, etc.) are opaque and must be treated as immutable.\n * Reusing an input reference means reusing its value, just like React state.\n */\nexport function createValueSnapshotter() {\n  const copies = new WeakMap<object, unknown>();\n  function snapshot<T>(value: T): T {\n    // Commit the ownership cache only after the entire graph copied. A throwing\n    // getter must not leave an incomplete, mutable snapshot cached for a retry.\n    const pending = new WeakMap<object, object>();\n    const entries: [object, object][] = [];\n    function clone(input: unknown): unknown {\n      if (!isContainer(input) || ownedContainers.has(input)) return input;\n      if (copies.has(input)) return copies.get(input);\n      if (pending.has(input)) return pending.get(input);\n      const copy = emptyCopy(input);\n      pending.set(input, copy);\n      entries.push([input, copy]);\n      for (const key of enumerableKeys(input)) {\n        defineValue(copy, key, clone(Reflect.get(input, key)));\n      }\n      return copy;\n    }\n    const result = clone(value);\n    for (const [input, copy] of entries) {\n      freezeContainer(copy);\n      copies.set(input, copy);\n    }\n    return result as T;\n  }\n  return snapshot;\n}\n\n/** Object.freeze(new Set()) still permits add/delete. Hide the writable set. */\nexport function readonlySet<T>(values: Iterable<T>): ReadonlySet<T> {\n  const set = new Set(values);\n  const view: ReadonlySet<T> = Object.freeze({\n    get size() {\n      return set.size;\n    },\n    has: (value: T) => set.has(value),\n    entries: () => set.entries(),\n    keys: () => set.keys(),\n    values: () => set.values(),\n    [Symbol.iterator]: () => set[Symbol.iterator](),\n    forEach: (\n      callback: (value: T, key: T, set: ReadonlySet<T>) => void,\n      thisArg?: unknown,\n    ) => {\n      set.forEach((value) => callback.call(thisArg, value, value, view));\n    },\n  });\n  return view;\n}\n\nexport function sameMembers<T>(a: ReadonlySet<T>, b: ReadonlySet<T>): boolean {\n  return a.size === b.size && Array.from(a).every((value) => b.has(value));\n}\n"],"mappings":"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"}

package/dist/components/form/Form/use-field/types.d.ts

@@ -1,8 +1,8 @@
 
+import { FormController } from "../modern/controller.js";
 import { FieldCoreProps, NecessityIndicator, ValidateTrigger, ValidationProps, ValidationState } from "../../../../shared/form.js";
 import "../../../../shared/index.js";
 import { CubeFieldData, FieldTypes } from "../types.js";
-import { FormController } from "../modern/controller.js";
 import { CubeFormInstance } from "../use-form.js";
 import { ReactNode } from "react";
 

package/dist/components/form/Form/use-field/use-field-binding.js

@@ -1,7 +1,8 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 import { useLayoutEffect as useLayoutEffect$1 } from "../../../../utils/react/useLayoutEffect.js";
 import { useEvent } from "../../../../_internal/hooks/use-event.js";
 import { isModernFormController } from "../backend.js";
+import { getFieldKey, getFieldPath, normalizePath, writePath } from "../modern/values.js";
 import { useField } from "./use-field.js";
 import { createModernFieldBackend, fieldRegistrationOptions, sameFieldView } from "../modern/field-binding.js";
 import { useMemo, useRef } from "react";
@@ -19,12 +20,18 @@ const selectView = (view) => view;
 function useFieldBinding(props, params, generatedId) {
 	const modern = !params.unbound && isModernFormController(props.form);
 	const controller = modern ? props.form : void 0;
-	const name = props.name ?? "";
-	const legacy = useField(props, {
+	const path = props.field?.path ?? props.name ?? "";
+	const name = typeof path === "string" ? path : getFieldKey(path);
+	const pathKey = controller ? getFieldKey(path) : "";
+	if (!params.unbound && props.form && !modern && typeof path !== "string") throw new Error("Tuple field names require a modern form controller.");
+	const legacy = useField({
+		...props,
+		name
+	}, {
 		...params,
 		unbound: params.unbound || modern
 	});
-	const modernHandle = useMemo(() => controller ? createModernFieldBackend(controller, name) : void 0, [controller, name]);
+	const modernHandle = useMemo(() => controller ? createModernFieldBackend(controller, getFieldPath(pathKey)) : void 0, [controller, pathKey]);
 	const legacyHandle = useMemo(() => {
 		const snapshot = {
 			value: legacy.value,
@@ -58,10 +65,7 @@ function useFieldBinding(props, params, generatedId) {
 	const onChange = useEvent((value, dontTouch) => {
 		if (controller && props.shouldUpdate !== void 0) {
 			const previous = controller.getValues();
-			if (props.shouldUpdate === false || typeof props.shouldUpdate === "function" && !props.shouldUpdate(previous, {
-				...previous,
-				[name]: value
-			})) return;
+			if (props.shouldUpdate === false || typeof props.shouldUpdate === "function" && !props.shouldUpdate(previous, writePath(previous, normalizePath(path), value))) return;
 		}
 		handle.change(value, dontTouch, trigger);
 	});

package/dist/components/form/Form/use-field/use-field-binding.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-field-binding.js","names":[],"sources":["../../../../../src/components/form/Form/use-field/use-field-binding.ts"],"sourcesContent":["import { useMemo, useRef } from 'react';\nimport { useSyncExternalStoreWithSelector } from 'use-sync-external-store/with-selector.js';\n\nimport { useEvent } from '../../../../_internal/hooks/use-event';\nimport { useLayoutEffect } from '../../../../utils/react/useLayoutEffect';\nimport { isModernFormController } from '../backend';\nimport {\n  createModernFieldBackend,\n  fieldRegistrationOptions,\n  sameFieldView,\n} from '../modern/field-binding';\n\nimport { useField } from './use-field';\n\nimport type { ReactNode } from 'react';\nimport type { FormController } from '../modern/controller';\nimport type { FieldBackendHandle, FieldView } from '../modern/field-binding';\nimport type { RegistrationToken } from '../modern/types';\nimport type { FieldTypes } from '../types';\nimport type { FieldReturnValue, UseFieldProps } from './types';\nimport type { UseFieldParams } from './use-field';\n\nconst noop = () => {};\nconst selectView = (view: FieldView | undefined) => view;\n\n/**\n * One unconditional subscription/registration boundary. The frozen legacy\n * adapter still runs its original hooks, inert on the modern path, so an input\n * can cross backends without remounting or changing hook order. Its render-time\n * mutations remain contained in use-field.ts; modern handles are pure to create.\n */\nexport function useFieldBinding<\n  T extends FieldTypes,\n  P extends UseFieldProps<T>,\n>(\n  props: P,\n  params: UseFieldParams,\n  generatedId: string,\n): Omit<FieldReturnValue<T>, 'form'> & {\n  form?: FieldReturnValue<T>['form'] | FormController<any>;\n  isLoading?: boolean;\n} {\n  const modern = !params.unbound && isModernFormController(props.form);\n  const controller = modern\n    ? (props.form as unknown as FormController<any>)\n    : undefined;\n  const name = props.name ?? '';\n  const legacy = useField<T, P>(props, {\n    ...params,\n    unbound: params.unbound || modern,\n  });\n  const modernHandle = useMemo(\n    () => (controller ? createModernFieldBackend(controller, name) : undefined),\n    [controller, name],\n  );\n  const legacyHandle = useMemo<FieldBackendHandle>(() => {\n    const snapshot: FieldView = {\n      value: legacy.value,\n      errors: legacy.field?.errors ?? [],\n      status: legacy.field?.status ?? 'unvalidated',\n    };\n    return {\n      subscribe: () => noop,\n      getSnapshot: () => snapshot,\n      getServerSnapshot: () => snapshot,\n      register: () => undefined,\n      change: (value, dontTouch, trigger) =>\n        legacy.onChange?.(value, dontTouch, trigger),\n      blur: legacy.onBlur,\n    };\n  }, [legacy]);\n  const handle = modernHandle ?? legacyHandle;\n  const field = useSyncExternalStoreWithSelector(\n    handle.subscribe,\n    handle.getSnapshot,\n    handle.getServerSnapshot,\n    selectView,\n    sameFieldView,\n  );\n  const registration = useRef<RegistrationToken<ReactNode> | undefined>(\n    undefined,\n  );\n  useLayoutEffect(() => {\n    const token = handle.register();\n    registration.current = token;\n    return () => {\n      token?.release({ deferValueRemoval: true });\n      if (registration.current === token) registration.current = undefined;\n    };\n  }, [handle]);\n  useLayoutEffect(() => {\n    registration.current?.update(\n      fieldRegistrationOptions(props, params.defaultValidationTrigger),\n    );\n  });\n  const trigger =\n    props.validateTrigger ?? params.defaultValidationTrigger ?? 'onBlur';\n  const onChange = useEvent((value: unknown, dontTouch: boolean) => {\n    if (controller && props.shouldUpdate !== undefined) {\n      const previous = controller.getValues();\n      if (\n        props.shouldUpdate === false ||\n        (typeof props.shouldUpdate === 'function' &&\n          !props.shouldUpdate(previous, { ...previous, [name]: value }))\n      )\n        return;\n    }\n    handle.change(value, dontTouch, trigger);\n  });\n  const onBlur = useEvent(() => handle.blur());\n  if (!controller) return legacy;\n\n  const required =\n    props.isRequired ||\n    props.rules?.flat(Infinity).some((rule) => rule.required === true);\n  const id =\n    props.id ??\n    `${props.idPrefix ? `${props.idPrefix}_` : ''}${name}-${generatedId}`;\n  return {\n    form: controller,\n    name,\n    id,\n    nonInput: false,\n    value: field ? field.value : props.defaultValue,\n    onChange,\n    onBlur,\n    validateTrigger: trigger,\n    isInvalid: props.isInvalid ?? !!field?.errors.length,\n    isValid: props.isValid ?? !!(props.showValid && field?.status === 'valid'),\n    isLoading: props.isLoading ?? field?.status === 'validating',\n    ...(required ? { isRequired: true } : {}),\n    ...(required && !props.isRequired && props.necessityIndicator === undefined\n      ? { necessityIndicator: null }\n      : {}),\n    description: props.description,\n    message: props.message !== undefined ? props.message : field?.errors[0],\n    errorMessage:\n      props.errorMessage !== undefined ? props.errorMessage : field?.errors[0],\n  };\n}\n"],"mappings":";;;;;;;;;;AAsBA,MAAM,aAAa;AACnB,MAAM,cAAc,SAAgC;;;;;;;AAQpD,SAAgB,gBAId,OACA,QACA,aAIA;CACA,MAAM,SAAS,CAAC,OAAO,WAAW,uBAAuB,MAAM,KAAK;CACpE,MAAM,aAAa,SACd,MAAM,OACP;CACJ,MAAM,OAAO,MAAM,QAAQ;CAC3B,MAAM,SAAS,SAAe,OAAO;EACnC,GAAG;EACH,SAAS,OAAO,WAAW;EAC5B,CAAC;CACF,MAAM,eAAe,cACZ,aAAa,yBAAyB,YAAY,KAAK,GAAG,QACjE,CAAC,YAAY,KAAK,CACnB;CACD,MAAM,eAAe,cAAkC;EACrD,MAAM,WAAsB;GAC1B,OAAO,OAAO;GACd,QAAQ,OAAO,OAAO,UAAU,EAAE;GAClC,QAAQ,OAAO,OAAO,UAAU;GACjC;AACD,SAAO;GACL,iBAAiB;GACjB,mBAAmB;GACnB,yBAAyB;GACzB,gBAAgB;GAChB,SAAS,OAAO,WAAW,YACzB,OAAO,WAAW,OAAO,WAAW,QAAQ;GAC9C,MAAM,OAAO;GACd;IACA,CAAC,OAAO,CAAC;CACZ,MAAM,SAAS,gBAAgB;CAC/B,MAAM,QAAQ,iCACZ,OAAO,WACP,OAAO,aACP,OAAO,mBACP,YACA,cACD;CACD,MAAM,eAAe,OACnB,OACD;AACD,yBAAsB;EACpB,MAAM,QAAQ,OAAO,UAAU;AAC/B,eAAa,UAAU;AACvB,eAAa;AACX,UAAO,QAAQ,EAAE,mBAAmB,MAAM,CAAC;AAC3C,OAAI,aAAa,YAAY,MAAO,cAAa,UAAU;;IAE5D,CAAC,OAAO,CAAC;AACZ,yBAAsB;AACpB,eAAa,SAAS,OACpB,yBAAyB,OAAO,OAAO,yBAAyB,CACjE;GACD;CACF,MAAM,UACJ,MAAM,mBAAmB,OAAO,4BAA4B;CAC9D,MAAM,WAAW,UAAU,OAAgB,cAAuB;AAChE,MAAI,cAAc,MAAM,iBAAiB,QAAW;GAClD,MAAM,WAAW,WAAW,WAAW;AACvC,OACE,MAAM,iBAAiB,SACtB,OAAO,MAAM,iBAAiB,cAC7B,CAAC,MAAM,aAAa,UAAU;IAAE,GAAG;KAAW,OAAO;IAAO,CAAC,CAE/D;;AAEJ,SAAO,OAAO,OAAO,WAAW,QAAQ;GACxC;CACF,MAAM,SAAS,eAAe,OAAO,MAAM,CAAC;AAC5C,KAAI,CAAC,WAAY,QAAO;CAExB,MAAM,WACJ,MAAM,cACN,MAAM,OAAO,KAAK,SAAS,CAAC,MAAM,SAAS,KAAK,aAAa,KAAK;AAIpE,QAAO;EACL,MAAM;EACN;EACA,IALA,MAAM,MACN,GAAG,MAAM,WAAW,GAAG,MAAM,SAAS,KAAK,KAAK,KAAK,GAAG;EAKxD,UAAU;EACV,OAAO,QAAQ,MAAM,QAAQ,MAAM;EACnC;EACA;EACA,iBAAiB;EACjB,WAAW,MAAM,aAAa,CAAC,CAAC,OAAO,OAAO;EAC9C,SAAS,MAAM,WAAW,CAAC,EAAE,MAAM,aAAa,OAAO,WAAW;EAClE,WAAW,MAAM,aAAa,OAAO,WAAW;EAChD,GAAI,WAAW,EAAE,YAAY,MAAM,GAAG,EAAE;EACxC,GAAI,YAAY,CAAC,MAAM,cAAc,MAAM,uBAAuB,SAC9D,EAAE,oBAAoB,MAAM,GAC5B,EAAE;EACN,aAAa,MAAM;EACnB,SAAS,MAAM,YAAY,SAAY,MAAM,UAAU,OAAO,OAAO;EACrE,cACE,MAAM,iBAAiB,SAAY,MAAM,eAAe,OAAO,OAAO;EACzE"}
+{"version":3,"file":"use-field-binding.js","names":[],"sources":["../../../../../src/components/form/Form/use-field/use-field-binding.ts"],"sourcesContent":["import { useMemo, useRef } from 'react';\nimport { useSyncExternalStoreWithSelector } from 'use-sync-external-store/with-selector.js';\n\nimport { useEvent } from '../../../../_internal/hooks/use-event';\nimport { useLayoutEffect } from '../../../../utils/react/useLayoutEffect';\nimport { isModernFormController } from '../backend';\nimport {\n  createModernFieldBackend,\n  fieldRegistrationOptions,\n  sameFieldView,\n} from '../modern/field-binding';\nimport {\n  getFieldKey,\n  getFieldPath,\n  normalizePath,\n  writePath,\n} from '../modern/values';\n\nimport { useField } from './use-field';\n\nimport type { ReactNode } from 'react';\nimport type { FormController } from '../modern/controller';\nimport type { FieldBackendHandle, FieldView } from '../modern/field-binding';\nimport type { RegistrationToken } from '../modern/types';\nimport type { FieldTypes } from '../types';\nimport type { FieldReturnValue, UseFieldProps } from './types';\nimport type { UseFieldParams } from './use-field';\n\nconst noop = () => {};\nconst selectView = (view: FieldView | undefined) => view;\n\n/**\n * One unconditional subscription/registration boundary. The frozen legacy\n * adapter still runs its original hooks, inert on the modern path, so an input\n * can cross backends without remounting or changing hook order. Its render-time\n * mutations remain contained in use-field.ts; modern handles are pure to create.\n */\nexport function useFieldBinding<\n  T extends FieldTypes,\n  P extends UseFieldProps<T>,\n>(\n  props: P,\n  params: UseFieldParams,\n  generatedId: string,\n): Omit<FieldReturnValue<T>, 'form'> & {\n  form?: FieldReturnValue<T>['form'] | FormController<any>;\n  isLoading?: boolean;\n} {\n  const modern = !params.unbound && isModernFormController(props.form);\n  const controller = modern\n    ? (props.form as unknown as FormController<any>)\n    : undefined;\n  const path = props.field?.path ?? props.name ?? '';\n  const name = typeof path === 'string' ? path : getFieldKey(path);\n  const pathKey = controller ? getFieldKey(path) : '';\n  if (!params.unbound && props.form && !modern && typeof path !== 'string') {\n    throw new Error('Tuple field names require a modern form controller.');\n  }\n  const legacy = useField<T, P & { name?: string }>(\n    { ...props, name },\n    {\n      ...params,\n      unbound: params.unbound || modern,\n    },\n  );\n  const modernHandle = useMemo(\n    () =>\n      controller\n        ? createModernFieldBackend(controller, getFieldPath(pathKey))\n        : undefined,\n    [controller, pathKey],\n  );\n  const legacyHandle = useMemo<FieldBackendHandle>(() => {\n    const snapshot: FieldView = {\n      value: legacy.value,\n      errors: legacy.field?.errors ?? [],\n      status: legacy.field?.status ?? 'unvalidated',\n    };\n    return {\n      subscribe: () => noop,\n      getSnapshot: () => snapshot,\n      getServerSnapshot: () => snapshot,\n      register: () => undefined,\n      change: (value, dontTouch, trigger) =>\n        legacy.onChange?.(value, dontTouch, trigger),\n      blur: legacy.onBlur,\n    };\n  }, [legacy]);\n  const handle = modernHandle ?? legacyHandle;\n  const field = useSyncExternalStoreWithSelector(\n    handle.subscribe,\n    handle.getSnapshot,\n    handle.getServerSnapshot,\n    selectView,\n    sameFieldView,\n  );\n  const registration = useRef<RegistrationToken<ReactNode> | undefined>(\n    undefined,\n  );\n  useLayoutEffect(() => {\n    const token = handle.register();\n    registration.current = token;\n    return () => {\n      token?.release({ deferValueRemoval: true });\n      if (registration.current === token) registration.current = undefined;\n    };\n  }, [handle]);\n  useLayoutEffect(() => {\n    registration.current?.update(\n      fieldRegistrationOptions(props, params.defaultValidationTrigger),\n    );\n  });\n  const trigger =\n    props.validateTrigger ?? params.defaultValidationTrigger ?? 'onBlur';\n  const onChange = useEvent((value: unknown, dontTouch: boolean) => {\n    if (controller && props.shouldUpdate !== undefined) {\n      const previous = controller.getValues();\n      if (\n        props.shouldUpdate === false ||\n        (typeof props.shouldUpdate === 'function' &&\n          !props.shouldUpdate(\n            previous,\n            writePath(previous, normalizePath(path), value),\n          ))\n      )\n        return;\n    }\n    handle.change(value, dontTouch, trigger);\n  });\n  const onBlur = useEvent(() => handle.blur());\n  if (!controller) return legacy;\n\n  const required =\n    props.isRequired ||\n    props.rules?.flat(Infinity).some((rule) => rule.required === true);\n  const id =\n    props.id ??\n    `${props.idPrefix ? `${props.idPrefix}_` : ''}${name}-${generatedId}`;\n  return {\n    form: controller,\n    name,\n    id,\n    nonInput: false,\n    value: field ? field.value : props.defaultValue,\n    onChange,\n    onBlur,\n    validateTrigger: trigger,\n    isInvalid: props.isInvalid ?? !!field?.errors.length,\n    isValid: props.isValid ?? !!(props.showValid && field?.status === 'valid'),\n    isLoading: props.isLoading ?? field?.status === 'validating',\n    ...(required ? { isRequired: true } : {}),\n    ...(required && !props.isRequired && props.necessityIndicator === undefined\n      ? { necessityIndicator: null }\n      : {}),\n    description: props.description,\n    message: props.message !== undefined ? props.message : field?.errors[0],\n    errorMessage:\n      props.errorMessage !== undefined ? props.errorMessage : field?.errors[0],\n  };\n}\n"],"mappings":"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"}

package/dist/components/form/Form/use-field/use-field-props.d.ts

@@ -23,6 +23,8 @@ type UseFieldPropsParams = {
    */
   unsafe__isDisabled?: boolean;
 };
+/** Preserve the input's prop shape while exposing a DOM-safe name. */
+type ResolvedFieldProps<Props> = { [Key in keyof Props]: Key extends 'name' ? string | undefined : Props[Key] };
 /**
  * The single entry point for input components (see
  * `docs/rules/input-components.md`).
@@ -34,7 +36,7 @@ type UseFieldPropsParams = {
  * without changing its hook order. The legacy binding (`useField`) is the
  * legacy backend's adapter and is inert when the field is not bound to it.
  */
-declare function useFieldProps<T extends FieldTypes, Props extends UseFieldProps<T>>(inputProps: Props, params?: UseFieldPropsParams): Props;
+declare function useFieldProps<T extends FieldTypes, Props extends UseFieldProps<T>>(inputProps: Props, params?: UseFieldPropsParams): ResolvedFieldProps<Props>;
 //#endregion
 export { UseFieldPropsParams, useFieldProps };
 //# sourceMappingURL=use-field-props.d.ts.map

package/dist/components/form/Form/use-field/use-field-props.js

@@ -1,10 +1,11 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 import { mergeProps } from "../../../../utils/react/mergeProps.js";
 import { useEvent } from "../../../../_internal/hooks/use-event.js";
 import { warn } from "../../../../utils/warnings.js";
 import { useProviderProps } from "../../../../provider.js";
 import { useValidationProps } from "../../validation/use-validation-props.js";
 import { isModernFormController } from "../backend.js";
+import { getFieldKey } from "../modern/values.js";
 import { useFormProps } from "../Form.js";
 import { useFieldBinding } from "./use-field-binding.js";
 import { useInsideLegacyField } from "../Field.js";
@@ -27,7 +28,13 @@ const defaultValuePropsMapper = ({ value, onChange }) => ({
 * legacy backend's adapter and is inert when the field is not bound to it.
 */
 function useFieldProps(inputProps, params = {}) {
-	const props = useValidationProps(useFormProps(useProviderProps(inputProps)));
+	const provided = useProviderProps(inputProps);
+	const props = useValidationProps(useFormProps(provided.field ? {
+		...provided,
+		...provided.field.options,
+		form: provided.field.form,
+		name: typeof provided.field.path === "string" ? provided.field.path : getFieldKey(provided.field.path)
+	} : provided));
 	const [isDisabled] = useState(params.unsafe__isDisabled ?? false);
 	const { valuePropsMapper = defaultValuePropsMapper, defaultValidationTrigger = "onBlur" } = params;
 	const isInsideLegacyField = useInsideLegacyField();
@@ -79,12 +86,16 @@ function useFieldProps(inputProps, params = {}) {
 		} : result;
 	}
 	const resolved = resolveResult();
-	const result = isModernFormController(resolved.form) ? {
+	const { field: _descriptor, dependsOn: _dependsOn, deps: _deps, ...domProps } = isModernFormController(resolved.form) ? {
 		...resolved,
 		form: void 0
 	} : resolved;
-	useDebugValue(result);
-	return result;
+	const namedProps = domProps.name != null && typeof domProps.name !== "string" ? {
+		...domProps,
+		name: getFieldKey(domProps.name)
+	} : domProps;
+	useDebugValue(namedProps);
+	return namedProps;
 }
 
 //#endregion

package/dist/components/form/Form/use-field/use-field-props.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-field-props.js","names":[],"sources":["../../../../../src/components/form/Form/use-field/use-field-props.tsx"],"sourcesContent":["import { useDebugValue, useId, useState } from 'react';\n\nimport { useEvent } from '../../../../_internal/index';\nimport { useProviderProps } from '../../../../provider';\nimport { mergeProps } from '../../../../utils/react/index';\nimport { warn } from '../../../../utils/warnings';\nimport { useValidationProps } from '../../validation/index';\nimport { isModernFormController } from '../backend';\nimport { useInsideLegacyField } from '../Field';\nimport { useFormProps } from '../Form';\n\nimport { useFieldBinding } from './use-field-binding';\n\nimport type { ValidateTrigger } from '../../../../shared/index';\nimport type { FieldTypes } from '../types';\nimport type { UseFieldProps } from './types';\n\nexport type UseFieldPropsParams = {\n  valuePropsMapper?: ({ value, onChange }) => any;\n  /**\n   * @default 'onBlur'\n   */\n  defaultValidationTrigger?: ValidateTrigger;\n  /**\n   * prop helps to prevent calling hook conditionally, but changing this prop during render is unsafe and forbidden\n   * If you want to change this prop after mount, remount the component with a new value.\n   */\n  unsafe__isDisabled?: boolean;\n};\n\nconst defaultValuePropsMapper = ({ value, onChange }) => ({\n  value: value ?? null,\n  onChange,\n});\n\n/**\n * The single entry point for input components (see\n * `docs/rules/input-components.md`).\n *\n * Every hook below runs on every render, whatever the mode: standalone (no\n * `name`), inside the deprecated `<Field>`, disabled through\n * `unsafe__isDisabled`, or bound to a form. The mode only decides which props\n * come back, so an input can gain or lose a `name`, or move between forms,\n * without changing its hook order. The legacy binding (`useField`) is the\n * legacy backend's adapter and is inert when the field is not bound to it.\n */\nexport function useFieldProps<\n  T extends FieldTypes,\n  Props extends UseFieldProps<T>,\n>(inputProps: Props, params: UseFieldPropsParams = {}): Props {\n  // Provider defaults, then form context, then the normalization of the\n  // deprecated `validationState` prop into `isInvalid`/`isValid`.\n  const props: Props = useValidationProps(\n    useFormProps(useProviderProps(inputProps)),\n  );\n\n  // The initial value is what counts: changing it after mount is unsupported.\n  const [isDisabled] = useState(params.unsafe__isDisabled ?? false);\n\n  const {\n    valuePropsMapper = defaultValuePropsMapper,\n    defaultValidationTrigger = 'onBlur',\n  } = params;\n\n  const isInsideLegacyField = useInsideLegacyField();\n\n  if (props.rules && !props.name) {\n    warn(\n      `The \"rules\" prop is not suitable for fields that are not part of a form. Use \"name\" prop to link the field to a form.`,\n    );\n  }\n\n  const hasName = props.name != null;\n  const generatedId = useId();\n  const isBound = hasName && !isInsideLegacyField && !isDisabled;\n\n  const field = useFieldBinding<T, Props>(\n    props,\n    {\n      defaultValidationTrigger: params.defaultValidationTrigger,\n      unbound: !isBound,\n    },\n    generatedId,\n  );\n\n  const isOutsideOfForm = field?.form == null;\n\n  const onChangeEvent = useEvent((value, dontTouch: boolean) => {\n    field?.onChange?.(\n      value,\n      dontTouch,\n      field?.validateTrigger ?? defaultValidationTrigger,\n    );\n  });\n\n  function resolveResult(): Props {\n    if (isInsideLegacyField || isDisabled) {\n      return props;\n    }\n\n    if (!hasName) {\n      // Standalone field - just add generated ID if not provided\n      if (!props.id) {\n        const result = { ...props, id: generatedId };\n\n        if (result.id && !result.labelProps) {\n          result.labelProps = { for: result.id };\n        } else if (result.id && result.labelProps && !result.labelProps.for) {\n          result.labelProps = { ...result.labelProps, for: result.id };\n        }\n\n        return result as Props;\n      }\n      return props;\n    }\n\n    if (props.rules && isOutsideOfForm) {\n      warn(\n        `The \"rules\" prop is not supported for fields that are not part of a form. The \"${props.name}\" field is placed outside the form.`,\n      );\n    }\n\n    const valueProps = !isOutsideOfForm\n      ? valuePropsMapper({\n          value: field.value,\n          onChange: onChangeEvent,\n        })\n      : {};\n\n    // Exclude `form` (it must never reach a DOM node) and the field's own\n    // handlers: `valueProps` already routes the component's change event into\n    // `field.onChange` under the name the component listens to, and `onBlur` is\n    // added once below. `mergeProps` chains same-named handlers, so merging them\n    // here as well made every user change and every blur run the field handler\n    // twice — and onChange/onBlur-triggered validation validate twice.\n    const {\n      form: _form,\n      onChange: _fieldOnChange,\n      onBlur: _fieldOnBlur,\n      ...fieldRest\n    } = field ?? {};\n\n    const result: Props = isOutsideOfForm\n      ? props\n      : mergeProps(props, fieldRest, valueProps, {\n          validateTrigger: field.validateTrigger ?? defaultValidationTrigger,\n          // Chained after the caller's own `onBlur` by `mergeProps`.\n          onBlur: field.onBlur,\n        });\n\n    return result.id\n      ? { ...result, labelProps: { ...result.labelProps, for: result.id } }\n      : result;\n  }\n\n  const resolved = resolveResult();\n  // React Aria forwards `form` to native inputs. A modern controller is a\n  // binding source, never an HTML form id, including in standalone/group mode.\n  const result = isModernFormController(resolved.form)\n    ? { ...resolved, form: undefined }\n    : resolved;\n\n  useDebugValue(result);\n\n  return result;\n}\n"],"mappings":";;;;;;;;;;;;;AA8BA,MAAM,2BAA2B,EAAE,OAAO,gBAAgB;CACxD,OAAO,SAAS;CAChB;CACD;;;;;;;;;;;;AAaD,SAAgB,cAGd,YAAmB,SAA8B,EAAE,EAAS;CAG5D,MAAM,QAAe,mBACnB,aAAa,iBAAiB,WAAW,CAAC,CAC3C;CAGD,MAAM,CAAC,cAAc,SAAS,OAAO,sBAAsB,MAAM;CAEjE,MAAM,EACJ,mBAAmB,yBACnB,2BAA2B,aACzB;CAEJ,MAAM,sBAAsB,sBAAsB;AAElD,KAAI,MAAM,SAAS,CAAC,MAAM,KACxB,MACE,wHACD;CAGH,MAAM,UAAU,MAAM,QAAQ;CAC9B,MAAM,cAAc,OAAO;CAC3B,MAAM,UAAU,WAAW,CAAC,uBAAuB,CAAC;CAEpD,MAAM,QAAQ,gBACZ,OACA;EACE,0BAA0B,OAAO;EACjC,SAAS,CAAC;EACX,EACD,YACD;CAED,MAAM,kBAAkB,OAAO,QAAQ;CAEvC,MAAM,gBAAgB,UAAU,OAAO,cAAuB;AAC5D,SAAO,WACL,OACA,WACA,OAAO,mBAAmB,yBAC3B;GACD;CAEF,SAAS,gBAAuB;AAC9B,MAAI,uBAAuB,WACzB,QAAO;AAGT,MAAI,CAAC,SAAS;AAEZ,OAAI,CAAC,MAAM,IAAI;IACb,MAAM,SAAS;KAAE,GAAG;KAAO,IAAI;KAAa;AAE5C,QAAI,OAAO,MAAM,CAAC,OAAO,WACvB,QAAO,aAAa,EAAE,KAAK,OAAO,IAAI;aAC7B,OAAO,MAAM,OAAO,cAAc,CAAC,OAAO,WAAW,IAC9D,QAAO,aAAa;KAAE,GAAG,OAAO;KAAY,KAAK,OAAO;KAAI;AAG9D,WAAO;;AAET,UAAO;;AAGT,MAAI,MAAM,SAAS,gBACjB,MACE,kFAAkF,MAAM,KAAK,qCAC9F;EAGH,MAAM,aAAa,CAAC,kBAChB,iBAAiB;GACf,OAAO,MAAM;GACb,UAAU;GACX,CAAC,GACF,EAAE;EAQN,MAAM,EACJ,MAAM,OACN,UAAU,gBACV,QAAQ,cACR,GAAG,cACD,SAAS,EAAE;EAEf,MAAM,SAAgB,kBAClB,QACA,WAAW,OAAO,WAAW,YAAY;GACvC,iBAAiB,MAAM,mBAAmB;GAE1C,QAAQ,MAAM;GACf,CAAC;AAEN,SAAO,OAAO,KACV;GAAE,GAAG;GAAQ,YAAY;IAAE,GAAG,OAAO;IAAY,KAAK,OAAO;IAAI;GAAE,GACnE;;CAGN,MAAM,WAAW,eAAe;CAGhC,MAAM,SAAS,uBAAuB,SAAS,KAAK,GAChD;EAAE,GAAG;EAAU,MAAM;EAAW,GAChC;AAEJ,eAAc,OAAO;AAErB,QAAO"}
+{"version":3,"file":"use-field-props.js","names":[],"sources":["../../../../../src/components/form/Form/use-field/use-field-props.tsx"],"sourcesContent":["import { useDebugValue, useId, useState } from 'react';\n\nimport { useEvent } from '../../../../_internal/index';\nimport { useProviderProps } from '../../../../provider';\nimport { mergeProps } from '../../../../utils/react/index';\nimport { warn } from '../../../../utils/warnings';\nimport { useValidationProps } from '../../validation/index';\nimport { isModernFormController } from '../backend';\nimport { useInsideLegacyField } from '../Field';\nimport { useFormProps } from '../Form';\nimport { getFieldKey } from '../modern/values';\n\nimport { useFieldBinding } from './use-field-binding';\n\nimport type { ValidateTrigger } from '../../../../shared/index';\nimport type { FieldTypes } from '../types';\nimport type { UseFieldProps } from './types';\n\nexport type UseFieldPropsParams = {\n  valuePropsMapper?: ({ value, onChange }) => any;\n  /**\n   * @default 'onBlur'\n   */\n  defaultValidationTrigger?: ValidateTrigger;\n  /**\n   * prop helps to prevent calling hook conditionally, but changing this prop during render is unsafe and forbidden\n   * If you want to change this prop after mount, remount the component with a new value.\n   */\n  unsafe__isDisabled?: boolean;\n};\n\nconst defaultValuePropsMapper = ({ value, onChange }) => ({\n  value: value ?? null,\n  onChange,\n});\n\n/** Preserve the input's prop shape while exposing a DOM-safe name. */\ntype ResolvedFieldProps<Props> = {\n  [Key in keyof Props]: Key extends 'name' ? string | undefined : Props[Key];\n};\n\n/**\n * The single entry point for input components (see\n * `docs/rules/input-components.md`).\n *\n * Every hook below runs on every render, whatever the mode: standalone (no\n * `name`), inside the deprecated `<Field>`, disabled through\n * `unsafe__isDisabled`, or bound to a form. The mode only decides which props\n * come back, so an input can gain or lose a `name`, or move between forms,\n * without changing its hook order. The legacy binding (`useField`) is the\n * legacy backend's adapter and is inert when the field is not bound to it.\n */\nexport function useFieldProps<\n  T extends FieldTypes,\n  Props extends UseFieldProps<T>,\n>(\n  inputProps: Props,\n  params: UseFieldPropsParams = {},\n): ResolvedFieldProps<Props> {\n  // Provider defaults, then form context, then the normalization of the\n  // deprecated `validationState` prop into `isInvalid`/`isValid`.\n  const provided = useProviderProps(inputProps);\n  const props: Props = useValidationProps(\n    useFormProps(\n      provided.field\n        ? {\n            ...provided,\n            ...provided.field.options,\n            form: provided.field.form,\n            name:\n              typeof provided.field.path === 'string'\n                ? provided.field.path\n                : getFieldKey(provided.field.path),\n          }\n        : provided,\n    ),\n  );\n\n  // The initial value is what counts: changing it after mount is unsupported.\n  const [isDisabled] = useState(params.unsafe__isDisabled ?? false);\n\n  const {\n    valuePropsMapper = defaultValuePropsMapper,\n    defaultValidationTrigger = 'onBlur',\n  } = params;\n\n  const isInsideLegacyField = useInsideLegacyField();\n\n  if (props.rules && !props.name) {\n    warn(\n      `The \"rules\" prop is not suitable for fields that are not part of a form. Use \"name\" prop to link the field to a form.`,\n    );\n  }\n\n  const hasName = props.name != null;\n  const generatedId = useId();\n  const isBound = hasName && !isInsideLegacyField && !isDisabled;\n\n  const field = useFieldBinding<T, Props>(\n    props,\n    {\n      defaultValidationTrigger: params.defaultValidationTrigger,\n      unbound: !isBound,\n    },\n    generatedId,\n  );\n\n  const isOutsideOfForm = field?.form == null;\n\n  const onChangeEvent = useEvent((value, dontTouch: boolean) => {\n    field?.onChange?.(\n      value,\n      dontTouch,\n      field?.validateTrigger ?? defaultValidationTrigger,\n    );\n  });\n\n  function resolveResult(): Props {\n    if (isInsideLegacyField || isDisabled) {\n      return props;\n    }\n\n    if (!hasName) {\n      // Standalone field - just add generated ID if not provided\n      if (!props.id) {\n        const result = { ...props, id: generatedId };\n\n        if (result.id && !result.labelProps) {\n          result.labelProps = { for: result.id };\n        } else if (result.id && result.labelProps && !result.labelProps.for) {\n          result.labelProps = { ...result.labelProps, for: result.id };\n        }\n\n        return result as Props;\n      }\n      return props;\n    }\n\n    if (props.rules && isOutsideOfForm) {\n      warn(\n        `The \"rules\" prop is not supported for fields that are not part of a form. The \"${props.name}\" field is placed outside the form.`,\n      );\n    }\n\n    const valueProps = !isOutsideOfForm\n      ? valuePropsMapper({\n          value: field.value,\n          onChange: onChangeEvent,\n        })\n      : {};\n\n    // Exclude `form` (it must never reach a DOM node) and the field's own\n    // handlers: `valueProps` already routes the component's change event into\n    // `field.onChange` under the name the component listens to, and `onBlur` is\n    // added once below. `mergeProps` chains same-named handlers, so merging them\n    // here as well made every user change and every blur run the field handler\n    // twice — and onChange/onBlur-triggered validation validate twice.\n    const {\n      form: _form,\n      onChange: _fieldOnChange,\n      onBlur: _fieldOnBlur,\n      ...fieldRest\n    } = field ?? {};\n\n    const result: Props = isOutsideOfForm\n      ? props\n      : mergeProps(props, fieldRest, valueProps, {\n          validateTrigger: field.validateTrigger ?? defaultValidationTrigger,\n          // Chained after the caller's own `onBlur` by `mergeProps`.\n          onBlur: field.onBlur,\n        });\n\n    return result.id\n      ? { ...result, labelProps: { ...result.labelProps, for: result.id } }\n      : result;\n  }\n\n  const resolved = resolveResult();\n  // React Aria forwards `form` to native inputs. A modern controller is a\n  // binding source, never an HTML form id, including in standalone/group mode.\n  const result = isModernFormController(resolved.form)\n    ? { ...resolved, form: undefined }\n    : resolved;\n\n  const {\n    field: _descriptor,\n    dependsOn: _dependsOn,\n    deps: _deps,\n    ...domProps\n  } = result;\n  // Standalone and group-scoped inputs do not merge a bound field's props.\n  // Their tuple must still become a string before React Aria or DOM forwarding.\n  const namedProps =\n    domProps.name != null && typeof domProps.name !== 'string'\n      ? { ...domProps, name: getFieldKey(domProps.name) }\n      : domProps;\n  useDebugValue(namedProps);\n\n  return namedProps as ResolvedFieldProps<Props>;\n}\n"],"mappings":";;;;;;;;;;;;;;AA+BA,MAAM,2BAA2B,EAAE,OAAO,gBAAgB;CACxD,OAAO,SAAS;CAChB;CACD;;;;;;;;;;;;AAkBD,SAAgB,cAId,YACA,SAA8B,EAAE,EACL;CAG3B,MAAM,WAAW,iBAAiB,WAAW;CAC7C,MAAM,QAAe,mBACnB,aACE,SAAS,QACL;EACE,GAAG;EACH,GAAG,SAAS,MAAM;EAClB,MAAM,SAAS,MAAM;EACrB,MACE,OAAO,SAAS,MAAM,SAAS,WAC3B,SAAS,MAAM,OACf,YAAY,SAAS,MAAM,KAAK;EACvC,GACD,SACL,CACF;CAGD,MAAM,CAAC,cAAc,SAAS,OAAO,sBAAsB,MAAM;CAEjE,MAAM,EACJ,mBAAmB,yBACnB,2BAA2B,aACzB;CAEJ,MAAM,sBAAsB,sBAAsB;AAElD,KAAI,MAAM,SAAS,CAAC,MAAM,KACxB,MACE,wHACD;CAGH,MAAM,UAAU,MAAM,QAAQ;CAC9B,MAAM,cAAc,OAAO;CAC3B,MAAM,UAAU,WAAW,CAAC,uBAAuB,CAAC;CAEpD,MAAM,QAAQ,gBACZ,OACA;EACE,0BAA0B,OAAO;EACjC,SAAS,CAAC;EACX,EACD,YACD;CAED,MAAM,kBAAkB,OAAO,QAAQ;CAEvC,MAAM,gBAAgB,UAAU,OAAO,cAAuB;AAC5D,SAAO,WACL,OACA,WACA,OAAO,mBAAmB,yBAC3B;GACD;CAEF,SAAS,gBAAuB;AAC9B,MAAI,uBAAuB,WACzB,QAAO;AAGT,MAAI,CAAC,SAAS;AAEZ,OAAI,CAAC,MAAM,IAAI;IACb,MAAM,SAAS;KAAE,GAAG;KAAO,IAAI;KAAa;AAE5C,QAAI,OAAO,MAAM,CAAC,OAAO,WACvB,QAAO,aAAa,EAAE,KAAK,OAAO,IAAI;aAC7B,OAAO,MAAM,OAAO,cAAc,CAAC,OAAO,WAAW,IAC9D,QAAO,aAAa;KAAE,GAAG,OAAO;KAAY,KAAK,OAAO;KAAI;AAG9D,WAAO;;AAET,UAAO;;AAGT,MAAI,MAAM,SAAS,gBACjB,MACE,kFAAkF,MAAM,KAAK,qCAC9F;EAGH,MAAM,aAAa,CAAC,kBAChB,iBAAiB;GACf,OAAO,MAAM;GACb,UAAU;GACX,CAAC,GACF,EAAE;EAQN,MAAM,EACJ,MAAM,OACN,UAAU,gBACV,QAAQ,cACR,GAAG,cACD,SAAS,EAAE;EAEf,MAAM,SAAgB,kBAClB,QACA,WAAW,OAAO,WAAW,YAAY;GACvC,iBAAiB,MAAM,mBAAmB;GAE1C,QAAQ,MAAM;GACf,CAAC;AAEN,SAAO,OAAO,KACV;GAAE,GAAG;GAAQ,YAAY;IAAE,GAAG,OAAO;IAAY,KAAK,OAAO;IAAI;GAAE,GACnE;;CAGN,MAAM,WAAW,eAAe;CAOhC,MAAM,EACJ,OAAO,aACP,WAAW,YACX,MAAM,OACN,GAAG,aARU,uBAAuB,SAAS,KAAK,GAChD;EAAE,GAAG;EAAU,MAAM;EAAW,GAChC;CAUJ,MAAM,aACJ,SAAS,QAAQ,QAAQ,OAAO,SAAS,SAAS,WAC9C;EAAE,GAAG;EAAU,MAAM,YAAY,SAAS,KAAK;EAAE,GACjD;AACN,eAAc,WAAW;AAEzB,QAAO"}

package/dist/components/form/Form/use-field/use-field.d.ts

@@ -14,7 +14,9 @@ type UseFieldParams = {
    */
   unbound?: boolean;
 };
-declare function useField<T extends FieldTypes, Props extends UseFieldProps<T>>(props: Props, params: UseFieldParams): FieldReturnValue<T>;
+declare function useField<T extends FieldTypes, Props extends UseFieldProps<T> & {
+  name?: string;
+}>(props: Props, params: UseFieldParams): FieldReturnValue<T>;
 //#endregion
 export { UseFieldParams, useField };
 //# sourceMappingURL=use-field.d.ts.map

package/dist/components/form/Form/use-field/use-field.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 import { useLayoutEffect as useLayoutEffect$1 } from "../../../../utils/react/useLayoutEffect.js";
 import { useEvent } from "../../../../_internal/hooks/use-event.js";
 import { useIsFirstRender } from "../../../../_internal/hooks/use-is-first-render.js";

package/dist/components/form/Form/use-field/use-field.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-field.js","names":[],"sources":["../../../../../src/components/form/Form/use-field/use-field.ts"],"sourcesContent":["import { useEffect, useMemo, useState } from 'react';\n\nimport { useEvent, useIsFirstRender } from '../../../../_internal/index';\nimport { ValidateTrigger } from '../../../../shared/index';\nimport { useLayoutEffect } from '../../../../utils/react/useLayoutEffect';\nimport { resolveValidationProps } from '../../validation/index';\nimport {\n  isModernFormController,\n  modernBackendUnavailableError,\n} from '../backend';\nimport { useFormProps } from '../Form';\nimport { FieldTypes } from '../types';\nimport { delayValidationRule } from '../validation';\n\nimport { FieldReturnValue, UseFieldProps } from './types';\n\nimport type { CubeFormInstance } from '../use-form';\n\nconst ID_MAP = {};\n\nfunction createId(name) {\n  if (!name) return;\n\n  if (!ID_MAP[name]) {\n    ID_MAP[name] = [];\n  }\n\n  let i = 0;\n  let id;\n\n  do {\n    id = i ? `${name}_${i}` : name;\n    i++;\n  } while (ID_MAP[name].includes(id));\n\n  ID_MAP[name].push(id);\n\n  return id;\n}\n\nfunction removeId(name, id) {\n  if (!ID_MAP[name]) return;\n\n  ID_MAP[name] = ID_MAP[name].filter((_id) => _id !== id);\n}\n\nexport type UseFieldParams = {\n  defaultValidationTrigger?: ValidateTrigger;\n  /**\n   * Run without a binding: `useFieldProps` sets this for an input that is\n   * standalone, inside the deprecated `<Field>` or disabled, so that this hook\n   * is still called (stable hook order) but registers nothing.\n   */\n  unbound?: boolean;\n};\n\nexport function useField<T extends FieldTypes, Props extends UseFieldProps<T>>(\n  props: Props,\n  params: UseFieldParams,\n): FieldReturnValue<T> {\n  props = useFormProps(props);\n\n  let {\n    defaultValue,\n    id,\n    idPrefix,\n    name,\n    form: sourceForm,\n    rules,\n    message,\n    description,\n    errorMessage,\n    validateTrigger = params.defaultValidationTrigger,\n    validationDelay,\n    showValid,\n    shouldUpdate,\n    isRequired: isRequiredProp,\n    necessityIndicator: necessityIndicatorProp,\n  } = props;\n\n  if (params.unbound) {\n    name = undefined;\n    sourceForm = undefined;\n  }\n\n  if (!params.unbound && isModernFormController(sourceForm)) {\n    throw modernBackendUnavailableError(\n      name != null ? `The \"${name}\" field` : 'A field without a name',\n    );\n  }\n\n  // A modern source is rejected above (or cleared when this adapter is inert).\n  // Keep unbranded structural legacy instances supported as before.\n  const form = sourceForm as CubeFormInstance<T> | undefined;\n\n  const { isInvalid: isInvalidProp, isValid: isValidProp } =\n    resolveValidationProps(props);\n\n  const processedRules = useMemo(() => {\n    let finalRules = rules;\n\n    // If isRequired prop is set, ensure there's a required rule\n    if (isRequiredProp) {\n      const hasRequiredRule = finalRules?.some(\n        (rule) => 'required' in rule && rule.required === true,\n      );\n\n      if (!hasRequiredRule) {\n        finalRules = finalRules\n          ? [{ required: true }, ...finalRules]\n          : [{ required: true }];\n      }\n    }\n\n    // Add delay rule if needed\n    if (finalRules && finalRules.length && validationDelay) {\n      return [delayValidationRule(validationDelay), ...finalRules];\n    }\n\n    return finalRules;\n  }, [rules, validationDelay, isRequiredProp]);\n\n  const nonInput = !name;\n  const fieldName: string = name != null ? name : '';\n\n  const isFirstRender = useIsFirstRender();\n  const baseId = id || (idPrefix ? `${idPrefix}_${fieldName}` : fieldName);\n\n  // The id the effect below registered, with the base it was registered for.\n  // Between a base change and that effect's next run the state is stale, and\n  // handing it out would let the element carry the previous binding's id for\n  // one commit — which can duplicate a sibling's live id — so the current base\n  // is used until the effect catches up. An explicit `id` is used as it is.\n  const [assignedId, setAssignedId] = useState({ base: baseId, id: baseId });\n  const currentId = id || (assignedId.base === baseId ? assignedId.id : baseId);\n\n  // Ids are registered per base (form name prefix plus field name), so that\n  // duplicates get a suffix and the base is released when it changes or the\n  // input unmounts. `id` and `nonInput` cannot change without the base. A\n  // layout effect: when the base changes, the commit that carries the\n  // unsuffixed base is corrected before the browser paints, so a duplicate\n  // never shows a colliding id.\n  useLayoutEffect(() => {\n    if (id || nonInput) return;\n\n    const newId = createId(baseId);\n\n    setAssignedId((previous) =>\n      previous.base === baseId && previous.id === newId\n        ? previous\n        : { base: baseId, id: newId },\n    );\n\n    return () => {\n      removeId(baseId, newId);\n    };\n  }, [baseId, id, nonInput]);\n\n  // Every form this hook registered the current name with. The dual-backend\n  // shell keeps the hook mounted for standalone inputs, so a form may arrive\n  // later or change, and the name may change; the name is released from all\n  // of them, not from whichever form a closure happened to capture. This is\n  // state rather than a ref only to keep render free of ref access.\n  const [boundForms] = useState(() => new Set<CubeFormInstance<any>>());\n\n  useEffect(() => {\n    return () => {\n      if (fieldName) {\n        boundForms.forEach((boundForm) => boundForm.removeField(fieldName));\n      }\n\n      boundForms.clear();\n    };\n  }, [fieldName, boundForms]);\n\n  let field = form?.getFieldInstance(fieldName);\n\n  if (form) {\n    // First render of this binding: the hook's first render, or a named field\n    // that is not registered yet because the name or the form changed after\n    // mount. Without a name the engine returns an unstored placeholder, so it\n    // is only created on the first render, as before: creating it again on\n    // every render would give the effect below a new object each time.\n    if (isFirstRender || (!field && fieldName)) {\n      if (!field) {\n        field = form.createField(fieldName, true);\n      }\n\n      if (field?.value == null && defaultValue != null) {\n        form.setFieldValue(fieldName, defaultValue, false, true);\n        form.updateInitialFieldsValue({ [fieldName]: defaultValue });\n\n        field = form?.getFieldInstance(fieldName);\n      }\n    }\n\n    if (!field?.touched && defaultValue != null) {\n      form.setFieldValue(fieldName, defaultValue, false, true);\n    }\n  }\n\n  if (field) {\n    field.rules = processedRules;\n  }\n\n  let isRequired = !!processedRules?.find(\n    (rule) => 'required' in rule && rule.required === true,\n  );\n\n  // `isRequired` has two sources with different intent. A `required` rule states\n  // how the field behaves: it is what validation runs, and `aria-required` is\n  // its programmatic mirror, so the flag has to reach the input either way. The\n  // `isRequired` prop additionally states what the label should say. So unless\n  // the prop itself asked for the marker, suppress it — an absent prop and an\n  // explicit `isRequired={false}` both mean \"do not mark this\", the latter\n  // rather more loudly. An explicit `necessityIndicator` overrides either way,\n  // being a request for the marker in its own right.\n  const suppressNecessityIndicator =\n    isRequired && !isRequiredProp && necessityIndicatorProp === undefined;\n\n  // Registration happens during render. Once it is committed, remember the\n  // form for the release above and re-render the form's owner so its\n  // render-time reads see the new field. `form` is deliberately not a\n  // dependency: a form whose identity changes on every render (a copy, an\n  // inline mock) shares its store, and re-running here would loop.\n  useEffect(() => {\n    if (form && field) {\n      boundForms.add(form);\n      form.forceReRender();\n    }\n  }, [field, boundForms]);\n\n  const onChangeHandler = useEvent((val: any, dontTouch: boolean) => {\n    if (!form) return;\n\n    const field = form.getFieldInstance(fieldName);\n\n    if (shouldUpdate) {\n      const fieldsValue = form.getFieldsValue();\n\n      // check if we should update the value of the field\n      const shouldNotBeUpdated =\n        typeof shouldUpdate === 'boolean'\n          ? !shouldUpdate\n          : !shouldUpdate(fieldsValue, {\n              ...fieldsValue,\n              [fieldName]: val,\n            });\n\n      if (shouldNotBeUpdated) {\n        return;\n      }\n    }\n\n    form.setFieldValue(fieldName, val, !dontTouch);\n\n    if (\n      !dontTouch &&\n      (validateTrigger === 'onChange' ||\n        (field && field.errors && field.errors.length))\n    ) {\n      form.validateField(fieldName).catch(() => {}); // do nothing on fail\n    }\n  });\n\n  const onBlurHandler = useEvent(() => {\n    if (validateTrigger === 'onBlur') {\n      // We need a timeout so the change event can be done.\n      setTimeout(() => {\n        form?.validateField(fieldName).catch(() => {}); // do nothing on fail\n      });\n    }\n  });\n\n  let value = field?.value;\n\n  return useMemo(\n    () => ({\n      id: currentId,\n      name: fieldName,\n      value,\n      validateTrigger,\n      form,\n      field,\n      nonInput,\n\n      // Explicit validation props always win over the state derived from the form\n      isInvalid: isInvalidProp ?? !!field?.errors?.length,\n      isValid: isValidProp ?? !!(showValid && field?.status === 'valid'),\n      ...(isRequired && { isRequired }),\n      ...(suppressNecessityIndicator && { necessityIndicator: null }),\n      message:\n        message !== undefined\n          ? message\n          : field?.status === 'invalid' && field?.errors?.[0],\n      description,\n      errorMessage:\n        errorMessage !== undefined\n          ? errorMessage\n          : field?.status === 'invalid' && field?.errors?.length\n            ? field.errors[0]\n            : undefined,\n      onBlur: onBlurHandler,\n      onChange: onChangeHandler,\n    }),\n    [\n      form,\n      field,\n      field?.value,\n      field?.errors?.length,\n      field?.status,\n      currentId,\n      fieldName,\n      isRequired,\n      suppressNecessityIndicator,\n      message,\n      description,\n      errorMessage,\n      onBlurHandler,\n      onChangeHandler,\n      validateTrigger,\n      isInvalidProp,\n      isValidProp,\n      showValid,\n      nonInput,\n    ],\n  );\n}\n"],"mappings":";;;;;;;;;;;AAkBA,MAAM,SAAS,EAAE;AAEjB,SAAS,SAAS,MAAM;AACtB,KAAI,CAAC,KAAM;AAEX,KAAI,CAAC,OAAO,MACV,QAAO,QAAQ,EAAE;CAGnB,IAAI,IAAI;CACR,IAAI;AAEJ,IAAG;AACD,OAAK,IAAI,GAAG,KAAK,GAAG,MAAM;AAC1B;UACO,OAAO,MAAM,SAAS,GAAG;AAElC,QAAO,MAAM,KAAK,GAAG;AAErB,QAAO;;AAGT,SAAS,SAAS,MAAM,IAAI;AAC1B,KAAI,CAAC,OAAO,MAAO;AAEnB,QAAO,QAAQ,OAAO,MAAM,QAAQ,QAAQ,QAAQ,GAAG;;AAazD,SAAgB,SACd,OACA,QACqB;AACrB,SAAQ,aAAa,MAAM;CAE3B,IAAI,EACF,cACA,IACA,UACA,MACA,MAAM,YACN,OACA,SACA,aACA,cACA,kBAAkB,OAAO,0BACzB,iBACA,WACA,cACA,YAAY,gBACZ,oBAAoB,2BAClB;AAEJ,KAAI,OAAO,SAAS;AAClB,SAAO;AACP,eAAa;;AAGf,KAAI,CAAC,OAAO,WAAW,uBAAuB,WAAW,CACvD,OAAM,8BACJ,QAAQ,OAAO,QAAQ,KAAK,WAAW,yBACxC;CAKH,MAAM,OAAO;CAEb,MAAM,EAAE,WAAW,eAAe,SAAS,gBACzC,uBAAuB,MAAM;CAE/B,MAAM,iBAAiB,cAAc;EACnC,IAAI,aAAa;AAGjB,MAAI,gBAKF;OAAI,CAJoB,YAAY,MACjC,SAAS,cAAc,QAAQ,KAAK,aAAa,KACnD,CAGC,cAAa,aACT,CAAC,EAAE,UAAU,MAAM,EAAE,GAAG,WAAW,GACnC,CAAC,EAAE,UAAU,MAAM,CAAC;;AAK5B,MAAI,cAAc,WAAW,UAAU,gBACrC,QAAO,CAAC,oBAAoB,gBAAgB,EAAE,GAAG,WAAW;AAG9D,SAAO;IACN;EAAC;EAAO;EAAiB;EAAe,CAAC;CAE5C,MAAM,WAAW,CAAC;CAClB,MAAM,YAAoB,QAAQ,OAAO,OAAO;CAEhD,MAAM,gBAAgB,kBAAkB;CACxC,MAAM,SAAS,OAAO,WAAW,GAAG,SAAS,GAAG,cAAc;CAO9D,MAAM,CAAC,YAAY,iBAAiB,SAAS;EAAE,MAAM;EAAQ,IAAI;EAAQ,CAAC;CAC1E,MAAM,YAAY,OAAO,WAAW,SAAS,SAAS,WAAW,KAAK;AAQtE,yBAAsB;AACpB,MAAI,MAAM,SAAU;EAEpB,MAAM,QAAQ,SAAS,OAAO;AAE9B,iBAAe,aACb,SAAS,SAAS,UAAU,SAAS,OAAO,QACxC,WACA;GAAE,MAAM;GAAQ,IAAI;GAAO,CAChC;AAED,eAAa;AACX,YAAS,QAAQ,MAAM;;IAExB;EAAC;EAAQ;EAAI;EAAS,CAAC;CAO1B,MAAM,CAAC,cAAc,+BAAe,IAAI,KAA4B,CAAC;AAErE,iBAAgB;AACd,eAAa;AACX,OAAI,UACF,YAAW,SAAS,cAAc,UAAU,YAAY,UAAU,CAAC;AAGrE,cAAW,OAAO;;IAEnB,CAAC,WAAW,WAAW,CAAC;CAE3B,IAAI,QAAQ,MAAM,iBAAiB,UAAU;AAE7C,KAAI,MAAM;AAMR,MAAI,iBAAkB,CAAC,SAAS,WAAY;AAC1C,OAAI,CAAC,MACH,SAAQ,KAAK,YAAY,WAAW,KAAK;AAG3C,OAAI,OAAO,SAAS,QAAQ,gBAAgB,MAAM;AAChD,SAAK,cAAc,WAAW,cAAc,OAAO,KAAK;AACxD,SAAK,yBAAyB,GAAG,YAAY,cAAc,CAAC;AAE5D,YAAQ,MAAM,iBAAiB,UAAU;;;AAI7C,MAAI,CAAC,OAAO,WAAW,gBAAgB,KACrC,MAAK,cAAc,WAAW,cAAc,OAAO,KAAK;;AAI5D,KAAI,MACF,OAAM,QAAQ;CAGhB,IAAI,aAAa,CAAC,CAAC,gBAAgB,MAChC,SAAS,cAAc,QAAQ,KAAK,aAAa,KACnD;CAUD,MAAM,6BACJ,cAAc,CAAC,kBAAkB,2BAA2B;AAO9D,iBAAgB;AACd,MAAI,QAAQ,OAAO;AACjB,cAAW,IAAI,KAAK;AACpB,QAAK,eAAe;;IAErB,CAAC,OAAO,WAAW,CAAC;CAEvB,MAAM,kBAAkB,UAAU,KAAU,cAAuB;AACjE,MAAI,CAAC,KAAM;EAEX,MAAM,QAAQ,KAAK,iBAAiB,UAAU;AAE9C,MAAI,cAAc;GAChB,MAAM,cAAc,KAAK,gBAAgB;AAWzC,OAPE,OAAO,iBAAiB,YACpB,CAAC,eACD,CAAC,aAAa,aAAa;IACzB,GAAG;KACF,YAAY;IACd,CAAC,CAGN;;AAIJ,OAAK,cAAc,WAAW,KAAK,CAAC,UAAU;AAE9C,MACE,CAAC,cACA,oBAAoB,cAClB,SAAS,MAAM,UAAU,MAAM,OAAO,QAEzC,MAAK,cAAc,UAAU,CAAC,YAAY,GAAG;GAE/C;CAEF,MAAM,gBAAgB,eAAe;AACnC,MAAI,oBAAoB,SAEtB,kBAAiB;AACf,SAAM,cAAc,UAAU,CAAC,YAAY,GAAG;IAC9C;GAEJ;CAEF,IAAI,QAAQ,OAAO;AAEnB,QAAO,eACE;EACL,IAAI;EACJ,MAAM;EACN;EACA;EACA;EACA;EACA;EAGA,WAAW,iBAAiB,CAAC,CAAC,OAAO,QAAQ;EAC7C,SAAS,eAAe,CAAC,EAAE,aAAa,OAAO,WAAW;EAC1D,GAAI,cAAc,EAAE,YAAY;EAChC,GAAI,8BAA8B,EAAE,oBAAoB,MAAM;EAC9D,SACE,YAAY,SACR,UACA,OAAO,WAAW,aAAa,OAAO,SAAS;EACrD;EACA,cACE,iBAAiB,SACb,eACA,OAAO,WAAW,aAAa,OAAO,QAAQ,SAC5C,MAAM,OAAO,KACb;EACR,QAAQ;EACR,UAAU;EACX,GACD;EACE;EACA;EACA,OAAO;EACP,OAAO,QAAQ;EACf,OAAO;EACP;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD,CACF"}
+{"version":3,"file":"use-field.js","names":[],"sources":["../../../../../src/components/form/Form/use-field/use-field.ts"],"sourcesContent":["import { useEffect, useMemo, useState } from 'react';\n\nimport { useEvent, useIsFirstRender } from '../../../../_internal/index';\nimport { ValidateTrigger } from '../../../../shared/index';\nimport { useLayoutEffect } from '../../../../utils/react/useLayoutEffect';\nimport { resolveValidationProps } from '../../validation/index';\nimport {\n  isModernFormController,\n  modernBackendUnavailableError,\n} from '../backend';\nimport { useFormProps } from '../Form';\nimport { FieldTypes } from '../types';\nimport { delayValidationRule } from '../validation';\n\nimport { FieldReturnValue, UseFieldProps } from './types';\n\nimport type { CubeFormInstance } from '../use-form';\n\nconst ID_MAP = {};\n\nfunction createId(name) {\n  if (!name) return;\n\n  if (!ID_MAP[name]) {\n    ID_MAP[name] = [];\n  }\n\n  let i = 0;\n  let id;\n\n  do {\n    id = i ? `${name}_${i}` : name;\n    i++;\n  } while (ID_MAP[name].includes(id));\n\n  ID_MAP[name].push(id);\n\n  return id;\n}\n\nfunction removeId(name, id) {\n  if (!ID_MAP[name]) return;\n\n  ID_MAP[name] = ID_MAP[name].filter((_id) => _id !== id);\n}\n\nexport type UseFieldParams = {\n  defaultValidationTrigger?: ValidateTrigger;\n  /**\n   * Run without a binding: `useFieldProps` sets this for an input that is\n   * standalone, inside the deprecated `<Field>` or disabled, so that this hook\n   * is still called (stable hook order) but registers nothing.\n   */\n  unbound?: boolean;\n};\n\nexport function useField<\n  T extends FieldTypes,\n  Props extends UseFieldProps<T> & { name?: string },\n>(props: Props, params: UseFieldParams): FieldReturnValue<T> {\n  props = useFormProps(props);\n\n  let {\n    defaultValue,\n    id,\n    idPrefix,\n    name,\n    form: sourceForm,\n    rules,\n    message,\n    description,\n    errorMessage,\n    validateTrigger = params.defaultValidationTrigger,\n    validationDelay,\n    showValid,\n    shouldUpdate,\n    isRequired: isRequiredProp,\n    necessityIndicator: necessityIndicatorProp,\n  } = props;\n\n  if (params.unbound) {\n    name = undefined;\n    sourceForm = undefined;\n  }\n\n  if (!params.unbound && isModernFormController(sourceForm)) {\n    throw modernBackendUnavailableError(\n      name != null ? `The \"${name}\" field` : 'A field without a name',\n    );\n  }\n\n  // A modern source is rejected above (or cleared when this adapter is inert).\n  // Keep unbranded structural legacy instances supported as before.\n  const form = sourceForm as CubeFormInstance<T> | undefined;\n\n  const { isInvalid: isInvalidProp, isValid: isValidProp } =\n    resolveValidationProps(props);\n\n  const processedRules = useMemo(() => {\n    let finalRules = rules;\n\n    // If isRequired prop is set, ensure there's a required rule\n    if (isRequiredProp) {\n      const hasRequiredRule = finalRules?.some(\n        (rule) => 'required' in rule && rule.required === true,\n      );\n\n      if (!hasRequiredRule) {\n        finalRules = finalRules\n          ? [{ required: true }, ...finalRules]\n          : [{ required: true }];\n      }\n    }\n\n    // Add delay rule if needed\n    if (finalRules && finalRules.length && validationDelay) {\n      return [delayValidationRule(validationDelay), ...finalRules];\n    }\n\n    return finalRules;\n  }, [rules, validationDelay, isRequiredProp]);\n\n  const nonInput = !name;\n  const fieldName: string = name != null ? name : '';\n\n  const isFirstRender = useIsFirstRender();\n  const baseId = id || (idPrefix ? `${idPrefix}_${fieldName}` : fieldName);\n\n  // The id the effect below registered, with the base it was registered for.\n  // Between a base change and that effect's next run the state is stale, and\n  // handing it out would let the element carry the previous binding's id for\n  // one commit — which can duplicate a sibling's live id — so the current base\n  // is used until the effect catches up. An explicit `id` is used as it is.\n  const [assignedId, setAssignedId] = useState({ base: baseId, id: baseId });\n  const currentId = id || (assignedId.base === baseId ? assignedId.id : baseId);\n\n  // Ids are registered per base (form name prefix plus field name), so that\n  // duplicates get a suffix and the base is released when it changes or the\n  // input unmounts. `id` and `nonInput` cannot change without the base. A\n  // layout effect: when the base changes, the commit that carries the\n  // unsuffixed base is corrected before the browser paints, so a duplicate\n  // never shows a colliding id.\n  useLayoutEffect(() => {\n    if (id || nonInput) return;\n\n    const newId = createId(baseId);\n\n    setAssignedId((previous) =>\n      previous.base === baseId && previous.id === newId\n        ? previous\n        : { base: baseId, id: newId },\n    );\n\n    return () => {\n      removeId(baseId, newId);\n    };\n  }, [baseId, id, nonInput]);\n\n  // Every form this hook registered the current name with. The dual-backend\n  // shell keeps the hook mounted for standalone inputs, so a form may arrive\n  // later or change, and the name may change; the name is released from all\n  // of them, not from whichever form a closure happened to capture. This is\n  // state rather than a ref only to keep render free of ref access.\n  const [boundForms] = useState(() => new Set<CubeFormInstance<any>>());\n\n  useEffect(() => {\n    return () => {\n      if (fieldName) {\n        boundForms.forEach((boundForm) => boundForm.removeField(fieldName));\n      }\n\n      boundForms.clear();\n    };\n  }, [fieldName, boundForms]);\n\n  let field = form?.getFieldInstance(fieldName);\n\n  if (form) {\n    // First render of this binding: the hook's first render, or a named field\n    // that is not registered yet because the name or the form changed after\n    // mount. Without a name the engine returns an unstored placeholder, so it\n    // is only created on the first render, as before: creating it again on\n    // every render would give the effect below a new object each time.\n    if (isFirstRender || (!field && fieldName)) {\n      if (!field) {\n        field = form.createField(fieldName, true);\n      }\n\n      if (field?.value == null && defaultValue != null) {\n        form.setFieldValue(fieldName, defaultValue, false, true);\n        form.updateInitialFieldsValue({ [fieldName]: defaultValue });\n\n        field = form?.getFieldInstance(fieldName);\n      }\n    }\n\n    if (!field?.touched && defaultValue != null) {\n      form.setFieldValue(fieldName, defaultValue, false, true);\n    }\n  }\n\n  if (field) {\n    field.rules = processedRules;\n  }\n\n  let isRequired = !!processedRules?.find(\n    (rule) => 'required' in rule && rule.required === true,\n  );\n\n  // `isRequired` has two sources with different intent. A `required` rule states\n  // how the field behaves: it is what validation runs, and `aria-required` is\n  // its programmatic mirror, so the flag has to reach the input either way. The\n  // `isRequired` prop additionally states what the label should say. So unless\n  // the prop itself asked for the marker, suppress it — an absent prop and an\n  // explicit `isRequired={false}` both mean \"do not mark this\", the latter\n  // rather more loudly. An explicit `necessityIndicator` overrides either way,\n  // being a request for the marker in its own right.\n  const suppressNecessityIndicator =\n    isRequired && !isRequiredProp && necessityIndicatorProp === undefined;\n\n  // Registration happens during render. Once it is committed, remember the\n  // form for the release above and re-render the form's owner so its\n  // render-time reads see the new field. `form` is deliberately not a\n  // dependency: a form whose identity changes on every render (a copy, an\n  // inline mock) shares its store, and re-running here would loop.\n  useEffect(() => {\n    if (form && field) {\n      boundForms.add(form);\n      form.forceReRender();\n    }\n  }, [field, boundForms]);\n\n  const onChangeHandler = useEvent((val: any, dontTouch: boolean) => {\n    if (!form) return;\n\n    const field = form.getFieldInstance(fieldName);\n\n    if (shouldUpdate) {\n      const fieldsValue = form.getFieldsValue();\n\n      // check if we should update the value of the field\n      const shouldNotBeUpdated =\n        typeof shouldUpdate === 'boolean'\n          ? !shouldUpdate\n          : !shouldUpdate(fieldsValue, {\n              ...fieldsValue,\n              [fieldName]: val,\n            });\n\n      if (shouldNotBeUpdated) {\n        return;\n      }\n    }\n\n    form.setFieldValue(fieldName, val, !dontTouch);\n\n    if (\n      !dontTouch &&\n      (validateTrigger === 'onChange' ||\n        (field && field.errors && field.errors.length))\n    ) {\n      form.validateField(fieldName).catch(() => {}); // do nothing on fail\n    }\n  });\n\n  const onBlurHandler = useEvent(() => {\n    if (validateTrigger === 'onBlur') {\n      // We need a timeout so the change event can be done.\n      setTimeout(() => {\n        form?.validateField(fieldName).catch(() => {}); // do nothing on fail\n      });\n    }\n  });\n\n  let value = field?.value;\n\n  return useMemo(\n    () => ({\n      id: currentId,\n      name: fieldName,\n      value,\n      validateTrigger,\n      form,\n      field,\n      nonInput,\n\n      // Explicit validation props always win over the state derived from the form\n      isInvalid: isInvalidProp ?? !!field?.errors?.length,\n      isValid: isValidProp ?? !!(showValid && field?.status === 'valid'),\n      ...(isRequired && { isRequired }),\n      ...(suppressNecessityIndicator && { necessityIndicator: null }),\n      message:\n        message !== undefined\n          ? message\n          : field?.status === 'invalid' && field?.errors?.[0],\n      description,\n      errorMessage:\n        errorMessage !== undefined\n          ? errorMessage\n          : field?.status === 'invalid' && field?.errors?.length\n            ? field.errors[0]\n            : undefined,\n      onBlur: onBlurHandler,\n      onChange: onChangeHandler,\n    }),\n    [\n      form,\n      field,\n      field?.value,\n      field?.errors?.length,\n      field?.status,\n      currentId,\n      fieldName,\n      isRequired,\n      suppressNecessityIndicator,\n      message,\n      description,\n      errorMessage,\n      onBlurHandler,\n      onChangeHandler,\n      validateTrigger,\n      isInvalidProp,\n      isValidProp,\n      showValid,\n      nonInput,\n    ],\n  );\n}\n"],"mappings":"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"}

package/dist/components/form/Form/use-form.d.ts

@@ -1,6 +1,6 @@
 
-import { CubeFieldData, FieldTypes, SetFieldsArrType } from "./types.js";
 import { FORM_BACKEND, LegacyFormBrand } from "./backend.js";
+import { CubeFieldData, FieldTypes, SetFieldsArrType } from "./types.js";
 import { ReactNode } from "react";
 
 //#region src/components/form/Form/use-form.d.ts

package/dist/components/form/Form/use-form.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.180.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.182.0 | Cube Dev Team */
 import { FORM_BACKEND, isModernFormController, modernBackendUnavailableError } from "./backend.js";
 import { applyRules } from "./validation.js";
 import { dotizeConvert } from "../../../utils/dotize.js";