@rjsf/utils 5.21.2 → 5.22.0

package/dist/utils.umd.js

@@ -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) {
@@ -549,7 +593,7 @@
           if (withContainsSchemas.length) {
             resolvedSchema = { ...resolvedSchema, allOf: withoutContainsSchemas };
           }
-          resolvedSchema = mergeAllOf(resolvedSchema, {
+          resolvedSchema = experimental_customMergeAllOf ? experimental_customMergeAllOf(resolvedSchema) : mergeAllOf(resolvedSchema, {
             deep: false
           });
           if (withContainsSchemas.length) {
@@ -590,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,
@@ -607,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) {
@@ -635,7 +680,8 @@
           dependencyValue,
           expandAllBranches,
           recurseList,
-          formData
+          formData,
+          experimental_customMergeAllOf
         );
       }
       return schemas.flatMap(
@@ -646,7 +692,8 @@
           rootSchema,
           expandAllBranches,
           recurseList,
-          formData
+          formData,
+          experimental_customMergeAllOf
         )
       );
     }
@@ -659,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;
@@ -690,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;
@@ -726,7 +775,8 @@
         rootSchema,
         formData,
         expandAllBranches,
-        recurseList
+        recurseList,
+        experimental_customMergeAllOf
       );
       return schemas.map((s2) => mergeSchemas(schema, s2));
     });
@@ -742,7 +792,7 @@
       }
     }
   };
-  function calculateIndexScore(validator, rootSchema, schema, formData = {}) {
+  function calculateIndexScore(validator, rootSchema, schema, formData) {
     let totalScore = 0;
     if (schema) {
       if (isObject2(schema.properties)) {
@@ -770,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;
@@ -837,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;
       });
@@ -857,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;
   }
 
@@ -932,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)) {
@@ -964,6 +1026,7 @@
       includeUndefinedValues = false,
       _recurseList = [],
       experimental_defaultFormStateBehavior = void 0,
+      experimental_customMergeAllOf = void 0,
       required
     } = computeDefaultsProps;
     const formData = isObject(rawFormData) ? rawFormData : {};
@@ -971,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;
@@ -986,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(
@@ -1054,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]),
@@ -1078,7 +1157,8 @@
             includeUndefinedValues,
             required,
             retrievedSchema.required,
-            experimental_defaultFormStateBehavior
+            experimental_defaultFormStateBehavior,
+            hasConst
           );
           return acc;
         },
@@ -1160,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) {
@@ -1194,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;
   }
@@ -1375,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));
@@ -1388,8 +1474,7 @@
           id,
           rootSchema,
           formData,
-          _recurseList.concat(_schema)
-        );
+          _recurseList.concat(_schema));
       }
     }
     if (ITEMS_KEY in schema && !get8(schema, [ITEMS_KEY, REF_KEY])) {
@@ -1401,8 +1486,7 @@
         id,
         rootSchema,
         formData,
-        _recurseList
-      );
+        _recurseList);
     }
     const $id = id || idPrefix;
     const idSchema = { $id };
@@ -1420,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) {
@@ -1526,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`
      *
@@ -1546,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`.
@@ -1571,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`
@@ -1681,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
@@ -1707,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
      *
@@ -1720,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

package/lib/createSchemaUtils.d.ts

@@ -1,10 +1,11 @@
-import { FormContextType, RJSFSchema, SchemaUtilsType, StrictRJSFSchema, ValidatorType } from './types';
+import { Experimental_CustomMergeAllOf, FormContextType, RJSFSchema, SchemaUtilsType, StrictRJSFSchema, ValidatorType } from './types';
 /** Creates a `SchemaUtilsType` interface that is based around the given `validator` and `rootSchema` parameters. The
  * resulting interface implementation will forward the `validator` and `rootSchema` to all the wrapped APIs.
  *
  * @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] 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 - An implementation of a `SchemaUtilsType` interface
  */
-export default function createSchemaUtils<T = any, S extends StrictRJSFSchema = RJSFSchema, F extends FormContextType = any>(validator: ValidatorType<T, S, F>, rootSchema: S, experimental_defaultFormStateBehavior?: {}): SchemaUtilsType<T, S, F>;
+export default function createSchemaUtils<T = any, S extends StrictRJSFSchema = RJSFSchema, F extends FormContextType = any>(validator: ValidatorType<T, S, F>, rootSchema: S, experimental_defaultFormStateBehavior?: {}, experimental_customMergeAllOf?: Experimental_CustomMergeAllOf<S>): SchemaUtilsType<T, S, F>;