@conform-to/react 1.8.2 → 1.9.1

package/dist/future/state.d.ts

@@ -0,0 +1,57 @@
+import { type ValidationAttributes, type Serialize } from '@conform-to/dom/future';
+import type { DefaultFieldMetadata, Field, FieldName, Fieldset, FormContext, FormMetadata, FormState, FormAction, UnknownIntent, ActionHandler } from './types';
+export declare function initializeState<ErrorShape>(): FormState<ErrorShape>;
+/**
+ * Updates form state based on action type:
+ * - Client actions: update intended value and client errors
+ * - Server actions: update server errors and clear client errors
+ * - Initialize: set initial intended value
+ */
+export declare function updateState<ErrorShape>(state: FormState<ErrorShape>, action: FormAction<ErrorShape, UnknownIntent | null, {
+    handlers: Record<string, ActionHandler>;
+    reset: () => FormState<ErrorShape>;
+}>): FormState<ErrorShape>;
+export declare function getDefaultValue(context: FormContext<any>, name: string, serialize?: Serialize): string | undefined;
+export declare function getDefaultOptions(context: FormContext<any>, name: string, serialize?: Serialize): string[] | undefined;
+export declare function isDefaultChecked(context: FormContext<any>, name: string, serialize?: Serialize): boolean;
+/**
+ * Determine if the field is touched
+ *
+ * This checks if the field is in the list of touched fields,
+ * or if there is any child field that is touched, i.e. form / fieldset
+ */
+export declare function isTouched(state: FormState<any>, name?: string): boolean;
+export declare function getDefaultListKey(prefix: string, initialValue: Record<string, unknown> | null, name: string): string[];
+export declare function getListKey(context: FormContext<any>, name: string): string[];
+export declare function getErrors<ErrorShape>(state: FormState<ErrorShape>, name?: string): ErrorShape[] | undefined;
+export declare function getFieldErrors<ErrorShape>(state: FormState<ErrorShape>, name?: string): Record<string, ErrorShape[]>;
+/**
+ * Gets validation constraint for a field, with fallback to parent array patterns.
+ * e.g. "array[0].key" falls back to "array[].key" if specific constraint not found.
+ */
+export declare function getConstraint(context: FormContext<any>, name: string): ValidationAttributes | undefined;
+export declare function getFormMetadata<ErrorShape>(context: FormContext<ErrorShape>, options: {
+    serialize: Serialize;
+}): FormMetadata<ErrorShape, DefaultFieldMetadata<ErrorShape>>;
+export declare function getField<FieldShape, ErrorShape = string>(context: FormContext<ErrorShape>, options: {
+    name: FieldName<FieldShape>;
+    serialize: Serialize;
+    key?: string;
+}): Field<FieldShape, DefaultFieldMetadata<ErrorShape>>;
+/**
+ * Creates a proxy that dynamically generates field objects when properties are accessed.
+ */
+export declare function getFieldset<FieldShape = Record<string, any>, ErrorShape = string>(context: FormContext<ErrorShape>, options: {
+    name?: FieldName<FieldShape>;
+    serialize: Serialize;
+}): Fieldset<FieldShape, DefaultFieldMetadata<ErrorShape>>;
+/**
+ * Creates an array of field objects for list/array inputs
+ */
+export declare function getFieldList<FieldShape = Array<any>, ErrorShape = string>(context: FormContext<ErrorShape>, options: {
+    name: FieldName<FieldShape>;
+    serialize: Serialize;
+}): Field<[
+    FieldShape
+] extends [Array<infer ItemShape> | null | undefined] ? ItemShape : unknown, DefaultFieldMetadata<ErrorShape>>[];
+//# sourceMappingURL=state.d.ts.map

package/dist/future/state.js

@@ -0,0 +1,318 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _rollupPluginBabelHelpers = require('../_virtual/_rollupPluginBabelHelpers.js');
+var future = require('@conform-to/dom/future');
+var util = require('./util.js');
+
+function initializeState() {
+  return {
+    resetKey: util.generateUniqueKey(),
+    listKeys: {},
+    intendedValue: null,
+    serverValidatedValue: null,
+    serverError: null,
+    clientError: null,
+    touchedFields: []
+  };
+}
+
+/**
+ * Updates form state based on action type:
+ * - Client actions: update intended value and client errors
+ * - Server actions: update server errors and clear client errors
+ * - Initialize: set initial intended value
+ */
+function updateState(state, action) {
+  var _action$intendedValue, _action$intendedValue2;
+  if (action.intendedValue === null) {
+    return action.ctx.reset();
+  }
+  var value = (_action$intendedValue = action.intendedValue) !== null && _action$intendedValue !== void 0 ? _action$intendedValue : action.submission.payload;
+
+  // Apply the form error and intended value from the result first
+  state = action.type === 'client' ? util.merge(state, {
+    intendedValue: !action.intent ? value : (_action$intendedValue2 = action.intendedValue) !== null && _action$intendedValue2 !== void 0 ? _action$intendedValue2 : state.intendedValue,
+    // Update client error only if the error is different from the previous one to minimize unnecessary re-renders
+    clientError: typeof action.error !== 'undefined' && !future.deepEqual(state.clientError, action.error) ? action.error : state.clientError,
+    // Reset server error if form value is changed
+    serverError: typeof action.error !== 'undefined' && !future.deepEqual(state.serverValidatedValue, value) ? null : state.serverError
+  }) : util.merge(state, {
+    intendedValue: action.type === 'initialize' ? value : state.intendedValue,
+    // Clear client error to avoid showing stale errors
+    clientError: null,
+    // Update server error if the error is defined.
+    // There is no need to check if the error is different as we are updating other states as well
+    serverError: typeof action.error !== 'undefined' ? action.error : state.serverError,
+    // Keep track of the value that the serverError is based on
+    serverValidatedValue: typeof action.error !== 'undefined' ? value : state.serverValidatedValue
+  });
+  if (action.type !== 'server' && typeof action.intent !== 'undefined') {
+    var _action$intent, _action$ctx$handlers;
+    // Validate the whole form if no intent is provided (default submission)
+    var intent = (_action$intent = action.intent) !== null && _action$intent !== void 0 ? _action$intent : {
+      type: 'validate'
+    };
+    var handler = (_action$ctx$handlers = action.ctx.handlers) === null || _action$ctx$handlers === void 0 ? void 0 : _action$ctx$handlers[intent.type];
+    if (typeof (handler === null || handler === void 0 ? void 0 : handler.onUpdate) === 'function') {
+      var _handler$validatePayl, _handler$validatePayl2;
+      if ((_handler$validatePayl = (_handler$validatePayl2 = handler.validatePayload) === null || _handler$validatePayl2 === void 0 ? void 0 : _handler$validatePayl2.call(handler, intent.payload)) !== null && _handler$validatePayl !== void 0 ? _handler$validatePayl : true) {
+        return handler.onUpdate(state, _rollupPluginBabelHelpers.objectSpread2(_rollupPluginBabelHelpers.objectSpread2({}, action), {}, {
+          intent: {
+            type: intent.type,
+            payload: intent.payload
+          }
+        }));
+      }
+    }
+  }
+  return state;
+}
+function getDefaultValue(context, name) {
+  var _ref, _context$state$intend;
+  var serialize = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : future.serialize;
+  var value = future.getValueAtPath((_ref = (_context$state$intend = context.state.intendedValue) !== null && _context$state$intend !== void 0 ? _context$state$intend : context.defaultValue) !== null && _ref !== void 0 ? _ref : {}, name);
+  var serializedValue = serialize(value);
+  if (typeof serializedValue === 'string') {
+    return serializedValue;
+  }
+}
+function getDefaultOptions(context, name) {
+  var _ref2, _context$state$intend2;
+  var serialize = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : future.serialize;
+  var value = future.getValueAtPath((_ref2 = (_context$state$intend2 = context.state.intendedValue) !== null && _context$state$intend2 !== void 0 ? _context$state$intend2 : context.defaultValue) !== null && _ref2 !== void 0 ? _ref2 : {}, name);
+  var serializedValue = typeof value !== 'undefined' ? serialize(value) : undefined;
+  if (Array.isArray(serializedValue) && serializedValue.every(item => typeof item === 'string')) {
+    return serializedValue;
+  }
+  if (typeof serializedValue === 'string') {
+    return [serializedValue];
+  }
+}
+function isDefaultChecked(context, name) {
+  var _ref3, _context$state$intend3;
+  var serialize = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : future.serialize;
+  var value = future.getValueAtPath((_ref3 = (_context$state$intend3 = context.state.intendedValue) !== null && _context$state$intend3 !== void 0 ? _context$state$intend3 : context.defaultValue) !== null && _ref3 !== void 0 ? _ref3 : {}, name);
+  var serializedValue = typeof value !== 'undefined' ? serialize(value) : undefined;
+  return serializedValue === 'on';
+}
+
+/**
+ * Determine if the field is touched
+ *
+ * This checks if the field is in the list of touched fields,
+ * or if there is any child field that is touched, i.e. form / fieldset
+ */
+function isTouched(state) {
+  var name = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : '';
+  if (state.touchedFields.includes(name)) {
+    return true;
+  }
+  var paths = future.getPathSegments(name);
+  return state.touchedFields.some(field => field !== name && future.getRelativePath(field, paths) !== null);
+}
+function getDefaultListKey(prefix, initialValue, name) {
+  return util.getArrayAtPath(initialValue, name).map((_, index) => "".concat(prefix, "-").concat(future.appendPathSegment(name, index)));
+}
+function getListKey(context, name) {
+  var _context$state$listKe, _context$state$listKe2, _context$state$intend4;
+  return (_context$state$listKe = (_context$state$listKe2 = context.state.listKeys) === null || _context$state$listKe2 === void 0 ? void 0 : _context$state$listKe2[name]) !== null && _context$state$listKe !== void 0 ? _context$state$listKe : getDefaultListKey(context.state.resetKey, (_context$state$intend4 = context.state.intendedValue) !== null && _context$state$intend4 !== void 0 ? _context$state$intend4 : context.defaultValue, name);
+}
+function getErrors(state, name) {
+  var _state$serverError;
+  var error = (_state$serverError = state.serverError) !== null && _state$serverError !== void 0 ? _state$serverError : state.clientError;
+  if (!error || !isTouched(state, name)) {
+    return;
+  }
+  var errors = name ? error.fieldErrors[name] : error.formErrors;
+  if (errors && errors.length > 0) {
+    return errors;
+  }
+}
+function getFieldErrors(state, name) {
+  var result = {};
+  var basePath = future.getPathSegments(name);
+  for (var field of state.touchedFields) {
+    var relativePath = future.getRelativePath(field, basePath);
+    if (!relativePath || relativePath.length === 0) {
+      continue;
+    }
+    var error = getErrors(state, field);
+    if (typeof error !== 'undefined') {
+      result[future.formatPathSegments(relativePath)] = error;
+    }
+  }
+  return result;
+}
+
+/**
+ * Gets validation constraint for a field, with fallback to parent array patterns.
+ * e.g. "array[0].key" falls back to "array[].key" if specific constraint not found.
+ */
+function getConstraint(context, name) {
+  var _context$constraint;
+  var constraint = (_context$constraint = context.constraint) === null || _context$constraint === void 0 ? void 0 : _context$constraint[name];
+  if (!constraint) {
+    var path = future.getPathSegments(name);
+    for (var i = path.length - 1; i >= 0; i--) {
+      var segment = path[i];
+      // Try searching a less specific path for the constraint
+      // e.g. `array[0].anotherArray[1].key` -> `array[0].anotherArray[].key` -> `array[].anotherArray[].key`
+      if (typeof segment === 'number') {
+        // This overrides the current number segment with an empty string
+        // which will be treated as an empty bracket
+        path[i] = '';
+        break;
+      }
+    }
+    var alternative = future.formatPathSegments(path);
+    if (name !== alternative) {
+      constraint = getConstraint(context, alternative);
+    }
+  }
+  return constraint;
+}
+function getFormMetadata(context, options) {
+  return {
+    key: context.state.resetKey,
+    id: context.formId,
+    errorId: "".concat(context.formId, "-form-error"),
+    descriptionId: "".concat(context.formId, "-form-description"),
+    get errors() {
+      return getErrors(context.state);
+    },
+    get fieldErrors() {
+      return getFieldErrors(context.state);
+    },
+    get touched() {
+      return isTouched(context.state);
+    },
+    get valid() {
+      return typeof getErrors(context.state) === 'undefined';
+    },
+    get invalid() {
+      return !this.valid;
+    },
+    props: {
+      id: context.formId,
+      onSubmit: context.handleSubmit,
+      onInput: context.handleInput,
+      onBlur: context.handleBlur,
+      noValidate: true
+    },
+    context,
+    getField(name) {
+      return getField(context, _rollupPluginBabelHelpers.objectSpread2(_rollupPluginBabelHelpers.objectSpread2({}, options), {}, {
+        name
+      }));
+    },
+    getFieldset(name) {
+      return getFieldset(context, _rollupPluginBabelHelpers.objectSpread2(_rollupPluginBabelHelpers.objectSpread2({}, options), {}, {
+        name
+      }));
+    },
+    getFieldList(name) {
+      return getFieldList(context, _rollupPluginBabelHelpers.objectSpread2(_rollupPluginBabelHelpers.objectSpread2({}, options), {}, {
+        name
+      }));
+    }
+  };
+}
+function getField(context, options) {
+  var id = "".concat(context.formId, "-field-").concat(options.name.replace(/[^a-zA-Z0-9._-]/g, '_'));
+  var constraint = getConstraint(context, options.name);
+  var metadata = {
+    id: id,
+    descriptionId: "".concat(id, "-description"),
+    errorId: "".concat(id, "-error"),
+    formId: context.formId,
+    required: constraint === null || constraint === void 0 ? void 0 : constraint.required,
+    minLength: constraint === null || constraint === void 0 ? void 0 : constraint.minLength,
+    maxLength: constraint === null || constraint === void 0 ? void 0 : constraint.maxLength,
+    pattern: constraint === null || constraint === void 0 ? void 0 : constraint.pattern,
+    min: constraint === null || constraint === void 0 ? void 0 : constraint.min,
+    max: constraint === null || constraint === void 0 ? void 0 : constraint.max,
+    step: constraint === null || constraint === void 0 ? void 0 : constraint.step,
+    multiple: constraint === null || constraint === void 0 ? void 0 : constraint.multiple,
+    get defaultValue() {
+      return getDefaultValue(context, options.name, options.serialize);
+    },
+    get defaultOptions() {
+      return getDefaultOptions(context, options.name, options.serialize);
+    },
+    get defaultChecked() {
+      return isDefaultChecked(context, options.name, options.serialize);
+    },
+    get touched() {
+      return isTouched(context.state, options.name);
+    },
+    get valid() {
+      return typeof getErrors(context.state, options.name) === 'undefined';
+    },
+    get invalid() {
+      return !this.valid;
+    },
+    get errors() {
+      return getErrors(context.state, options.name);
+    },
+    get fieldErrors() {
+      return getFieldErrors(context.state, options.name);
+    }
+  };
+  return Object.assign(metadata, {
+    key: options.key,
+    name: options.name,
+    getFieldset() {
+      return getFieldset(context, options);
+    },
+    getFieldList() {
+      return getFieldList(context, options);
+    }
+  });
+}
+
+/**
+ * Creates a proxy that dynamically generates field objects when properties are accessed.
+ */
+function getFieldset(context, options) {
+  return new Proxy({}, {
+    get(target, name, receiver) {
+      if (typeof name === 'string') {
+        return getField(context, _rollupPluginBabelHelpers.objectSpread2(_rollupPluginBabelHelpers.objectSpread2({}, options), {}, {
+          name: future.appendPathSegment(options === null || options === void 0 ? void 0 : options.name, name)
+        }));
+      }
+      return Reflect.get(target, name, receiver);
+    }
+  });
+}
+
+/**
+ * Creates an array of field objects for list/array inputs
+ */
+function getFieldList(context, options) {
+  var keys = getListKey(context, options.name);
+  return keys.map((key, index) => {
+    return getField(context, _rollupPluginBabelHelpers.objectSpread2(_rollupPluginBabelHelpers.objectSpread2({}, options), {}, {
+      name: future.appendPathSegment(options.name, index),
+      key
+    }));
+  });
+}
+
+exports.getConstraint = getConstraint;
+exports.getDefaultListKey = getDefaultListKey;
+exports.getDefaultOptions = getDefaultOptions;
+exports.getDefaultValue = getDefaultValue;
+exports.getErrors = getErrors;
+exports.getField = getField;
+exports.getFieldErrors = getFieldErrors;
+exports.getFieldList = getFieldList;
+exports.getFieldset = getFieldset;
+exports.getFormMetadata = getFormMetadata;
+exports.getListKey = getListKey;
+exports.initializeState = initializeState;
+exports.isDefaultChecked = isDefaultChecked;
+exports.isTouched = isTouched;
+exports.updateState = updateState;

package/dist/future/state.mjs

@@ -0,0 +1,300 @@
+import { objectSpread2 as _objectSpread2 } from '../_virtual/_rollupPluginBabelHelpers.mjs';
+import { getPathSegments, getRelativePath, appendPathSegment, deepEqual, getValueAtPath, formatPathSegments, serialize } from '@conform-to/dom/future';
+import { generateUniqueKey, merge, getArrayAtPath } from './util.mjs';
+
+function initializeState() {
+  return {
+    resetKey: generateUniqueKey(),
+    listKeys: {},
+    intendedValue: null,
+    serverValidatedValue: null,
+    serverError: null,
+    clientError: null,
+    touchedFields: []
+  };
+}
+
+/**
+ * Updates form state based on action type:
+ * - Client actions: update intended value and client errors
+ * - Server actions: update server errors and clear client errors
+ * - Initialize: set initial intended value
+ */
+function updateState(state, action) {
+  var _action$intendedValue, _action$intendedValue2;
+  if (action.intendedValue === null) {
+    return action.ctx.reset();
+  }
+  var value = (_action$intendedValue = action.intendedValue) !== null && _action$intendedValue !== void 0 ? _action$intendedValue : action.submission.payload;
+
+  // Apply the form error and intended value from the result first
+  state = action.type === 'client' ? merge(state, {
+    intendedValue: !action.intent ? value : (_action$intendedValue2 = action.intendedValue) !== null && _action$intendedValue2 !== void 0 ? _action$intendedValue2 : state.intendedValue,
+    // Update client error only if the error is different from the previous one to minimize unnecessary re-renders
+    clientError: typeof action.error !== 'undefined' && !deepEqual(state.clientError, action.error) ? action.error : state.clientError,
+    // Reset server error if form value is changed
+    serverError: typeof action.error !== 'undefined' && !deepEqual(state.serverValidatedValue, value) ? null : state.serverError
+  }) : merge(state, {
+    intendedValue: action.type === 'initialize' ? value : state.intendedValue,
+    // Clear client error to avoid showing stale errors
+    clientError: null,
+    // Update server error if the error is defined.
+    // There is no need to check if the error is different as we are updating other states as well
+    serverError: typeof action.error !== 'undefined' ? action.error : state.serverError,
+    // Keep track of the value that the serverError is based on
+    serverValidatedValue: typeof action.error !== 'undefined' ? value : state.serverValidatedValue
+  });
+  if (action.type !== 'server' && typeof action.intent !== 'undefined') {
+    var _action$intent, _action$ctx$handlers;
+    // Validate the whole form if no intent is provided (default submission)
+    var intent = (_action$intent = action.intent) !== null && _action$intent !== void 0 ? _action$intent : {
+      type: 'validate'
+    };
+    var handler = (_action$ctx$handlers = action.ctx.handlers) === null || _action$ctx$handlers === void 0 ? void 0 : _action$ctx$handlers[intent.type];
+    if (typeof (handler === null || handler === void 0 ? void 0 : handler.onUpdate) === 'function') {
+      var _handler$validatePayl, _handler$validatePayl2;
+      if ((_handler$validatePayl = (_handler$validatePayl2 = handler.validatePayload) === null || _handler$validatePayl2 === void 0 ? void 0 : _handler$validatePayl2.call(handler, intent.payload)) !== null && _handler$validatePayl !== void 0 ? _handler$validatePayl : true) {
+        return handler.onUpdate(state, _objectSpread2(_objectSpread2({}, action), {}, {
+          intent: {
+            type: intent.type,
+            payload: intent.payload
+          }
+        }));
+      }
+    }
+  }
+  return state;
+}
+function getDefaultValue(context, name) {
+  var _ref, _context$state$intend;
+  var serialize$1 = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : serialize;
+  var value = getValueAtPath((_ref = (_context$state$intend = context.state.intendedValue) !== null && _context$state$intend !== void 0 ? _context$state$intend : context.defaultValue) !== null && _ref !== void 0 ? _ref : {}, name);
+  var serializedValue = serialize$1(value);
+  if (typeof serializedValue === 'string') {
+    return serializedValue;
+  }
+}
+function getDefaultOptions(context, name) {
+  var _ref2, _context$state$intend2;
+  var serialize$1 = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : serialize;
+  var value = getValueAtPath((_ref2 = (_context$state$intend2 = context.state.intendedValue) !== null && _context$state$intend2 !== void 0 ? _context$state$intend2 : context.defaultValue) !== null && _ref2 !== void 0 ? _ref2 : {}, name);
+  var serializedValue = typeof value !== 'undefined' ? serialize$1(value) : undefined;
+  if (Array.isArray(serializedValue) && serializedValue.every(item => typeof item === 'string')) {
+    return serializedValue;
+  }
+  if (typeof serializedValue === 'string') {
+    return [serializedValue];
+  }
+}
+function isDefaultChecked(context, name) {
+  var _ref3, _context$state$intend3;
+  var serialize$1 = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : serialize;
+  var value = getValueAtPath((_ref3 = (_context$state$intend3 = context.state.intendedValue) !== null && _context$state$intend3 !== void 0 ? _context$state$intend3 : context.defaultValue) !== null && _ref3 !== void 0 ? _ref3 : {}, name);
+  var serializedValue = typeof value !== 'undefined' ? serialize$1(value) : undefined;
+  return serializedValue === 'on';
+}
+
+/**
+ * Determine if the field is touched
+ *
+ * This checks if the field is in the list of touched fields,
+ * or if there is any child field that is touched, i.e. form / fieldset
+ */
+function isTouched(state) {
+  var name = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : '';
+  if (state.touchedFields.includes(name)) {
+    return true;
+  }
+  var paths = getPathSegments(name);
+  return state.touchedFields.some(field => field !== name && getRelativePath(field, paths) !== null);
+}
+function getDefaultListKey(prefix, initialValue, name) {
+  return getArrayAtPath(initialValue, name).map((_, index) => "".concat(prefix, "-").concat(appendPathSegment(name, index)));
+}
+function getListKey(context, name) {
+  var _context$state$listKe, _context$state$listKe2, _context$state$intend4;
+  return (_context$state$listKe = (_context$state$listKe2 = context.state.listKeys) === null || _context$state$listKe2 === void 0 ? void 0 : _context$state$listKe2[name]) !== null && _context$state$listKe !== void 0 ? _context$state$listKe : getDefaultListKey(context.state.resetKey, (_context$state$intend4 = context.state.intendedValue) !== null && _context$state$intend4 !== void 0 ? _context$state$intend4 : context.defaultValue, name);
+}
+function getErrors(state, name) {
+  var _state$serverError;
+  var error = (_state$serverError = state.serverError) !== null && _state$serverError !== void 0 ? _state$serverError : state.clientError;
+  if (!error || !isTouched(state, name)) {
+    return;
+  }
+  var errors = name ? error.fieldErrors[name] : error.formErrors;
+  if (errors && errors.length > 0) {
+    return errors;
+  }
+}
+function getFieldErrors(state, name) {
+  var result = {};
+  var basePath = getPathSegments(name);
+  for (var field of state.touchedFields) {
+    var relativePath = getRelativePath(field, basePath);
+    if (!relativePath || relativePath.length === 0) {
+      continue;
+    }
+    var error = getErrors(state, field);
+    if (typeof error !== 'undefined') {
+      result[formatPathSegments(relativePath)] = error;
+    }
+  }
+  return result;
+}
+
+/**
+ * Gets validation constraint for a field, with fallback to parent array patterns.
+ * e.g. "array[0].key" falls back to "array[].key" if specific constraint not found.
+ */
+function getConstraint(context, name) {
+  var _context$constraint;
+  var constraint = (_context$constraint = context.constraint) === null || _context$constraint === void 0 ? void 0 : _context$constraint[name];
+  if (!constraint) {
+    var path = getPathSegments(name);
+    for (var i = path.length - 1; i >= 0; i--) {
+      var segment = path[i];
+      // Try searching a less specific path for the constraint
+      // e.g. `array[0].anotherArray[1].key` -> `array[0].anotherArray[].key` -> `array[].anotherArray[].key`
+      if (typeof segment === 'number') {
+        // This overrides the current number segment with an empty string
+        // which will be treated as an empty bracket
+        path[i] = '';
+        break;
+      }
+    }
+    var alternative = formatPathSegments(path);
+    if (name !== alternative) {
+      constraint = getConstraint(context, alternative);
+    }
+  }
+  return constraint;
+}
+function getFormMetadata(context, options) {
+  return {
+    key: context.state.resetKey,
+    id: context.formId,
+    errorId: "".concat(context.formId, "-form-error"),
+    descriptionId: "".concat(context.formId, "-form-description"),
+    get errors() {
+      return getErrors(context.state);
+    },
+    get fieldErrors() {
+      return getFieldErrors(context.state);
+    },
+    get touched() {
+      return isTouched(context.state);
+    },
+    get valid() {
+      return typeof getErrors(context.state) === 'undefined';
+    },
+    get invalid() {
+      return !this.valid;
+    },
+    props: {
+      id: context.formId,
+      onSubmit: context.handleSubmit,
+      onInput: context.handleInput,
+      onBlur: context.handleBlur,
+      noValidate: true
+    },
+    context,
+    getField(name) {
+      return getField(context, _objectSpread2(_objectSpread2({}, options), {}, {
+        name
+      }));
+    },
+    getFieldset(name) {
+      return getFieldset(context, _objectSpread2(_objectSpread2({}, options), {}, {
+        name
+      }));
+    },
+    getFieldList(name) {
+      return getFieldList(context, _objectSpread2(_objectSpread2({}, options), {}, {
+        name
+      }));
+    }
+  };
+}
+function getField(context, options) {
+  var id = "".concat(context.formId, "-field-").concat(options.name.replace(/[^a-zA-Z0-9._-]/g, '_'));
+  var constraint = getConstraint(context, options.name);
+  var metadata = {
+    id: id,
+    descriptionId: "".concat(id, "-description"),
+    errorId: "".concat(id, "-error"),
+    formId: context.formId,
+    required: constraint === null || constraint === void 0 ? void 0 : constraint.required,
+    minLength: constraint === null || constraint === void 0 ? void 0 : constraint.minLength,
+    maxLength: constraint === null || constraint === void 0 ? void 0 : constraint.maxLength,
+    pattern: constraint === null || constraint === void 0 ? void 0 : constraint.pattern,
+    min: constraint === null || constraint === void 0 ? void 0 : constraint.min,
+    max: constraint === null || constraint === void 0 ? void 0 : constraint.max,
+    step: constraint === null || constraint === void 0 ? void 0 : constraint.step,
+    multiple: constraint === null || constraint === void 0 ? void 0 : constraint.multiple,
+    get defaultValue() {
+      return getDefaultValue(context, options.name, options.serialize);
+    },
+    get defaultOptions() {
+      return getDefaultOptions(context, options.name, options.serialize);
+    },
+    get defaultChecked() {
+      return isDefaultChecked(context, options.name, options.serialize);
+    },
+    get touched() {
+      return isTouched(context.state, options.name);
+    },
+    get valid() {
+      return typeof getErrors(context.state, options.name) === 'undefined';
+    },
+    get invalid() {
+      return !this.valid;
+    },
+    get errors() {
+      return getErrors(context.state, options.name);
+    },
+    get fieldErrors() {
+      return getFieldErrors(context.state, options.name);
+    }
+  };
+  return Object.assign(metadata, {
+    key: options.key,
+    name: options.name,
+    getFieldset() {
+      return getFieldset(context, options);
+    },
+    getFieldList() {
+      return getFieldList(context, options);
+    }
+  });
+}
+
+/**
+ * Creates a proxy that dynamically generates field objects when properties are accessed.
+ */
+function getFieldset(context, options) {
+  return new Proxy({}, {
+    get(target, name, receiver) {
+      if (typeof name === 'string') {
+        return getField(context, _objectSpread2(_objectSpread2({}, options), {}, {
+          name: appendPathSegment(options === null || options === void 0 ? void 0 : options.name, name)
+        }));
+      }
+      return Reflect.get(target, name, receiver);
+    }
+  });
+}
+
+/**
+ * Creates an array of field objects for list/array inputs
+ */
+function getFieldList(context, options) {
+  var keys = getListKey(context, options.name);
+  return keys.map((key, index) => {
+    return getField(context, _objectSpread2(_objectSpread2({}, options), {}, {
+      name: appendPathSegment(options.name, index),
+      key
+    }));
+  });
+}
+
+export { getConstraint, getDefaultListKey, getDefaultOptions, getDefaultValue, getErrors, getField, getFieldErrors, getFieldList, getFieldset, getFormMetadata, getListKey, initializeState, isDefaultChecked, isTouched, updateState };