@conform-to/react 1.17.0 → 1.18.0

package/dist/future/state.mjs

@@ -1,6 +1,6 @@
 import { objectSpread2 as _objectSpread2 } from '../_virtual/_rollupPluginBabelHelpers.mjs';
-import { getPathSegments, getRelativePath, serialize, appendPathSegment, deepEqual, getValueAtPath, formatPathSegments } from '@conform-to/dom/future';
-import { when, generateUniqueKey, merge, getArrayAtPath } from './util.mjs';
+import { parsePath, getRelativePath, serialize, appendPath, deepEqual, getPathValue, normalize, formatPath } from '@conform-to/dom/future';
+import { when, generateUniqueKey, merge, getPathArray } from './util.mjs';
 
 function initializeState(options) {
   var _options$resetKey, _options$defaultValue;
@@ -78,7 +78,7 @@ function updateState(state, action) {
 function pruneListKeys(listKeys, targetValue) {
   var result = listKeys;
   for (var [name, keys] of Object.entries(listKeys)) {
-    var list = getArrayAtPath(targetValue, name);
+    var list = getPathArray(targetValue, name);
 
     // Reset list keys only if the length has changed
     // to minimize potential UI state loss due to key changes
@@ -94,10 +94,16 @@ function pruneListKeys(listKeys, targetValue) {
   }
   return result;
 }
-function getDefaultValue(context, name) {
+function getDefaultPayload(context, name) {
   var _ref, _context$state$server;
   var serialize$1 = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : serialize;
-  var value = getValueAtPath((_ref = (_context$state$server = context.state.serverValue) !== null && _context$state$server !== void 0 ? _context$state$server : context.state.targetValue) !== null && _ref !== void 0 ? _ref : context.state.defaultValue, name);
+  var value = getPathValue((_ref = (_context$state$server = context.state.serverValue) !== null && _context$state$server !== void 0 ? _context$state$server : context.state.targetValue) !== null && _ref !== void 0 ? _ref : context.state.defaultValue, name);
+  return normalize(value, serialize$1);
+}
+function getDefaultValue(context, name) {
+  var _ref2, _context$state$server2;
+  var serialize$1 = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : serialize;
+  var value = getPathValue((_ref2 = (_context$state$server2 = context.state.serverValue) !== null && _context$state$server2 !== void 0 ? _context$state$server2 : context.state.targetValue) !== null && _ref2 !== void 0 ? _ref2 : context.state.defaultValue, name);
   var serializedValue = serialize$1(value);
   if (typeof serializedValue === 'string') {
     return serializedValue;
@@ -105,9 +111,9 @@ function getDefaultValue(context, name) {
   return '';
 }
 function getDefaultOptions(context, name) {
-  var _ref2, _context$state$server2;
+  var _ref3, _context$state$server3;
   var serialize$1 = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : serialize;
-  var value = getValueAtPath((_ref2 = (_context$state$server2 = context.state.serverValue) !== null && _context$state$server2 !== void 0 ? _context$state$server2 : context.state.targetValue) !== null && _ref2 !== void 0 ? _ref2 : context.state.defaultValue, name);
+  var value = getPathValue((_ref3 = (_context$state$server3 = context.state.serverValue) !== null && _context$state$server3 !== void 0 ? _context$state$server3 : context.state.targetValue) !== null && _ref3 !== void 0 ? _ref3 : context.state.defaultValue, name);
   var serializedValue = serialize$1(value);
   if (Array.isArray(serializedValue) && serializedValue.every(item => typeof item === 'string')) {
     return serializedValue;
@@ -118,12 +124,12 @@ function getDefaultOptions(context, name) {
   return [];
 }
 function isDefaultChecked(context, name) {
-  var _ref3, _context$state$server3;
+  var _ref4, _context$state$server4;
   var serialize$1 = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : serialize;
-  var value = getValueAtPath((_ref3 = (_context$state$server3 = context.state.serverValue) !== null && _context$state$server3 !== void 0 ? _context$state$server3 : context.state.targetValue) !== null && _ref3 !== void 0 ? _ref3 : context.state.defaultValue, name);
+  var value = getPathValue((_ref4 = (_context$state$server4 = context.state.serverValue) !== null && _context$state$server4 !== void 0 ? _context$state$server4 : context.state.targetValue) !== null && _ref4 !== void 0 ? _ref4 : context.state.defaultValue, name);
   var serializedValue = serialize$1(value);
   if (typeof serializedValue === 'string') {
-    return serializedValue === 'on';
+    return serializedValue === serialize$1(true);
   }
   return false;
 }
@@ -139,15 +145,15 @@ function isTouched(state) {
   if (state.touchedFields.includes(name)) {
     return true;
   }
-  var paths = getPathSegments(name);
+  var paths = parsePath(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)));
+  return getPathArray(initialValue, name).map((_, index) => "".concat(prefix, "-").concat(appendPath(name, index)));
 }
 function getListKey(context, name) {
-  var _context$state$listKe, _context$state$listKe2, _ref4, _context$state$server4;
-  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, (_ref4 = (_context$state$server4 = context.state.serverValue) !== null && _context$state$server4 !== void 0 ? _context$state$server4 : context.state.targetValue) !== null && _ref4 !== void 0 ? _ref4 : context.state.defaultValue, name);
+  var _context$state$listKe, _context$state$listKe2, _ref5, _context$state$server5;
+  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, (_ref5 = (_context$state$server5 = context.state.serverValue) !== null && _context$state$server5 !== void 0 ? _context$state$server5 : context.state.targetValue) !== null && _ref5 !== void 0 ? _ref5 : context.state.defaultValue, name);
 }
 function getErrors(state, name) {
   var _state$serverError;
@@ -165,7 +171,7 @@ function getFieldErrors(state, name) {
   var result = {};
   var error = (_state$serverError2 = state.serverError) !== null && _state$serverError2 !== void 0 ? _state$serverError2 : state.clientError;
   if (error) {
-    var basePath = getPathSegments(name);
+    var basePath = parsePath(name);
     for (var field of Object.keys(error.fieldErrors)) {
       var relativePath = getRelativePath(field, basePath);
 
@@ -175,12 +181,23 @@ function getFieldErrors(state, name) {
       }
       var _error = getErrors(state, field);
       if (typeof _error !== 'undefined') {
-        result[formatPathSegments(relativePath)] = _error;
+        result[formatPath(relativePath)] = _error;
       }
     }
   }
   return result;
 }
+
+/**
+ * Checks if fieldErrors contains any errors at the given name or any child path.
+ */
+function hasFieldError(error, name) {
+  var basePath = parsePath(name);
+  return Object.keys(error.fieldErrors).some(field => {
+    var _error$fieldErrors$fi;
+    return getRelativePath(field, basePath) !== null && ((_error$fieldErrors$fi = error.fieldErrors[field]) === null || _error$fieldErrors$fi === void 0 ? void 0 : _error$fieldErrors$fi.length);
+  });
+}
 function isValid(state, name) {
   var _state$serverError3;
   var error = (_state$serverError3 = state.serverError) !== null && _state$serverError3 !== void 0 ? _state$serverError3 : state.clientError;
@@ -189,7 +206,7 @@ function isValid(state, name) {
   if (!error) {
     return true;
   }
-  var basePath = getPathSegments(name);
+  var basePath = parsePath(name);
   for (var field of Object.keys(error.fieldErrors)) {
     // When checking a specific field, only check that field and its children
     if (name && !getRelativePath(field, basePath)) {
@@ -209,34 +226,6 @@ function isValid(state, name) {
   }
   return true;
 }
-
-/**
- * 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) {
   var _options$extendFormMe, _options$extendFormMe2;
   var metadata = {
@@ -297,7 +286,7 @@ function getFormMetadata(context, options) {
   return extended;
 }
 function getField(context, options) {
-  var _extendFieldMetadata;
+  var _context$constraint, _extendFieldMetadata;
   var {
     key,
     name,
@@ -309,7 +298,7 @@ function getField(context, options) {
     })
   } = options;
   var id = "".concat(context.formId, "-field-").concat(name.replace(/[^a-zA-Z0-9._-]/g, '_'));
-  var constraint = getConstraint(context, name);
+  var constraint = (_context$constraint = context.constraint) === null || _context$constraint === void 0 ? void 0 : _context$constraint[name];
   var metadata = {
     key,
     name,
@@ -335,6 +324,9 @@ function getField(context, options) {
     get defaultChecked() {
       return isDefaultChecked(context, name, serialize$1);
     },
+    get defaultPayload() {
+      return getDefaultPayload(context, name, serialize$1);
+    },
     get touched() {
       return isTouched(context.state, name);
     },
@@ -396,7 +388,7 @@ function getFieldset(context, options) {
           extendFieldMetadata: options === null || options === void 0 ? void 0 : options.extendFieldMetadata
         });
         return getField(context, {
-          name: appendPathSegment(options === null || options === void 0 ? void 0 : options.name, name),
+          name: appendPath(options === null || options === void 0 ? void 0 : options.name, name),
           serialize: options.serialize,
           extendFieldMetadata: options.extendFieldMetadata,
           form: options.form
@@ -414,7 +406,7 @@ function getFieldList(context, options) {
   var keys = getListKey(context, options.name);
   return keys.map((key, index) => {
     return getField(context, {
-      name: appendPathSegment(options.name, index),
+      name: appendPath(options.name, index),
       serialize: options.serialize,
       extendFieldMetadata: options.extendFieldMetadata,
       key
@@ -422,4 +414,4 @@ function getFieldList(context, options) {
   });
 }
 
-export { getConstraint, getDefaultListKey, getDefaultOptions, getDefaultValue, getErrors, getField, getFieldErrors, getFieldList, getFieldset, getFormMetadata, getListKey, initializeState, isDefaultChecked, isTouched, isValid, pruneListKeys, updateState };
+export { getDefaultListKey, getDefaultOptions, getDefaultPayload, getDefaultValue, getErrors, getField, getFieldErrors, getFieldList, getFieldset, getFormMetadata, getListKey, hasFieldError, initializeState, isDefaultChecked, isTouched, isValid, pruneListKeys, updateState };

package/dist/future/types.d.ts

@@ -5,39 +5,48 @@ export type Prettify<T> = {
 } & {};
 /** Reference to a form element. Can be either a React ref object or a form ID string. */
 export type FormRef = React.RefObject<HTMLFormElement | HTMLFieldSetElement | HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement | HTMLButtonElement | null> | string;
-export type InputSnapshot = {
-    value?: string | undefined;
-    options?: string[] | undefined;
-    checked?: boolean | undefined;
-    files?: File[] | undefined;
-};
-export type Control = {
+export type DefaultControlValue = string | string[] | File | File[] | FileList;
+export type Control<Value = DefaultControlValue, DefaultValue = Value, Payload = unknown> = {
     /**
-     * Current value of the base input. Undefined if the registered input
-     * is a multi-select, file input, or checkbox group.
+     * Current string value derived from the control payload.
      */
     value: string | undefined;
     /**
-     * Selected options of the base input. Defined only when the registered input
-     * is a multi-select or checkbox group.
+     * Checked state derived from the control payload.
      */
     checked: boolean | undefined;
     /**
-     * Checked state of the base input. Defined only when the registered input
-     * is a single checkbox or radio input.
+     * Current string array derived from the control payload.
      */
     options: string[] | undefined;
     /**
-     * Selected files of the base input. Defined only when the registered input
-     * is a file input.
+     * Current file array derived from the control payload.
      */
     files: File[] | undefined;
     /**
-     * Registers the base input element(s). Accepts a single input or an array for groups.
+     * The rendered payload used as the source for base control(s).
+     *
+     * For simple native controls, this mirrors `defaultValue` / `defaultChecked`.
+     * For structural controls (i.e. `<fieldset>`), this is the latest payload
+     * snapshot that drives which hidden inputs are rendered.
+     */
+    defaultValue: DefaultValue | null | undefined;
+    /**
+     * Current payload snapshot derived from the registered base control(s).
+     *
+     * For structural controls (i.e. `<fieldset>`), this is reconstructed from
+     * descendant fields under the registered fieldset name.
      */
-    register: (element: HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement | HTMLCollectionOf<HTMLInputElement> | NodeListOf<HTMLInputElement> | null | undefined) => void;
+    payload: Payload | null | undefined;
     /**
-     * A ref object containing the form element associated with the registered input.
+     * Registers the base control element.
+     *
+     * Accepts `<input>`, `<select>`, `<textarea>`, `<fieldset>`,
+     * or a collection of checkbox / radio inputs with the same name.
+     */
+    register: (element: HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement | HTMLFieldSetElement | HTMLCollectionOf<HTMLInputElement> | NodeListOf<HTMLInputElement> | null | undefined) => void;
+    /**
+     * A ref object containing the form element associated with the registered base control.
      * Use this with hooks like useFormData() and useIntent().
      */
     formRef: React.RefObject<HTMLFormElement | null>;
@@ -46,21 +55,74 @@ export type Control = {
      * both [change](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/change_event) and
      * [input](https://developer.mozilla.org/en-US/docs/Web/API/Element/input_event) events.
      */
-    change: (value: string | string[] | boolean | File | File[] | FileList | null) => void;
-    /**
-     * Emits [blur](https://developer.mozilla.org/en-US/docs/Web/API/Element/blur_event) and
-     * [focusout](https://developer.mozilla.org/en-US/docs/Web/API/Element/focusout_event) events.
-     * Does not actually move focus.
-     */
-    focus: () => void;
+    change: (value: Value | null) => void;
     /**
      * Emits [focus](https://developer.mozilla.org/en-US/docs/Web/API/Element/focus_event) and
      * [focusin](https://developer.mozilla.org/en-US/docs/Web/API/Element/focusin_event) events.
-     * This does not move the actual keyboard focus to the input. Use `element.focus()` instead
+     *
+     * This does not move the actual keyboard focus to the input.
+     * Use [HTMLElement.focus()](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/focus)
      * if you want to move focus to the input.
      */
+    focus: () => void;
+    /**
+     * Emits [blur](https://developer.mozilla.org/en-US/docs/Web/API/Element/blur_event) and
+     * [focusout](https://developer.mozilla.org/en-US/docs/Web/API/Element/focusout_event) events.
+     *
+     * This does not move the actual keyboard focus away from the input.
+     */
     blur: () => void;
 };
+export type StandardControlOptions<Value extends DefaultControlValue = DefaultControlValue> = {
+    /**
+     * The initial value of the base control.
+     */
+    defaultValue?: Value | null | undefined;
+    /**
+     * A callback function that is triggered when the base control is focused.
+     * Use this to delegate focus to a custom input.
+     */
+    onFocus?: () => void;
+};
+export type CheckedControlOptions = {
+    /**
+     * Whether the base control should be checked by default.
+     */
+    defaultChecked?: boolean | undefined;
+    /**
+     * The value of a checkbox or radio control when checked.
+     */
+    value?: string;
+    /**
+     * A callback function that is triggered when the base control is focused.
+     * Use this to delegate focus to a custom input.
+     */
+    onFocus?: () => void;
+};
+export type CustomControlOptions<Value = unknown, DefaultValue = Value> = {
+    /**
+     * Initial value used to seed the control.
+     * For structural controls, this is the payload used to render hidden inputs.
+     */
+    defaultValue?: DefaultValue | null | undefined;
+    /**
+     * Payload parser applied to the current payload snapshot.
+     *
+     * Use this to coerce unknown DOM-derived data into a typed shape.
+     * Any thrown error is surfaced to the caller.
+     */
+    parse: (payload: unknown) => Value | null | undefined;
+    /**
+     * Optional serializer to convert the parsed payload back to a form value for populating the base control(s).
+     */
+    serialize?: (value: Value) => FormValue;
+    /**
+     * A callback function that is triggered when the base control is focused.
+     * Use this to delegate focus to a custom input.
+     */
+    onFocus?: () => void;
+};
+export type ControlOptions = StandardControlOptions | CheckedControlOptions | CustomControlOptions;
 export type Selector<FormValue, Result> = (formData: FormValue, lastResult: Result | undefined) => Result;
 export type UseFormDataOptions<Value = undefined> = {
     /**
@@ -278,7 +340,9 @@ export type GlobalFormOptions = {
 export type NonPartial<T> = {
     [K in keyof Required<T>]: T[K];
 };
-export type RequireKey<T, K extends keyof T> = Prettify<T & Pick<NonPartial<T>, K>>;
+export type RequireKey<T, K extends keyof T> = Prettify<Omit<T, K> & {
+    [P in K]-?: Exclude<T[P], undefined>;
+}>;
 export type BaseSchemaType = StandardSchemaV1<any, any>;
 /**
  * Infer schema input type.
@@ -570,6 +634,13 @@ export type FieldMetadata<FieldShape, ErrorShape extends BaseErrorShape = Defaul
      * For radio buttons, compare the field's `defaultValue` with the radio button's value attribute instead.
      */
     defaultChecked: boolean;
+    /**
+     * The normalized default payload at this field path.
+     *
+     * This is useful for non-native field shapes that need to render a set of
+     * hidden inputs before user interaction.
+     */
+    defaultPayload: unknown;
     /** Whether this field has been touched (through intent.validate() or the shouldValidate option). */
     touched: boolean;
     /** Whether this field currently has no validation errors. */
@@ -697,12 +768,12 @@ export type ValidateHandler<ErrorShape, Value, SchemaValue = undefined> = (ctx:
 ] | undefined;
 export interface FormInputEvent extends React.FormEvent<HTMLFormElement> {
     currentTarget: EventTarget & HTMLFormElement;
-    target: EventTarget & (HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement);
+    target: EventTarget & (HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement | HTMLFieldSetElement);
 }
 export interface FormFocusEvent extends React.FormEvent<HTMLFormElement> {
     currentTarget: EventTarget & HTMLFormElement;
     relatedTarget: EventTarget | null;
-    target: EventTarget & (HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement);
+    target: EventTarget & (HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement | HTMLFieldSetElement);
 }
 export type ErrorContext<ErrorShape> = {
     formElement: HTMLFormElement;
@@ -782,5 +853,47 @@ export type MakeConditional<T, ConditionalKeys extends Record<string, unknown>>
     [K in keyof ConditionalKeys]: K extends keyof T ? ConditionalFieldMetadata<T[K], ConditionalKeys[K]> : never;
 };
 export type MaybePromise<T> = T | Promise<T>;
+type BaseFieldsetProps = RequireKey<Omit<React.ComponentPropsWithoutRef<'fieldset'>, 'children' | 'defaultValue'>, 'name'> & {
+    /**
+     * Renders a hidden `<fieldset>` base control with nested hidden `<input>` elements
+     * derived from `defaultValue`.
+     */
+    type: 'fieldset';
+    /**
+     * Structured default value used to render nested hidden inputs.
+     */
+    defaultValue: unknown;
+};
+type BaseSelectProps = RequireKey<Omit<React.ComponentPropsWithoutRef<'select'>, 'children' | 'value'>, 'name' | 'defaultValue'> & {
+    /**
+     * Renders a hidden `<select>` base control.
+     */
+    type: 'select';
+};
+type BaseTextareaProps = RequireKey<Omit<React.ComponentPropsWithoutRef<'textarea'>, 'children' | 'value'>, 'name' | 'defaultValue'> & {
+    /**
+     * Renders a hidden `<textarea>` base control.
+     */
+    type: 'textarea';
+};
+type BaseCheckedInputProps = RequireKey<Omit<React.ComponentPropsWithoutRef<'input'>, 'children' | 'type' | 'checked'>, 'name' | 'defaultChecked'> & {
+    /**
+     * Renders a hidden checkbox or radio base control.
+     */
+    type: 'checkbox' | 'radio';
+};
+type BaseFileInputProps = RequireKey<Omit<React.ComponentPropsWithoutRef<'input'>, 'children' | 'type' | 'value' | 'checked'>, 'name'> & {
+    /**
+     * Renders a hidden `<input type="file">` base control.
+     */
+    type: 'file';
+};
+type BaseInputProps = RequireKey<Omit<React.ComponentPropsWithoutRef<'input'>, 'children' | 'type' | 'value' | 'checked'>, 'name' | 'defaultValue'> & {
+    /**
+     * Renders a hidden `<input type="...">` base control.
+     */
+    type?: 'color' | 'date' | 'datetime-local' | 'email' | 'hidden' | 'month' | 'number' | 'password' | 'range' | 'search' | 'tel' | 'text' | 'time' | 'url' | 'week';
+};
+export type BaseControlProps = BaseFieldsetProps | BaseSelectProps | BaseTextareaProps | BaseCheckedInputProps | BaseFileInputProps | BaseInputProps;
 export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/future/util.d.ts

@@ -6,12 +6,12 @@ export declare function isString(value: unknown): value is string;
 export declare function isNumber(value: unknown): value is number;
 export declare function isNullable<T>(value: unknown, typeGuard: (value: unknown) => value is T): value is T | null;
 export declare function isOptional<T>(value: unknown, typeGuard: (value: unknown) => value is T): value is T | undefined;
-export declare function getArrayAtPath<Type>(formValue: Record<string, Type> | null, name: string): Array<Type>;
+export declare function getPathArray<Type>(formValue: Record<string, Type> | null, name: string): Array<Type>;
 /**
  * Immutably updates a value at the specified path.
  * Empty path replaces the entire object.
  */
-export declare function updateValueAtPath<Data>(data: Record<string, Data>, name: string, value: Data | Record<string, Data>): Record<string, Data>;
+export declare function updatePathValue<Data>(data: Record<string, Data>, name: string, value: Data | Record<string, Data>): Record<string, Data>;
 /**
  * Creates a function that updates array indices in field paths.
  * Returns null to remove fields, or updated path with new index.

package/dist/future/util.js

@@ -19,9 +19,9 @@ function isNullable(value, typeGuard) {
 function isOptional(value, typeGuard) {
   return isUndefined(value) || typeGuard(value);
 }
-function getArrayAtPath(formValue, name) {
-  var _getValueAtPath;
-  var value = (_getValueAtPath = future.getValueAtPath(formValue, name)) !== null && _getValueAtPath !== void 0 ? _getValueAtPath : [];
+function getPathArray(formValue, name) {
+  var _getPathValue;
+  var value = (_getPathValue = future.getPathValue(formValue, name)) !== null && _getPathValue !== void 0 ? _getPathValue : [];
   if (!Array.isArray(value)) {
     throw new Error("The value of \"".concat(name, "\" is not an array"));
   }
@@ -32,14 +32,14 @@ function getArrayAtPath(formValue, name) {
  * Immutably updates a value at the specified path.
  * Empty path replaces the entire object.
  */
-function updateValueAtPath(data, name, value) {
+function updatePathValue(data, name, value) {
   if (name === '') {
     if (!future.isPlainObject(value)) {
       throw new Error('The value must be an object');
     }
     return value;
   }
-  return future.setValueAtPath(data, future.getPathSegments(name), value, {
+  return future.setPathValue(data, future.parsePath(name), value, {
     clone: true
   });
 }
@@ -49,9 +49,9 @@ function updateValueAtPath(data, name, value) {
  * Returns null to remove fields, or updated path with new index.
  */
 function createPathIndexUpdater(listName, update) {
-  var listPaths = future.getPathSegments(listName);
+  var listPaths = future.parsePath(listName);
   return name => {
-    var paths = future.getPathSegments(name);
+    var paths = future.parsePath(name);
     if (paths.length > listPaths.length && listPaths.every((path, index) => paths[index] === path)) {
       var currentIndex = paths[listPaths.length];
       if (typeof currentIndex === 'number') {
@@ -63,7 +63,7 @@ function createPathIndexUpdater(listName, update) {
         if (newIndex !== currentIndex) {
           // Replace the index
           paths.splice(listPaths.length, 1, newIndex);
-          return future.formatPathSegments(paths);
+          return future.formatPath(paths);
         }
       }
     }
@@ -248,7 +248,7 @@ exports.appendUniqueItem = appendUniqueItem;
 exports.compactMap = compactMap;
 exports.createPathIndexUpdater = createPathIndexUpdater;
 exports.generateUniqueKey = generateUniqueKey;
-exports.getArrayAtPath = getArrayAtPath;
+exports.getPathArray = getPathArray;
 exports.isNullable = isNullable;
 exports.isNumber = isNumber;
 exports.isOptional = isOptional;
@@ -262,6 +262,6 @@ exports.resolveStandardSchemaResult = resolveStandardSchemaResult;
 exports.resolveValidateResult = resolveValidateResult;
 exports.shape = shape;
 exports.transformKeys = transformKeys;
-exports.updateValueAtPath = updateValueAtPath;
+exports.updatePathValue = updatePathValue;
 exports.validateStandardSchemaV1 = validateStandardSchemaV1;
 exports.when = when;

package/dist/future/util.mjs

@@ -1,4 +1,4 @@
-import { formatIssues, getValueAtPath, isPlainObject, setValueAtPath, getPathSegments, formatPathSegments } from '@conform-to/dom/future';
+import { formatIssues, getPathValue, isPlainObject, setPathValue, parsePath, formatPath } from '@conform-to/dom/future';
 
 function isUndefined(value) {
   return value === undefined;
@@ -15,9 +15,9 @@ function isNullable(value, typeGuard) {
 function isOptional(value, typeGuard) {
   return isUndefined(value) || typeGuard(value);
 }
-function getArrayAtPath(formValue, name) {
-  var _getValueAtPath;
-  var value = (_getValueAtPath = getValueAtPath(formValue, name)) !== null && _getValueAtPath !== void 0 ? _getValueAtPath : [];
+function getPathArray(formValue, name) {
+  var _getPathValue;
+  var value = (_getPathValue = getPathValue(formValue, name)) !== null && _getPathValue !== void 0 ? _getPathValue : [];
   if (!Array.isArray(value)) {
     throw new Error("The value of \"".concat(name, "\" is not an array"));
   }
@@ -28,14 +28,14 @@ function getArrayAtPath(formValue, name) {
  * Immutably updates a value at the specified path.
  * Empty path replaces the entire object.
  */
-function updateValueAtPath(data, name, value) {
+function updatePathValue(data, name, value) {
   if (name === '') {
     if (!isPlainObject(value)) {
       throw new Error('The value must be an object');
     }
     return value;
   }
-  return setValueAtPath(data, getPathSegments(name), value, {
+  return setPathValue(data, parsePath(name), value, {
     clone: true
   });
 }
@@ -45,9 +45,9 @@ function updateValueAtPath(data, name, value) {
  * Returns null to remove fields, or updated path with new index.
  */
 function createPathIndexUpdater(listName, update) {
-  var listPaths = getPathSegments(listName);
+  var listPaths = parsePath(listName);
   return name => {
-    var paths = getPathSegments(name);
+    var paths = parsePath(name);
     if (paths.length > listPaths.length && listPaths.every((path, index) => paths[index] === path)) {
       var currentIndex = paths[listPaths.length];
       if (typeof currentIndex === 'number') {
@@ -59,7 +59,7 @@ function createPathIndexUpdater(listName, update) {
         if (newIndex !== currentIndex) {
           // Replace the index
           paths.splice(listPaths.length, 1, newIndex);
-          return formatPathSegments(paths);
+          return formatPath(paths);
         }
       }
     }
@@ -240,4 +240,4 @@ function validateStandardSchemaV1(schema, payload) {
   return resolveStandardSchemaResult(result);
 }
 
-export { appendUniqueItem, compactMap, createPathIndexUpdater, generateUniqueKey, getArrayAtPath, isNullable, isNumber, isOptional, isStandardSchemaV1, isString, isUndefined, merge, normalizeFormError, normalizeValidateResult, resolveStandardSchemaResult, resolveValidateResult, shape, transformKeys, updateValueAtPath, validateStandardSchemaV1, when };
+export { appendUniqueItem, compactMap, createPathIndexUpdater, generateUniqueKey, getPathArray, isNullable, isNumber, isOptional, isStandardSchemaV1, isString, isUndefined, merge, normalizeFormError, normalizeValidateResult, resolveStandardSchemaResult, resolveValidateResult, shape, transformKeys, updatePathValue, validateStandardSchemaV1, when };

package/package.json

@@ -3,7 +3,7 @@
   "description": "Conform view adapter for react",
   "homepage": "https://conform.guide",
   "license": "MIT",
-  "version": "1.17.0",
+  "version": "1.18.0",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
@@ -41,7 +41,7 @@
     "url": "https://github.com/edmundhung/conform/issues"
   },
   "dependencies": {
-    "@conform-to/dom": "1.17.0"
+    "@conform-to/dom": "1.18.0"
   },
   "devDependencies": {
     "@babel/core": "^7.17.8",
@@ -60,7 +60,8 @@
     "vitest-browser-react": "^1.0.1"
   },
   "peerDependencies": {
-    "react": ">=18"
+    "react": ">=18",
+    "react-dom": ">=18"
   },
   "keywords": [
     "constraint-validation",