@rjsf/utils 5.21.1 → 5.22.0

package/dist/utils.umd.js

@@ -1,8 +1,8 @@
 (function (global, factory) {
-  typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('lodash/isPlainObject'), require('lodash/isEqualWith'), require('lodash/get'), require('lodash/isEmpty'), require('jsonpointer'), require('lodash/omit'), require('lodash/has'), require('lodash/isNumber'), require('lodash/isObject'), require('lodash/isString'), require('lodash/reduce'), require('lodash/times'), require('lodash/isEqual'), require('lodash/set'), require('lodash/transform'), require('lodash/merge'), require('lodash/flattenDeep'), require('lodash/uniq'), require('json-schema-merge-allof'), require('lodash/union'), require('lodash/isNil'), require('lodash/cloneDeep'), require('react'), require('react-is'), require('react/jsx-runtime'), require('lodash/toPath'), require('lodash/forEach')) :
-  typeof define === 'function' && define.amd ? define(['exports', 'lodash/isPlainObject', 'lodash/isEqualWith', 'lodash/get', 'lodash/isEmpty', 'jsonpointer', 'lodash/omit', 'lodash/has', 'lodash/isNumber', 'lodash/isObject', 'lodash/isString', 'lodash/reduce', 'lodash/times', 'lodash/isEqual', 'lodash/set', 'lodash/transform', 'lodash/merge', 'lodash/flattenDeep', 'lodash/uniq', 'json-schema-merge-allof', 'lodash/union', 'lodash/isNil', 'lodash/cloneDeep', 'react', 'react-is', 'react/jsx-runtime', 'lodash/toPath', 'lodash/forEach'], factory) :
-  (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["@rjsf/utils"] = {}, global.isPlainObject, global.isEqualWith, global.get8, global.isEmpty, global.jsonpointer, global.omit, global.has3, global.isNumber, global.isObject2, global.isString, global.reduce, global.times, global.isEqual4, global.set3, global.transform, global.merge, global.flattenDeep, global.uniq, global.mergeAllOf, global.union, global.isNil, global.cloneDeep, global.react, global.ReactIs, global.jsxRuntime, global.toPath, global.forEach));
-})(this, (function (exports, isPlainObject, isEqualWith, get8, isEmpty, jsonpointer, omit, has3, isNumber, isObject2, isString, reduce, times, isEqual4, set3, transform, merge, flattenDeep, uniq, mergeAllOf, union, isNil, cloneDeep, react, ReactIs, jsxRuntime, toPath, forEach) { 'use strict';
+  typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('lodash/isPlainObject'), require('lodash/isEqualWith'), require('lodash/get'), require('lodash/isEmpty'), require('jsonpointer'), require('lodash/omit'), require('lodash/has'), require('lodash/isNumber'), require('lodash/isObject'), require('lodash/isString'), require('lodash/reduce'), require('lodash/times'), require('lodash/isEqual'), require('lodash/set'), require('lodash/transform'), require('lodash/merge'), require('lodash/flattenDeep'), require('lodash/uniq'), require('json-schema-merge-allof'), require('lodash/union'), require('lodash/isNil'), require('lodash/cloneDeep'), require('lodash/setWith'), require('react'), require('react-is'), require('react/jsx-runtime'), require('lodash/toPath'), require('lodash/forEach')) :
+  typeof define === 'function' && define.amd ? define(['exports', 'lodash/isPlainObject', 'lodash/isEqualWith', 'lodash/get', 'lodash/isEmpty', 'jsonpointer', 'lodash/omit', 'lodash/has', 'lodash/isNumber', 'lodash/isObject', 'lodash/isString', 'lodash/reduce', 'lodash/times', 'lodash/isEqual', 'lodash/set', 'lodash/transform', 'lodash/merge', 'lodash/flattenDeep', 'lodash/uniq', 'json-schema-merge-allof', 'lodash/union', 'lodash/isNil', 'lodash/cloneDeep', 'lodash/setWith', 'react', 'react-is', 'react/jsx-runtime', 'lodash/toPath', 'lodash/forEach'], factory) :
+  (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["@rjsf/utils"] = {}, global.isPlainObject, global.isEqualWith, global.get8, global.isEmpty, global.jsonpointer, global.omit, global.has3, global.isNumber, global.isObject2, global.isString, global.reduce, global.times, global.isEqual4, global.set3, global.transform, global.merge, global.flattenDeep, global.uniq, global.mergeAllOf, global.union, global.isNil, global.cloneDeep, global.setWith, global.react, global.ReactIs, global.jsxRuntime, global.toPath, global.forEach));
+})(this, (function (exports, isPlainObject, isEqualWith, get8, isEmpty, jsonpointer, omit, has3, isNumber, isObject2, isString, reduce, times, isEqual4, set3, transform, merge, flattenDeep, uniq, mergeAllOf, union, isNil, cloneDeep, setWith, react, ReactIs, jsxRuntime, toPath, forEach) { 'use strict';
 
   // src/isObject.ts
   function isObject(thing) {
@@ -324,10 +324,18 @@
   }
 
   // src/schema/retrieveSchema.ts
-  function retrieveSchema(validator, schema, rootSchema = {}, rawFormData) {
-    return retrieveSchemaInternal(validator, schema, rootSchema, rawFormData)[0];
+  function retrieveSchema(validator, schema, rootSchema = {}, rawFormData, experimental_customMergeAllOf) {
+    return retrieveSchemaInternal(
+      validator,
+      schema,
+      rootSchema,
+      rawFormData,
+      void 0,
+      void 0,
+      experimental_customMergeAllOf
+    )[0];
   }
-  function resolveCondition(validator, schema, rootSchema, expandAllBranches, recurseList, formData) {
+  function resolveCondition(validator, schema, rootSchema, expandAllBranches, recurseList, formData, experimental_customMergeAllOf) {
     const { if: expression, then, else: otherwise, ...resolvedSchemaLessConditional } = schema;
     const conditionValue = validator.isValid(expression, formData || {}, rootSchema);
     let resolvedSchemas = [resolvedSchemaLessConditional];
@@ -335,12 +343,28 @@
     if (expandAllBranches) {
       if (then && typeof then !== "boolean") {
         schemas = schemas.concat(
-          retrieveSchemaInternal(validator, then, rootSchema, formData, expandAllBranches, recurseList)
+          retrieveSchemaInternal(
+            validator,
+            then,
+            rootSchema,
+            formData,
+            expandAllBranches,
+            recurseList,
+            experimental_customMergeAllOf
+          )
         );
       }
       if (otherwise && typeof otherwise !== "boolean") {
         schemas = schemas.concat(
-          retrieveSchemaInternal(validator, otherwise, rootSchema, formData, expandAllBranches, recurseList)
+          retrieveSchemaInternal(
+            validator,
+            otherwise,
+            rootSchema,
+            formData,
+            expandAllBranches,
+            recurseList,
+            experimental_customMergeAllOf
+          )
         );
       }
     } else {
@@ -353,7 +377,8 @@
             rootSchema,
             formData,
             expandAllBranches,
-            recurseList
+            recurseList,
+            experimental_customMergeAllOf
           )
         );
       }
@@ -362,7 +387,15 @@
       resolvedSchemas = schemas.map((s) => mergeSchemas(resolvedSchemaLessConditional, s));
     }
     return resolvedSchemas.flatMap(
-      (s) => retrieveSchemaInternal(validator, s, rootSchema, formData, expandAllBranches, recurseList)
+      (s) => retrieveSchemaInternal(
+        validator,
+        s,
+        rootSchema,
+        formData,
+        expandAllBranches,
+        recurseList,
+        experimental_customMergeAllOf
+      )
     );
   }
   function getAllPermutationsOfXxxOf(listOfLists) {
@@ -379,7 +412,7 @@
     );
     return allPermutations;
   }
-  function resolveSchema(validator, schema, rootSchema, expandAllBranches, recurseList, formData) {
+  function resolveSchema(validator, schema, rootSchema, expandAllBranches, recurseList, formData, experimental_customMergeAllOf) {
     const updatedSchemas = resolveReference(
       validator,
       schema,
@@ -401,7 +434,15 @@
         formData
       );
       return resolvedSchemas.flatMap((s) => {
-        return retrieveSchemaInternal(validator, s, rootSchema, formData, expandAllBranches, recurseList);
+        return retrieveSchemaInternal(
+          validator,
+          s,
+          rootSchema,
+          formData,
+          expandAllBranches,
+          recurseList,
+          experimental_customMergeAllOf
+        );
       });
     }
     if (ALL_OF_KEY in schema && Array.isArray(schema.allOf)) {
@@ -412,7 +453,8 @@
           rootSchema,
           formData,
           expandAllBranches,
-          recurseList
+          recurseList,
+          experimental_customMergeAllOf
         )
       );
       const allPermutations = getAllPermutationsOfXxxOf(allOfSchemaElements);
@@ -420,7 +462,7 @@
     }
     return [schema];
   }
-  function resolveReference(validator, schema, rootSchema, expandAllBranches, recurseList, formData) {
+  function resolveReference(validator, schema, rootSchema, expandAllBranches, recurseList, formData, experimental_customMergeAllOf) {
     const updatedSchema = resolveAllReferences(schema, rootSchema, recurseList);
     if (updatedSchema !== schema) {
       return retrieveSchemaInternal(
@@ -429,7 +471,8 @@
         rootSchema,
         formData,
         expandAllBranches,
-        recurseList
+        recurseList,
+        experimental_customMergeAllOf
       );
     }
     return [schema];
@@ -507,7 +550,7 @@
     });
     return schema;
   }
-  function retrieveSchemaInternal(validator, schema, rootSchema, rawFormData, expandAllBranches = false, recurseList = []) {
+  function retrieveSchemaInternal(validator, schema, rootSchema, rawFormData, expandAllBranches = false, recurseList = [], experimental_customMergeAllOf) {
     if (!isObject(schema)) {
       return [{}];
     }
@@ -528,7 +571,8 @@
           rootSchema,
           expandAllBranches,
           recurseList,
-          rawFormData
+          rawFormData,
+          experimental_customMergeAllOf
         );
       }
       if (ALL_OF_KEY in resolvedSchema) {
@@ -537,9 +581,24 @@
           return [...allOf, restOfSchema];
         }
         try {
-          resolvedSchema = mergeAllOf(resolvedSchema, {
+          const withContainsSchemas = [];
+          const withoutContainsSchemas = [];
+          resolvedSchema.allOf?.forEach((s2) => {
+            if (typeof s2 === "object" && s2.contains) {
+              withContainsSchemas.push(s2);
+            } else {
+              withoutContainsSchemas.push(s2);
+            }
+          });
+          if (withContainsSchemas.length) {
+            resolvedSchema = { ...resolvedSchema, allOf: withoutContainsSchemas };
+          }
+          resolvedSchema = experimental_customMergeAllOf ? experimental_customMergeAllOf(resolvedSchema) : mergeAllOf(resolvedSchema, {
             deep: false
           });
+          if (withContainsSchemas.length) {
+            resolvedSchema.allOf = withContainsSchemas;
+          }
         } catch (e) {
           console.warn("could not merge subschemas in allOf:\n", e);
           const { allOf, ...resolvedSchemaWithoutAllOf } = resolvedSchema;
@@ -575,7 +634,7 @@
     }
     return [schema];
   }
-  function resolveDependencies(validator, schema, rootSchema, expandAllBranches, recurseList, formData) {
+  function resolveDependencies(validator, schema, rootSchema, expandAllBranches, recurseList, formData, experimental_customMergeAllOf) {
     const { dependencies, ...remainingSchema } = schema;
     const resolvedSchemas = resolveAnyOrOneOfSchemas(
       validator,
@@ -592,11 +651,12 @@
         rootSchema,
         expandAllBranches,
         recurseList,
-        formData
+        formData,
+        experimental_customMergeAllOf
       )
     );
   }
-  function processDependencies(validator, dependencies, resolvedSchema, rootSchema, expandAllBranches, recurseList, formData) {
+  function processDependencies(validator, dependencies, resolvedSchema, rootSchema, expandAllBranches, recurseList, formData, experimental_customMergeAllOf) {
     let schemas = [resolvedSchema];
     for (const dependencyKey in dependencies) {
       if (!expandAllBranches && get8(formData, [dependencyKey]) === void 0) {
@@ -620,7 +680,8 @@
           dependencyValue,
           expandAllBranches,
           recurseList,
-          formData
+          formData,
+          experimental_customMergeAllOf
         );
       }
       return schemas.flatMap(
@@ -631,7 +692,8 @@
           rootSchema,
           expandAllBranches,
           recurseList,
-          formData
+          formData,
+          experimental_customMergeAllOf
         )
       );
     }
@@ -644,14 +706,15 @@
     const required = Array.isArray(schema.required) ? Array.from(/* @__PURE__ */ new Set([...schema.required, ...additionallyRequired])) : additionallyRequired;
     return { ...schema, required };
   }
-  function withDependentSchema(validator, schema, rootSchema, dependencyKey, dependencyValue, expandAllBranches, recurseList, formData) {
+  function withDependentSchema(validator, schema, rootSchema, dependencyKey, dependencyValue, expandAllBranches, recurseList, formData, experimental_customMergeAllOf) {
     const dependentSchemas = retrieveSchemaInternal(
       validator,
       dependencyValue,
       rootSchema,
       formData,
       expandAllBranches,
-      recurseList
+      recurseList,
+      experimental_customMergeAllOf
     );
     return dependentSchemas.flatMap((dependent) => {
       const { oneOf, ...dependentSchema } = dependent;
@@ -675,12 +738,13 @@
           resolvedOneOf,
           expandAllBranches,
           recurseList,
-          formData
+          formData,
+          experimental_customMergeAllOf
         )
       );
     });
   }
-  function withExactlyOneSubschema(validator, schema, rootSchema, dependencyKey, oneOf, expandAllBranches, recurseList, formData) {
+  function withExactlyOneSubschema(validator, schema, rootSchema, dependencyKey, oneOf, expandAllBranches, recurseList, formData, experimental_customMergeAllOf) {
     const validSubschemas = oneOf.filter((subschema) => {
       if (typeof subschema === "boolean" || !subschema || !subschema.properties) {
         return false;
@@ -711,7 +775,8 @@
         rootSchema,
         formData,
         expandAllBranches,
-        recurseList
+        recurseList,
+        experimental_customMergeAllOf
       );
       return schemas.map((s2) => mergeSchemas(schema, s2));
     });
@@ -727,7 +792,7 @@
       }
     }
   };
-  function calculateIndexScore(validator, rootSchema, schema, formData = {}) {
+  function calculateIndexScore(validator, rootSchema, schema, formData) {
     let totalScore = 0;
     if (schema) {
       if (isObject2(schema.properties)) {
@@ -755,7 +820,10 @@
               );
             }
             if (value.type === "object") {
-              return score + calculateIndexScore(validator, rootSchema, value, formValue || {});
+              if (isObject2(formValue)) {
+                score += 1;
+              }
+              return score + calculateIndexScore(validator, rootSchema, value, formValue);
             }
             if (value.type === guessType(formValue)) {
               let newScore = score + 1;
@@ -822,12 +890,17 @@
   function isFixedItems(schema) {
     return Array.isArray(schema.items) && schema.items.length > 0 && schema.items.every((item) => isObject(item));
   }
-  function mergeDefaultsWithFormData(defaults, formData, mergeExtraArrayDefaults = false) {
+  function mergeDefaultsWithFormData(defaults, formData, mergeExtraArrayDefaults = false, defaultSupercedesUndefined = false) {
     if (Array.isArray(formData)) {
       const defaultsArray = Array.isArray(defaults) ? defaults : [];
       const mapped = formData.map((value, idx) => {
         if (defaultsArray[idx]) {
-          return mergeDefaultsWithFormData(defaultsArray[idx], value, mergeExtraArrayDefaults);
+          return mergeDefaultsWithFormData(
+            defaultsArray[idx],
+            value,
+            mergeExtraArrayDefaults,
+            defaultSupercedesUndefined
+          );
         }
         return value;
       });
@@ -842,11 +915,15 @@
         acc2[key] = mergeDefaultsWithFormData(
           defaults ? get8(defaults, key) : {},
           get8(formData, key),
-          mergeExtraArrayDefaults
+          mergeExtraArrayDefaults,
+          defaultSupercedesUndefined
         );
         return acc2;
       }, acc);
     }
+    if (defaultSupercedesUndefined && formData === void 0) {
+      return defaults;
+    }
     return formData;
   }
 
@@ -917,9 +994,9 @@
     }
     return {};
   }
-  function maybeAddDefaultToObject(obj, key, computedDefault, includeUndefinedValues, isParentRequired, requiredFields = [], experimental_defaultFormStateBehavior = {}) {
+  function maybeAddDefaultToObject(obj, key, computedDefault, includeUndefinedValues, isParentRequired, requiredFields = [], experimental_defaultFormStateBehavior = {}, isConst = false) {
     const { emptyObjectFields = "populateAllDefaults" } = experimental_defaultFormStateBehavior;
-    if (includeUndefinedValues) {
+    if (includeUndefinedValues || isConst) {
       obj[key] = computedDefault;
     } else if (emptyObjectFields !== "skipDefaults") {
       if (isObject(computedDefault)) {
@@ -949,6 +1026,7 @@
       includeUndefinedValues = false,
       _recurseList = [],
       experimental_defaultFormStateBehavior = void 0,
+      experimental_customMergeAllOf = void 0,
       required
     } = computeDefaultsProps;
     const formData = isObject(rawFormData) ? rawFormData : {};
@@ -956,7 +1034,9 @@
     let defaults = parentDefaults;
     let schemaToCompute = null;
     let updatedRecurseList = _recurseList;
-    if (isObject(defaults) && isObject(schema.default)) {
+    if (isConstant(schema)) {
+      defaults = schema.const;
+    } else if (isObject(defaults) && isObject(schema.default)) {
       defaults = mergeObjects(defaults, schema.default);
     } else if (DEFAULT_KEY in schema) {
       defaults = schema.default;
@@ -971,7 +1051,15 @@
         ...formData,
         ...getDefaultBasedOnSchemaType(validator, schema, computeDefaultsProps, defaults)
       };
-      const resolvedSchema = resolveDependencies(validator, schema, rootSchema, false, [], defaultFormData);
+      const resolvedSchema = resolveDependencies(
+        validator,
+        schema,
+        rootSchema,
+        false,
+        [],
+        defaultFormData,
+        experimental_customMergeAllOf
+      );
       schemaToCompute = resolvedSchema[0];
     } else if (isFixedItems(schema)) {
       defaults = schema.items.map(
@@ -1039,18 +1127,24 @@
     includeUndefinedValues = false,
     _recurseList = [],
     experimental_defaultFormStateBehavior = void 0,
+    experimental_customMergeAllOf = void 0,
     required
   } = {}, defaults) {
     {
       const formData = isObject(rawFormData) ? rawFormData : {};
       const schema = rawSchema;
-      const retrievedSchema = experimental_defaultFormStateBehavior?.allOf === "populateDefaults" && ALL_OF_KEY in schema ? retrieveSchema(validator, schema, rootSchema, formData) : schema;
+      const retrievedSchema = experimental_defaultFormStateBehavior?.allOf === "populateDefaults" && ALL_OF_KEY in schema ? retrieveSchema(validator, schema, rootSchema, formData, experimental_customMergeAllOf) : schema;
+      const parentConst = retrievedSchema[CONST_KEY];
       const objectDefaults = Object.keys(retrievedSchema.properties || {}).reduce(
         (acc, key) => {
-          const computedDefault = computeDefaults(validator, get8(retrievedSchema, [PROPERTIES_KEY, key]), {
+          const propertySchema = get8(retrievedSchema, [PROPERTIES_KEY, key]);
+          const hasParentConst = isObject(parentConst) && parentConst[key] !== void 0;
+          const hasConst = isObject(propertySchema) && CONST_KEY in propertySchema || hasParentConst;
+          const computedDefault = computeDefaults(validator, propertySchema, {
             rootSchema,
             _recurseList,
             experimental_defaultFormStateBehavior,
+            experimental_customMergeAllOf,
             includeUndefinedValues: includeUndefinedValues === true,
             parentDefaults: get8(defaults, [key]),
             rawFormData: get8(formData, [key]),
@@ -1063,7 +1157,8 @@
             includeUndefinedValues,
             required,
             retrievedSchema.required,
-            experimental_defaultFormStateBehavior
+            experimental_defaultFormStateBehavior,
+            hasConst
           );
           return acc;
         },
@@ -1145,11 +1240,14 @@
         });
       }
     }
-    if (neverPopulate) {
-      return defaults ?? emptyDefault;
-    }
-    if (ignoreMinItemsFlagSet && !required) {
-      return defaults ? defaults : void 0;
+    const hasConst = isObject(schema) && CONST_KEY in schema;
+    if (hasConst === false) {
+      if (neverPopulate) {
+        return defaults ?? emptyDefault;
+      }
+      if (ignoreMinItemsFlagSet && !required) {
+        return defaults ? defaults : void 0;
+      }
     }
     const defaultsLength = Array.isArray(defaults) ? defaults.length : 0;
     if (!schema.minItems || isMultiSelect(validator, schema, rootSchema) || computeSkipPopulate(validator, schema, rootSchema) || schema.minItems <= defaultsLength) {
@@ -1179,26 +1277,29 @@
       }
     }
   }
-  function getDefaultFormState(validator, theSchema, formData, rootSchema, includeUndefinedValues = false, experimental_defaultFormStateBehavior) {
+  function getDefaultFormState(validator, theSchema, formData, rootSchema, includeUndefinedValues = false, experimental_defaultFormStateBehavior, experimental_customMergeAllOf) {
     if (!isObject(theSchema)) {
       throw new Error("Invalid schema: " + theSchema);
     }
-    const schema = retrieveSchema(validator, theSchema, rootSchema, formData);
+    const schema = retrieveSchema(validator, theSchema, rootSchema, formData, experimental_customMergeAllOf);
     const defaults = computeDefaults(validator, schema, {
       rootSchema,
       includeUndefinedValues,
       experimental_defaultFormStateBehavior,
+      experimental_customMergeAllOf,
       rawFormData: formData
     });
     if (formData === void 0 || formData === null || typeof formData === "number" && isNaN(formData)) {
       return defaults;
     }
-    const { mergeExtraDefaults } = experimental_defaultFormStateBehavior?.arrayMinItems || {};
+    const { mergeDefaultsIntoFormData, arrayMinItems = {} } = experimental_defaultFormStateBehavior || {};
+    const { mergeExtraDefaults } = arrayMinItems;
+    const defaultSupercedesUndefined = mergeDefaultsIntoFormData === "useDefaultIfFormDataUndefined";
     if (isObject(formData)) {
-      return mergeDefaultsWithFormData(defaults, formData, mergeExtraDefaults);
+      return mergeDefaultsWithFormData(defaults, formData, mergeExtraDefaults, defaultSupercedesUndefined);
     }
     if (Array.isArray(formData)) {
-      return mergeDefaultsWithFormData(defaults, formData, mergeExtraDefaults);
+      return mergeDefaultsWithFormData(defaults, formData, mergeExtraDefaults, defaultSupercedesUndefined);
     }
     return formData;
   }
@@ -1360,7 +1461,7 @@
     }
     return newFormData;
   }
-  function toIdSchemaInternal(validator, schema, idPrefix, idSeparator, id, rootSchema, formData, _recurseList = []) {
+  function toIdSchemaInternal(validator, schema, idPrefix, idSeparator, id, rootSchema, formData, _recurseList = [], experimental_customMergeAllOf) {
     if (REF_KEY in schema || DEPENDENCIES_KEY in schema || ALL_OF_KEY in schema) {
       const _schema = retrieveSchema(validator, schema, rootSchema, formData);
       const sameSchemaIndex = _recurseList.findIndex((item) => isEqual4(item, _schema));
@@ -1373,8 +1474,7 @@
           id,
           rootSchema,
           formData,
-          _recurseList.concat(_schema)
-        );
+          _recurseList.concat(_schema));
       }
     }
     if (ITEMS_KEY in schema && !get8(schema, [ITEMS_KEY, REF_KEY])) {
@@ -1386,8 +1486,7 @@
         id,
         rootSchema,
         formData,
-        _recurseList
-      );
+        _recurseList);
     }
     const $id = id || idPrefix;
     const idSchema = { $id };
@@ -1405,14 +1504,21 @@
           // It's possible that formData is not an object -- this can happen if an
           // array item has just been added, but not populated with data yet
           get8(formData, [name]),
-          _recurseList
-        );
+          _recurseList);
       }
     }
     return idSchema;
   }
-  function toIdSchema(validator, schema, id, rootSchema, formData, idPrefix = "root", idSeparator = "_") {
-    return toIdSchemaInternal(validator, schema, idPrefix, idSeparator, id, rootSchema, formData);
+  function toIdSchema(validator, schema, id, rootSchema, formData, idPrefix = "root", idSeparator = "_", experimental_customMergeAllOf) {
+    return toIdSchemaInternal(
+      validator,
+      schema,
+      idPrefix,
+      idSeparator,
+      id,
+      rootSchema,
+      formData,
+      void 0);
   }
   function toPathSchemaInternal(validator, schema, name, rootSchema, formData, _recurseList = []) {
     if (REF_KEY in schema || DEPENDENCIES_KEY in schema || ALL_OF_KEY in schema) {
@@ -1511,11 +1617,13 @@
      * @param validator - An implementation of the `ValidatorType` interface that will be forwarded to all the APIs
      * @param rootSchema - The root schema that will be forwarded to all the APIs
      * @param experimental_defaultFormStateBehavior - Configuration flags to allow users to override default form state behavior
+     * @param [experimental_customMergeAllOf] - Optional function that allows for custom merging of `allOf` schemas
      */
-    constructor(validator, rootSchema, experimental_defaultFormStateBehavior) {
+    constructor(validator, rootSchema, experimental_defaultFormStateBehavior, experimental_customMergeAllOf) {
       this.rootSchema = rootSchema;
       this.validator = validator;
       this.experimental_defaultFormStateBehavior = experimental_defaultFormStateBehavior;
+      this.experimental_customMergeAllOf = experimental_customMergeAllOf;
     }
     /** Returns the `ValidatorType` in the `SchemaUtilsType`
      *
@@ -1531,13 +1639,14 @@
      * @param validator - An implementation of the `ValidatorType` interface that will be compared against the current one
      * @param rootSchema - The root schema that will be compared against the current one
      * @param [experimental_defaultFormStateBehavior] Optional configuration object, if provided, allows users to override default form state behavior
+     * @param [experimental_customMergeAllOf] - Optional function that allows for custom merging of `allOf` schemas
      * @returns - True if the `SchemaUtilsType` differs from the given `validator` or `rootSchema`
      */
-    doesSchemaUtilsDiffer(validator, rootSchema, experimental_defaultFormStateBehavior = {}) {
+    doesSchemaUtilsDiffer(validator, rootSchema, experimental_defaultFormStateBehavior = {}, experimental_customMergeAllOf) {
       if (!validator || !rootSchema) {
         return false;
       }
-      return this.validator !== validator || !deepEquals(this.rootSchema, rootSchema) || !deepEquals(this.experimental_defaultFormStateBehavior, experimental_defaultFormStateBehavior);
+      return this.validator !== validator || !deepEquals(this.rootSchema, rootSchema) || !deepEquals(this.experimental_defaultFormStateBehavior, experimental_defaultFormStateBehavior) || this.experimental_customMergeAllOf !== experimental_customMergeAllOf;
     }
     /** Returns the superset of `formData` that includes the given set updated to include any missing fields that have
      * computed to have defaults provided in the `schema`.
@@ -1556,7 +1665,8 @@
         formData,
         this.rootSchema,
         includeUndefinedValues,
-        this.experimental_defaultFormStateBehavior
+        this.experimental_defaultFormStateBehavior,
+        this.experimental_customMergeAllOf
       );
     }
     /** Determines whether the combination of `schema` and `uiSchema` properties indicates that the label for the `schema`
@@ -1666,7 +1776,13 @@
      * @returns - The schema having its conditions, additional properties, references and dependencies resolved
      */
     retrieveSchema(schema, rawFormData) {
-      return retrieveSchema(this.validator, schema, this.rootSchema, rawFormData);
+      return retrieveSchema(
+        this.validator,
+        schema,
+        this.rootSchema,
+        rawFormData,
+        this.experimental_customMergeAllOf
+      );
     }
     /** Sanitize the `data` associated with the `oldSchema` so it is considered appropriate for the `newSchema`. If the
      * new schema does not contain any properties, then `undefined` is returned to clear all the form data. Due to the
@@ -1692,7 +1808,16 @@
      * @returns - The `IdSchema` object for the `schema`
      */
     toIdSchema(schema, id, formData, idPrefix = "root", idSeparator = "_") {
-      return toIdSchema(this.validator, schema, id, this.rootSchema, formData, idPrefix, idSeparator);
+      return toIdSchema(
+        this.validator,
+        schema,
+        id,
+        this.rootSchema,
+        formData,
+        idPrefix,
+        idSeparator,
+        this.experimental_customMergeAllOf
+      );
     }
     /** Generates an `PathSchema` object for the `schema`, recursively
      *
@@ -1705,8 +1830,13 @@
       return toPathSchema(this.validator, schema, name, this.rootSchema, formData);
     }
   };
-  function createSchemaUtils(validator, rootSchema, experimental_defaultFormStateBehavior = {}) {
-    return new SchemaUtils(validator, rootSchema, experimental_defaultFormStateBehavior);
+  function createSchemaUtils(validator, rootSchema, experimental_defaultFormStateBehavior = {}, experimental_customMergeAllOf) {
+    return new SchemaUtils(
+      validator,
+      rootSchema,
+      experimental_defaultFormStateBehavior,
+      experimental_customMergeAllOf
+    );
   }
 
   // src/dataURItoBlob.ts
@@ -1860,7 +1990,7 @@
       let errorBlock = hasPath ? get8(this.errorSchema, pathOfError) : this.errorSchema;
       if (!errorBlock && pathOfError) {
         errorBlock = {};
-        set3(this.errorSchema, pathOfError, errorBlock);
+        setWith(this.errorSchema, pathOfError, errorBlock, Object);
       }
       return errorBlock;
     }

package/lib/ErrorSchemaBuilder.d.ts

@@ -39,7 +39,7 @@ export default class ErrorSchemaBuilder<T = any> {
      * @param [pathOfError] - The optional path into the `ErrorSchema` at which to add the error(s)
      * @returns - The `ErrorSchemaBuilder` object for chaining purposes
      */
-    addErrors(errorOrList: string | string[], pathOfError?: string | string[]): this;
+    addErrors(errorOrList: string | string[], pathOfError?: string | (string | number)[]): this;
     /** Sets/replaces the `errorOrList` as the error(s) in the `ErrorSchema` at either the root level or the location
      * within the schema described by the `pathOfError`. For more information about how to specify the path see the
      * [eslint lodash plugin docs](https://github.com/wix/eslint-plugin-lodash/blob/master/docs/rules/path-style.md).
@@ -48,7 +48,7 @@ export default class ErrorSchemaBuilder<T = any> {
      * @param [pathOfError] - The optional path into the `ErrorSchema` at which to set the error(s)
      * @returns - The `ErrorSchemaBuilder` object for chaining purposes
      */
-    setErrors(errorOrList: string | string[], pathOfError?: string | string[]): this;
+    setErrors(errorOrList: string | string[], pathOfError?: string | (string | number)[]): this;
     /** Clears the error(s) in the `ErrorSchema` at either the root level or the location within the schema described by
      * the `pathOfError`. For more information about how to specify the path see the
      * [eslint lodash plugin docs](https://github.com/wix/eslint-plugin-lodash/blob/master/docs/rules/path-style.md).
@@ -56,5 +56,5 @@ export default class ErrorSchemaBuilder<T = any> {
      * @param [pathOfError] - The optional path into the `ErrorSchema` at which to clear the error(s)
      * @returns - The `ErrorSchemaBuilder` object for chaining purposes
      */
-    clearErrors(pathOfError?: string | string[]): this;
+    clearErrors(pathOfError?: string | (string | number)[]): this;
 }

package/lib/ErrorSchemaBuilder.js

@@ -1,6 +1,7 @@
 import cloneDeep from 'lodash/cloneDeep';
 import get from 'lodash/get';
 import set from 'lodash/set';
+import setWith from 'lodash/setWith';
 import { ERRORS_KEY } from './constants';
 /** The `ErrorSchemaBuilder<T>` is used to build an `ErrorSchema<T>` since the definition of the `ErrorSchema` type is
  * designed for reading information rather than writing it. Use this class to add, replace or clear errors in an error
@@ -36,7 +37,7 @@ export default class ErrorSchemaBuilder {
         let errorBlock = hasPath ? get(this.errorSchema, pathOfError) : this.errorSchema;
         if (!errorBlock && pathOfError) {
             errorBlock = {};
-            set(this.errorSchema, pathOfError, errorBlock);
+            setWith(this.errorSchema, pathOfError, errorBlock, Object);
         }
         return errorBlock;
     }