@cube-dev/ui-kit 0.197.0 → 0.198.1

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

@@ -3,10 +3,9 @@ import { ModernFormBrand } from "../backend.js";
 import { FormPath } from "./values.js";
 import { FormValues } from "./read-types.js";
 import { ModernValidationRule } from "./validation.js";
-
 //#region src/components/form/Form/modern/types.d.ts
-type FieldStatus = 'unvalidated' | 'validating' | 'valid' | 'invalid';
-interface FieldState<ErrorValue = unknown> {
+export type FieldStatus = 'unvalidated' | 'validating' | 'valid' | 'invalid';
+export interface FieldState<ErrorValue = unknown> {
   readonly name: string;
   readonly value: unknown;
   readonly defaultValue: unknown;
@@ -18,7 +17,7 @@ interface FieldState<ErrorValue = unknown> {
   readonly registrationCount: number;
   readonly validationRevision: number;
 }
-interface FormState<T extends object, ErrorValue = unknown> {
+export interface FormState<T extends object, ErrorValue = unknown> {
   readonly values: FormValues<T>;
   readonly activeValues: FormValues<T>;
   readonly defaultValues: FormValues<T>;
@@ -36,7 +35,7 @@ interface FormState<T extends object, ErrorValue = unknown> {
   readonly submitError: unknown;
   readonly revision: number;
 }
-interface RegistrationOptions<ErrorValue = unknown> {
+export interface RegistrationOptions<ErrorValue = unknown> {
   readonly rules?: readonly ModernValidationRule<ErrorValue>[];
   /** Manual function revision, skipping source comparison. Declarative constraints are always compared. */
   readonly rulesKey?: string;
@@ -51,7 +50,7 @@ interface RegistrationOptions<ErrorValue = unknown> {
   readonly preserve?: boolean;
   readonly isEqual?: (a: unknown, b: unknown) => boolean;
 }
-interface RegistrationToken<ErrorValue = unknown> {
+export interface RegistrationToken<ErrorValue = unknown> {
   readonly name: string;
   readonly released: boolean;
   update(options: RegistrationOptions<ErrorValue>): void;
@@ -60,22 +59,22 @@ interface RegistrationToken<ErrorValue = unknown> {
     deferValueRemoval?: boolean;
   }): void;
 }
-interface FormChange {
+export interface FormChange {
   readonly names: readonly string[];
   readonly source: 'user' | 'program';
   readonly kind: 'set' | 'reset' | 'adopt' | 'defaults';
 }
-interface SetValueOptions {
+export interface SetValueOptions {
   readonly validate?: 'auto' | 'always' | 'never';
   readonly source?: FormChange['source'];
   readonly touch?: boolean;
   readonly notify?: boolean;
 }
-interface ModernSubmitContext {
+export interface ModernSubmitContext {
   readonly include: 'active' | 'all';
   readonly signal: AbortSignal;
 }
-interface FormCallbacks<T extends object, ErrorValue = unknown> {
+export 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. */
@@ -83,29 +82,29 @@ interface FormCallbacks<T extends object, ErrorValue = unknown> {
   /** Form.useController commits the latest callback after each render. */
   readonly onValuesChange?: (values: FormValues<T>, change: FormChange) => void | Promise<void>;
 }
-type ModernSubmitFailure<ErrorValue = unknown> = {
+export type ModernSubmitFailure<ErrorValue = unknown> = {
   status: 'invalid';
   errors: Readonly<Record<string, readonly ErrorValue[]>>;
 } | {
   status: 'failed';
   error: unknown;
 };
-interface CallbackBinding<T extends object, ErrorValue = unknown> {
+export interface CallbackBinding<T extends object, ErrorValue = unknown> {
   update(callbacks: FormCallbacks<T, ErrorValue>): void;
   release(): void;
 }
-interface ModernFieldValidationResult<ErrorValue = unknown> {
+export interface ModernFieldValidationResult<ErrorValue = unknown> {
   readonly name: string;
   readonly errors: readonly ErrorValue[];
   readonly isValid: boolean;
   readonly stale: boolean;
 }
-interface ModernValidationResult<ErrorValue = unknown> {
+export interface ModernValidationResult<ErrorValue = unknown> {
   readonly fields: readonly ModernFieldValidationResult<ErrorValue>[];
   readonly isValid: boolean;
   readonly stale: boolean;
 }
-type ModernSubmitResult<ErrorValue = unknown> = ModernSubmitFailure<ErrorValue> | {
+export type ModernSubmitResult<ErrorValue = unknown> = ModernSubmitFailure<ErrorValue> | {
   status: 'ignored';
   reason: 'submitting';
 } | {
@@ -113,7 +112,7 @@ type ModernSubmitResult<ErrorValue = unknown> = ModernSubmitFailure<ErrorValue>
 } | {
   status: 'submitted';
 };
-interface FormStoreOptions<T extends object, ErrorValue = unknown> extends FormCallbacks<T, ErrorValue> {
+export 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. */
@@ -124,20 +123,20 @@ interface FormStoreOptions<T extends object, ErrorValue = unknown> extends FormC
   readonly onDevelopmentError?: (message: string) => void;
 }
 /** Internal state token owned by the validation pipeline. */
-interface ValidationToken<ErrorValue> {
+export interface ValidationToken<ErrorValue> {
   readonly signal: AbortSignal;
   complete(errors: readonly ErrorValue[]): boolean;
   cancel(): void;
 }
 /** A reset/disposal invalidates the token so a late completion cannot publish. */
-interface SubmissionToken {
+export interface SubmissionToken {
   readonly signal: AbortSignal;
   complete(result?: {
     error: unknown;
   }): boolean;
 }
 /** Internal until the React/controller API lands in subsequent phases. */
-interface FormStore<T extends object = Record<string, unknown>, ErrorValue = unknown> extends ModernFormBrand {
+export interface FormStore<T extends object = Record<string, unknown>, ErrorValue = unknown> extends ModernFormBrand {
   getSnapshot(): FormState<T, ErrorValue>;
   getFieldSnapshot(path: FormPath): FieldState<ErrorValue> | undefined;
   getValue<K extends keyof T & string>(name: K): T[K] | undefined;
@@ -187,5 +186,4 @@ interface FormStore<T extends object = Record<string, unknown>, ErrorValue = unk
   };
 }
 //#endregion
-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,16 +1,15 @@
 
 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>> {
+export interface ModernValidationContext<T extends object = Record<string, unknown>> {
   readonly name: string;
   readonly signal: AbortSignal;
   getValue(path: FormPath): unknown;
   getValues(): FormValues<T>;
 }
 /** Library-neutral: return an error, or throw/reject; undefined/null means success. */
-interface ModernValidationRule<ErrorValue = unknown> {
+export interface ModernValidationRule<ErrorValue = unknown> {
   required?: boolean;
   min?: number;
   max?: number;
@@ -24,5 +23,4 @@ interface ModernValidationRule<ErrorValue = unknown> {
   validator?: (rule: ModernValidationRule<ErrorValue>, value: any, context: ModernValidationContext<any>) => ErrorValue | void | Promise<ErrorValue | void>;
 }
 //#endregion
-export { ModernValidationContext, ModernValidationRule };
 //# sourceMappingURL=validation.d.ts.map

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

@@ -1,6 +1,5 @@
-/** @license MIT | @cube-dev/ui-kit v0.197.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.1 | Cube Dev Team */
 import { applyRule } from "../validation.js";
-
 //#region src/components/form/Form/modern/validation.ts
 /** Compare constraints and function source; captures still need deps/rulesKey. */
 function rulesSignature(rules = [], { hashFunctions = true } = {}) {
@@ -35,7 +34,7 @@ async function runRules(value, rules, context, policy) {
 	}
 	return errors;
 }
-
 //#endregion
 export { rulesSignature, runRules };
+
 //# sourceMappingURL=validation.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"validation.js","names":["applyRule","FormValues","FormPath","ModernValidationContext","Record","name","signal","AbortSignal","getValue","path","getValues","T","ModernValidationRule","required","min","max","len","pattern","RegExp","type","enum","whitespace","transform","value","message","ErrorValue","validator","rule","context","Promise","rulesSignature","rules","hashFunctions","seen","Set","signature","toString","source","flags","String","has","add","result","JSON","stringify","Object","keys","filter","key","sort","map","Reflect","get","delete","runRules","policy","errors","aborted","checks","transformed","undefined","push","error","Error","length"],"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,SAAgB8B,eACdC,QAAqD,EAAE,EACvD,EAAEC,gBAAgB,SAAsC,EAAE,EAClD;CACR,MAAMC,uBAAO,IAAIC,KAAa;CAC9B,MAAMC,aAAaZ,UAA2B;AAC5C,MAAI,OAAOA,UAAU,WACnB,QAAOS,gBAAgB,YAAYT,MAAMa,UAAU,KAAK;AAC1D,MAAIb,iBAAiBL,OAAQ,QAAO,UAAUK,MAAMc,OAAM,GAAId,MAAMe;AACpE,MAAI,CAACf,SAAS,OAAOA,UAAU,SAC7B,QAAO,GAAG,OAAOA,MAAK,GAAIgB,OAAOhB,MAAM;AACzC,MAAIU,KAAKO,IAAIjB,MAAM,CAAE,QAAO;AAC5BU,OAAKQ,IAAIlB,MAAM;EACf,MAAMmB,SAASC,KAAKC,UAClBC,OAAOC,KAAKvB,MAAM,CACfwB,QAAQC,QAAQA,QAAQ,UAAU,CAClCC,MAAM,CACNC,KAAKF,QAAQ,CAACA,KAAKb,UAAUgB,QAAQC,IAAI7B,OAAOyB,IAAI,CAAC,CAAC,CAC3D,CAAC;AACDf,OAAKoB,OAAO9B,MAAM;AAClB,SAAOmB;;AAET,QAAOP,UAAUJ,MAAM;;AAGzB,eAAsBuB,SACpB/B,OACAQ,OACAH,SACA2B,QACuB;CACvB,MAAMC,SAAuB,EAAE;AAC/B,MAAK,MAAM7B,QAAQI,OAAO;AACxB,MAAIH,QAAQtB,OAAOmD,QAAS;EAC5B,MAAM,EAAE/B,WAAWJ,WAAW,GAAGoC,WAAW/B;AAC5C,MAAI;GACF,MAAMgC,cAAcrC,YAAYA,UAAUC,MAAM,GAAGA;AACnD,SAAMvB,UAAU2D,aAAaD,QAAQE,OAAU;AAC/C,OAAIhC,QAAQtB,OAAOmD,QAAS;GAC5B,MAAMf,SAAS,MAAMhB,YAAYC,MAAMgC,aAAa/B,QAAQ;AAC5D,OAAIc,WAAWkB,UAAalB,WAAW,QAAQA,WAAW,GACxDc,QAAOK,KAAKnB,OAAqB;WAC5BoB,OAAO;AACdN,UAAOK,MACHC,iBAAiBC,QAAQD,MAAMtC,WAAWG,KAAKH,UAAUsC,UACzDnC,KAAKH,YACJG,KAAKd,WAAW,aAAa,iBACjC;;AAEH,MAAI2C,OAAOQ,UAAUT,WAAW,QAAS;;AAE3C,QAAOC"}
+{"version":3,"file":"validation.js","names":["applyRule","FormValues","FormPath","ModernValidationContext","Record","name","signal","AbortSignal","getValue","path","getValues","T","ModernValidationRule","required","min","max","len","pattern","RegExp","type","enum","whitespace","transform","value","message","ErrorValue","validator","rule","context","Promise","rulesSignature","rules","hashFunctions","seen","Set","signature","toString","source","flags","String","has","add","result","JSON","stringify","Object","keys","filter","key","sort","map","Reflect","get","delete","runRules","policy","errors","aborted","checks","transformed","undefined","push","error","Error","length"],"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,SAAgB8B,eACdC,QAAqD,CAAA,GACrD,EAAEC,gBAAgB,SAAsC,CAAC,GACjD;CACR,MAAMC,uBAAO,IAAIC,IAAY;CAC7B,MAAMC,aAAaZ,UAA2B;EAC5C,IAAI,OAAOA,UAAU,YACnB,OAAOS,gBAAgB,YAAYT,MAAMa,SAAS,MAAM;EAC1D,IAAIb,iBAAiBL,QAAQ,OAAO,UAAUK,MAAMc,OAAM,GAAId,MAAMe;EACpE,IAAI,CAACf,SAAS,OAAOA,UAAU,UAC7B,OAAO,GAAG,OAAOA,MAAK,GAAIgB,OAAOhB,KAAK;EACxC,IAAIU,KAAKO,IAAIjB,KAAK,GAAG,OAAO;EAC5BU,KAAKQ,IAAIlB,KAAK;EACd,MAAMmB,SAASC,KAAKC,UAClBC,OAAOC,KAAKvB,KAAK,CAAC,CACfwB,QAAQC,QAAQA,QAAQ,SAAS,CAAC,CAClCC,KAAK,CAAC,CACNC,KAAKF,QAAQ,CAACA,KAAKb,UAAUgB,QAAQC,IAAI7B,OAAOyB,GAAG,CAAC,CAAC,CAAC,CAC3D;EACAf,KAAKoB,OAAO9B,KAAK;EACjB,OAAOmB;CACT;CACA,OAAOP,UAAUJ,KAAK;AACxB;AAEA,eAAsBuB,SACpB/B,OACAQ,OACAH,SACA2B,QACuB;CACvB,MAAMC,SAAuB,CAAA;CAC7B,KAAK,MAAM7B,QAAQI,OAAO;EACxB,IAAIH,QAAQtB,OAAOmD,SAAS;EAC5B,MAAM,EAAE/B,WAAWJ,WAAW,GAAGoC,WAAW/B;EAC5C,IAAI;GACF,MAAMgC,cAAcrC,YAAYA,UAAUC,KAAK,IAAIA;GACnD,MAAMvB,UAAU2D,aAAaD,QAAQE,KAAAA,CAAS;GAC9C,IAAIhC,QAAQtB,OAAOmD,SAAS;GAC5B,MAAMf,SAAS,MAAMhB,YAAYC,MAAMgC,aAAa/B,OAAO;GAC3D,IAAIc,WAAWkB,KAAAA,KAAalB,WAAW,QAAQA,WAAW,IACxDc,OAAOK,KAAKnB,MAAoB;EACpC,SAASoB,OAAO;GACdN,OAAOK,MACHC,iBAAiBC,QAAQD,MAAMtC,WAAWG,KAAKH,UAAUsC,UACzDnC,KAAKH,YACJG,KAAKd,WAAW,aAAa,gBAClC;EACF;EACA,IAAI2C,OAAOQ,UAAUT,WAAW,SAAS;CAC3C;CACA,OAAOC;AACT"}

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

@@ -1,7 +1,6 @@
 
 //#region src/components/form/Form/modern/values.d.ts
 /** A string is a literal field name; tuples explicitly address nested values. */
-type FormPath = string | readonly (string | number)[];
+export type FormPath = string | readonly (string | number)[];
 //#endregion
-export { FormPath };
 //# sourceMappingURL=values.d.ts.map

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

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.197.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.1 | Cube Dev Team */
 //#region src/components/form/Form/modern/values.ts
 const ownedContainers = /* @__PURE__ */ new WeakSet();
 function freezeContainer(value) {
@@ -152,7 +152,7 @@ function readonlySet(values) {
 function sameMembers(a, b) {
 	return a.size === b.size && Array.from(a).every((value) => b.has(value));
 }
-
 //#endregion
 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":["FormPath","Container","Record","ownedContainers","WeakSet","freezeContainer","value","T","add","Object","freeze","isPlainObject","prototype","getPrototypeOf","isContainer","Array","isArray","enumerableKeys","Reflect","ownKeys","filter","key","propertyIsEnumerable","call","defineValue","container","PropertyKey","defineProperty","enumerable","writable","configurable","emptyCopy","length","create","copyContainer","copy","get","formValueEqual","a","b","is","keys","every","hasOwn","normalizePath","path","parts","Error","from","part","Number","isSafeInteger","String","getFieldKey","map","replace","join","getFieldPath","index","push","readPath","root","undefined","hasPath","parent","slice","pathValueChanged","previous","next","writePath","remove","write","current","depth","exists","last","test","deleteProperty","createValueSnapshotter","copies","WeakMap","snapshot","pending","entries","clone","input","has","set","result","readonlySet","values","Iterable","ReadonlySet","Set","view","size","Symbol","iterator","forEach","callback","thisArg","sameMembers"],"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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"}
+{"version":3,"file":"values.js","names":["FormPath","Container","Record","ownedContainers","WeakSet","freezeContainer","value","T","add","Object","freeze","isPlainObject","prototype","getPrototypeOf","isContainer","Array","isArray","enumerableKeys","Reflect","ownKeys","filter","key","propertyIsEnumerable","call","defineValue","container","PropertyKey","defineProperty","enumerable","writable","configurable","emptyCopy","length","create","copyContainer","copy","get","formValueEqual","a","b","is","keys","every","hasOwn","normalizePath","path","parts","Error","from","part","Number","isSafeInteger","String","getFieldKey","map","replace","join","getFieldPath","index","push","readPath","root","undefined","hasPath","parent","slice","pathValueChanged","previous","next","writePath","remove","write","current","depth","exists","last","test","deleteProperty","createValueSnapshotter","copies","WeakMap","snapshot","pending","entries","clone","input","has","set","result","readonlySet","values","Iterable","ReadonlySet","Set","view","size","Symbol","iterator","forEach","callback","thisArg","sameMembers"],"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/reset-unbound-controls.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.197.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.1 | Cube Dev Team */
 //#region src/components/form/Form/reset-unbound-controls.ts
 /**
 * Both form roots cancel a native reset, because the browser would put a bound
@@ -27,13 +27,11 @@ function resetUnboundControls(form, isBound) {
 				text.value = text.defaultValue;
 				break;
 			}
-			case "SELECT":
-				for (const option of Array.from(control.options)) option.selected = option.defaultSelected;
-				break;
+			case "SELECT": for (const option of Array.from(control.options)) option.selected = option.defaultSelected;
 		}
 	}
 }
-
 //#endregion
 export { resetUnboundControls };
+
 //# sourceMappingURL=reset-unbound-controls.js.map

package/dist/components/form/Form/reset-unbound-controls.js.map

@@ -1 +1 @@
-{"version":3,"file":"reset-unbound-controls.js","names":["resetUnboundControls","form","HTMLFormElement","isBound","name","control","Array","from","elements","getAttribute","tagName","input","HTMLInputElement","type","checked","defaultChecked","value","defaultValue","text","HTMLTextAreaElement","HTMLOutputElement","option","HTMLSelectElement","options","selected","defaultSelected"],"sources":["../../../../src/components/form/Form/reset-unbound-controls.ts"],"sourcesContent":["/**\n * Both form roots cancel a native reset, because the browser would put a bound\n * input back to what it rendered on mount, which is not the form's default once\n * defaults arrive after mount. The browser still owes that reset to every\n * control the form does not own, such as a bare `<input name=\"token\">` in an\n * `action` form, so this runs the HTML reset algorithm on each named control\n * that `isBound` rejects. Unnamed controls are left alone: nothing submits\n * them, and they include inputs that React Aria renders and React controls.\n */\nexport function resetUnboundControls(\n  form: HTMLFormElement,\n  isBound: (name: string) => boolean,\n) {\n  for (const control of Array.from(form.elements)) {\n    const name = control.getAttribute('name');\n\n    if (!name || isBound(name)) continue;\n\n    switch (control.tagName) {\n      case 'INPUT': {\n        const input = control as HTMLInputElement;\n\n        if (input.type === 'checkbox' || input.type === 'radio') {\n          input.checked = input.defaultChecked;\n        } else if (input.type === 'file') {\n          input.value = '';\n        } else if (input.type !== 'hidden') {\n          input.value = input.defaultValue;\n        }\n        break;\n      }\n      case 'TEXTAREA':\n      case 'OUTPUT': {\n        const text = control as HTMLTextAreaElement | HTMLOutputElement;\n\n        text.value = text.defaultValue;\n        break;\n      }\n      case 'SELECT':\n        for (const option of Array.from(\n          (control as HTMLSelectElement).options,\n        )) {\n          option.selected = option.defaultSelected;\n        }\n        break;\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;AASA,SAAgBA,qBACdC,MACAE,SACA;AACA,MAAK,MAAME,WAAWC,MAAMC,KAAKN,KAAKO,SAAS,EAAE;EAC/C,MAAMJ,OAAOC,QAAQI,aAAa,OAAO;AAEzC,MAAI,CAACL,QAAQD,QAAQC,KAAK,CAAE;AAE5B,UAAQC,QAAQK,SAAhB;GACE,KAAK,SAAS;IACZ,MAAMC,QAAQN;AAEd,QAAIM,MAAME,SAAS,cAAcF,MAAME,SAAS,QAC9CF,OAAMG,UAAUH,MAAMI;aACbJ,MAAME,SAAS,OACxBF,OAAMK,QAAQ;aACLL,MAAME,SAAS,SACxBF,OAAMK,QAAQL,MAAMM;AAEtB;;GAEF,KAAK;GACL,KAAK,UAAU;IACb,MAAMC,OAAOb;AAEba,SAAKF,QAAQE,KAAKD;AAClB;;GAEF,KAAK;AACH,SAAK,MAAMI,UAAUf,MAAMC,KACxBF,QAA8BkB,QAChC,CACCF,QAAOG,WAAWH,OAAOI;AAE3B"}
+{"version":3,"file":"reset-unbound-controls.js","names":["resetUnboundControls","form","HTMLFormElement","isBound","name","control","Array","from","elements","getAttribute","tagName","input","HTMLInputElement","type","checked","defaultChecked","value","defaultValue","text","HTMLTextAreaElement","HTMLOutputElement","option","HTMLSelectElement","options","selected","defaultSelected"],"sources":["../../../../src/components/form/Form/reset-unbound-controls.ts"],"sourcesContent":["/**\n * Both form roots cancel a native reset, because the browser would put a bound\n * input back to what it rendered on mount, which is not the form's default once\n * defaults arrive after mount. The browser still owes that reset to every\n * control the form does not own, such as a bare `<input name=\"token\">` in an\n * `action` form, so this runs the HTML reset algorithm on each named control\n * that `isBound` rejects. Unnamed controls are left alone: nothing submits\n * them, and they include inputs that React Aria renders and React controls.\n */\nexport function resetUnboundControls(\n  form: HTMLFormElement,\n  isBound: (name: string) => boolean,\n) {\n  for (const control of Array.from(form.elements)) {\n    const name = control.getAttribute('name');\n\n    if (!name || isBound(name)) continue;\n\n    switch (control.tagName) {\n      case 'INPUT': {\n        const input = control as HTMLInputElement;\n\n        if (input.type === 'checkbox' || input.type === 'radio') {\n          input.checked = input.defaultChecked;\n        } else if (input.type === 'file') {\n          input.value = '';\n        } else if (input.type !== 'hidden') {\n          input.value = input.defaultValue;\n        }\n        break;\n      }\n      case 'TEXTAREA':\n      case 'OUTPUT': {\n        const text = control as HTMLTextAreaElement | HTMLOutputElement;\n\n        text.value = text.defaultValue;\n        break;\n      }\n      case 'SELECT':\n        for (const option of Array.from(\n          (control as HTMLSelectElement).options,\n        )) {\n          option.selected = option.defaultSelected;\n        }\n        break;\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;AASA,SAAgBA,qBACdC,MACAE,SACA;CACA,KAAK,MAAME,WAAWC,MAAMC,KAAKN,KAAKO,QAAQ,GAAG;EAC/C,MAAMJ,OAAOC,QAAQI,aAAa,MAAM;EAExC,IAAI,CAACL,QAAQD,QAAQC,IAAI,GAAG;EAE5B,QAAQC,QAAQK,SAAhB;GACE,KAAK,SAAS;IACZ,MAAMC,QAAQN;IAEd,IAAIM,MAAME,SAAS,cAAcF,MAAME,SAAS,SAC9CF,MAAMG,UAAUH,MAAMI;SACjB,IAAIJ,MAAME,SAAS,QACxBF,MAAMK,QAAQ;SACT,IAAIL,MAAME,SAAS,UACxBF,MAAMK,QAAQL,MAAMM;IAEtB;GACF;GACA,KAAK;GACL,KAAK,UAAU;IACb,MAAMC,OAAOb;IAEba,KAAKF,QAAQE,KAAKD;IAClB;GACF;GACA,KAAK,UACH,KAAK,MAAMI,UAAUf,MAAMC,KACxBF,QAA8BkB,OACjC,GACEF,OAAOG,WAAWH,OAAOI;EAG/B;CACF;AACF"}

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

@@ -1,11 +1,10 @@
 
 import { ReactNode } from "react";
-
 //#region src/components/form/Form/types.d.ts
-type FieldTypes = {
+export type FieldTypes = {
   [key: string]: any;
 };
-type CubeFieldData<Name extends string, Value> = {
+export type CubeFieldData<Name extends string, Value> = {
   readonly name: Name;
   errors: ReactNode[];
   value?: Value;
@@ -16,8 +15,7 @@ type CubeFieldData<Name extends string, Value> = {
   status?: 'valid' | 'invalid';
   validationDetails?: ValidityState;
 };
-type Fields = Record<keyof FieldTypes, CubeFieldData<string, any>>;
-type SetFieldsArrType<T extends FieldTypes, Name extends keyof T & string> = CubeFieldData<Name, T[Name]>;
+export type Fields = Record<keyof FieldTypes, CubeFieldData<string, any>>;
+export type SetFieldsArrType<T extends FieldTypes, Name extends keyof T & string> = CubeFieldData<Name, T[Name]>;
 //#endregion
-export { CubeFieldData, FieldTypes, Fields, SetFieldsArrType };
 //# sourceMappingURL=types.d.ts.map

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

@@ -1,4 +1,5 @@
 
 import { FieldReturnValue, UseFieldProps } from "./types.js";
 import { UseFieldParams, useField } from "./use-field.js";
-import { UseFieldPropsParams, useFieldProps } from "./use-field-props.js";
+import { UseFieldPropsParams, useFieldProps } from "./use-field-props.js";
+export { FieldReturnValue, UseFieldParams, UseFieldProps, UseFieldPropsParams, useField, useFieldProps };

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

@@ -5,9 +5,8 @@ import "../../../../shared/index.js";
 import { CubeFieldData, FieldTypes } from "../types.js";
 import { CubeFormInstance } from "../use-form.js";
 import { ReactNode } from "react";
-
 //#region src/components/form/Form/use-field/types.d.ts
-interface UseFieldProps<T extends FieldTypes> extends FieldCoreProps, ValidationProps {
+export interface UseFieldProps<T extends FieldTypes> extends FieldCoreProps, ValidationProps {
   /** The initial value of the input. */
   defaultValue?: any;
   /** The form instance */
@@ -29,7 +28,7 @@ interface UseFieldProps<T extends FieldTypes> extends FieldCoreProps, Validation
    */
   necessityIndicator?: NecessityIndicator | null;
 }
-type FieldReturnValue<T extends FieldTypes> = ValidationProps & {
+export type FieldReturnValue<T extends FieldTypes> = ValidationProps & {
   id: string;
   name: string;
   value: any;
@@ -40,8 +39,10 @@ type FieldReturnValue<T extends FieldTypes> = ValidationProps & {
    * @deprecated Use `errorMessage` for error messages and `description` for field descriptions instead.
    * Message for the field. Some additional information or error notice
    */
-  message?: ReactNode; /** Description for the field. Will be placed below the label */
-  description?: ReactNode; /** Error message for the field. Always displayed in danger state regardless of validation state */
+  message?: ReactNode;
+  /** Description for the field. Will be placed below the label */
+  description?: ReactNode;
+  /** Error message for the field. Always displayed in danger state regardless of validation state */
   errorMessage?: ReactNode;
   isRequired?: boolean;
   /**
@@ -56,5 +57,4 @@ type FieldReturnValue<T extends FieldTypes> = ValidationProps & {
   field?: CubeFieldData<keyof FieldTypes & string, T[keyof FieldTypes]>;
 };
 //#endregion
-export { FieldReturnValue, UseFieldProps };
 //# sourceMappingURL=types.d.ts.map

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

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.197.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.198.1 | 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";
@@ -8,7 +8,6 @@ import { createModernFieldBackend, fieldRegistrationOptions, sameFieldView } fro
 import { c } from "react/compiler-runtime";
 import { useRef } from "react";
 import { useSyncExternalStoreWithSelector } from "use-sync-external-store/with-selector.js";
-
 //#region src/components/form/Form/use-field/use-field-binding.ts
 const noop = () => {};
 const selectView = (view) => view;
@@ -264,7 +263,7 @@ function _temp2() {}
 function _temp() {
 	return noop;
 }
-
 //#endregion
 export { useFieldBinding };
+
 //# sourceMappingURL=use-field-binding.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"use-field-binding.js","names":["useMemo","useRef","useSyncExternalStoreWithSelector","useEvent","useLayoutEffect","isModernFormController","createModernFieldBackend","fieldRegistrationOptions","sameFieldView","getFieldKey","getFieldPath","normalizePath","writePath","useField","ReactNode","FormController","FieldBackendHandle","FieldView","RegistrationToken","FieldTypes","FieldReturnValue","UseFieldProps","UseFieldParams","noop","selectView","view","useFieldBinding","props","params","generatedId","$","_c","t0","unbound","form","modern","controller","undefined","path","field","name","t1","t2","pathKey","Error","t3","t4","t5","legacy","t6","modernHandle","t7","errors","t8","status","t9","value","snapshot","t10","t11","t12","dontTouch","trigger","onChange","t13","onBlur","subscribe","_temp","getSnapshot","getServerSnapshot","register","_temp2","change","blur","legacyHandle","handle","registration","t14","t15","token","current","release","deferValueRemoval","t16","defaultValidationTrigger","update","trigger_0","validateTrigger","t17","value_0","dontTouch_0","shouldUpdate","previous","getValues","t18","t19","isRequired","rules","flat","Infinity","some","_temp3","required","id","idPrefix","t20","defaultValue","t21","isInvalid","length","t22","isValid","showValid","t23","isLoading","t24","t25","necessityIndicator","t26","message","t27","errorMessage","t28","description","nonInput","rule"],"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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"}
+{"version":3,"file":"use-field-binding.js","names":["useMemo","useRef","useSyncExternalStoreWithSelector","useEvent","useLayoutEffect","isModernFormController","createModernFieldBackend","fieldRegistrationOptions","sameFieldView","getFieldKey","getFieldPath","normalizePath","writePath","useField","ReactNode","FormController","FieldBackendHandle","FieldView","RegistrationToken","FieldTypes","FieldReturnValue","UseFieldProps","UseFieldParams","noop","selectView","view","useFieldBinding","props","params","generatedId","$","_c","t0","unbound","form","modern","controller","undefined","path","field","name","t1","t2","pathKey","Error","t3","t4","t5","legacy","t6","modernHandle","t7","errors","t8","status","t9","value","snapshot","t10","t11","t12","dontTouch","trigger","onChange","t13","onBlur","subscribe","_temp","getSnapshot","getServerSnapshot","register","_temp2","change","blur","legacyHandle","handle","registration","t14","t15","token","current","release","deferValueRemoval","t16","defaultValidationTrigger","update","trigger_0","validateTrigger","t17","value_0","dontTouch_0","shouldUpdate","previous","getValues","t18","t19","isRequired","rules","flat","Infinity","some","_temp3","required","id","idPrefix","t20","defaultValue","t21","isInvalid","length","t22","isValid","showValid","t23","isLoading","t24","t25","necessityIndicator","t26","message","t27","errorMessage","t28","description","nonInput","rule","_c","legacyHandle"],"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

@@ -4,13 +4,9 @@ import { ValidateTrigger } from "../../../../shared/form.js";
 import "../../../../shared/index.js";
 import { FieldTypes } from "../types.js";
 import { UseFieldProps } from "./types.js";
-
 //#region src/components/form/Form/use-field/use-field-props.d.ts
-type UseFieldPropsParams = {
-  valuePropsMapper?: ({
-    value,
-    onChange
-  }: {
+export type UseFieldPropsParams = {
+  valuePropsMapper?: ({ value, onChange }: {
     value: any;
     onChange: any;
   }) => any;
@@ -23,6 +19,12 @@ type UseFieldPropsParams = {
    * If you want to change this prop after mount, remount the component with a new value.
    */
   unsafe__isDisabled?: boolean;
+  /**
+   * The control shows the errors of its `validate` under itself, so a
+   * `validate` asks for the field chrome even without a label.
+   * @default false
+   */
+  showsValidateErrors?: boolean;
 };
 /** Binding inputs `useFieldProps` always strips before it returns. */
 type StrippedFieldKey = 'field' | 'dependsOn' | 'deps';
@@ -36,7 +38,7 @@ type ResolvedFieldForm<Form> = Form extends ModernFormBrand ? undefined : Form;
  * The input's declared prop shape minus what the hook always strips: a DOM-safe
  * name, no binding inputs, and no modern controller in `form`.
  */
-type ResolvedFieldProps<Props> = { [Key in keyof Props as Key extends StrippedFieldKey ? never : Key]: Key extends 'name' ? string | undefined : Key extends 'form' ? ResolvedFieldForm<Props[Key]> : Props[Key] };
+type ResolvedFieldProps<Props> = { [Key in keyof Props as Key extends StrippedFieldKey ? never : Key]: Key extends 'name' ? string | undefined : Key extends 'form' ? ResolvedFieldForm<Props[Key]> : Props[Key]; };
 /**
  * The single entry point for input components (see
  * `docs/rules/input-components.md`).
@@ -48,7 +50,7 @@ type ResolvedFieldProps<Props> = { [Key in keyof Props as Key extends StrippedFi
  * 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): ResolvedFieldProps<Props>;
+export declare function useFieldProps<T extends FieldTypes, Props extends UseFieldProps<T>>(inputProps: Props, params?: UseFieldPropsParams): ResolvedFieldProps<Props>;
 //#endregion
-export { UseFieldPropsParams, useFieldProps };
+export {};
 //# sourceMappingURL=use-field-props.d.ts.map