@rjsf/utils 6.4.2 → 6.5.0

package/src/types.ts

@@ -36,6 +36,14 @@ export type FormContextType = GenericObjectType;
  */
 export type TestIdShape = Record<string, string>;
 
+/** Controls how enum-backed widgets encode option values in their DOM `value` attributes.
+ *
+ * - `'indexed'`: options are encoded as their array index (default, historical behavior).
+ * - `'realValue'`: primitive option values are stringified directly, enabling native form
+ *   submission. Object/array values still fall back to their index.
+ */
+export type OptionValueFormat = 'indexed' | 'realValue';
+
 /** Function to generate HTML name attributes from path segments */
 export type NameGeneratorFunction = (path: FieldPathList, idPrefix: string, isMultiValue?: boolean) => string;
 
@@ -151,11 +159,15 @@ export type RangeSpecType = {
 };
 
 /** Properties describing a Range specification in terms of attribute that can be added to the `HTML` `<input>` */
-export type InputPropsType = Omit<RangeSpecType, 'step'> & {
+export type InputPropsType = {
   /** Specifies the type of the <input> element */
   type: string;
   /** Specifies the interval between legal numbers in an input field or "any" */
   step?: number | 'any';
+  /** Specifies a minimum value for an <input> element; accepts a number for numeric inputs or a string for date/time inputs */
+  min?: number | string;
+  /** Specifies the maximum value for an <input> element; accepts a number for numeric inputs or a string for date/time inputs */
+  max?: number | string;
   /** Specifies the `autoComplete` value for an <input> element */
   autoComplete?: HTMLInputElement['autocomplete'];
   /** Specifies a filter for what file types the user can upload. */
@@ -420,6 +432,21 @@ export type GlobalUISchemaOptions = GenericObjectType & {
    * both. To disable the Optional Data Field UI for a specific field, provide an empty array within the UI schema.
    */
   enableOptionalDataFieldForType?: ('object' | 'array')[];
+  /** Controls how enum-backed widgets (select, radio, checkboxes) encode option values
+   *  in their DOM `value` attributes.
+   *
+   *  - `'indexed'` (default): options are encoded as their array index. This is the
+   *    historical behavior and keeps object/array enum values addressable without
+   *    stringifying them.
+   *  - `'realValue'`: primitive option values are stringified directly (e.g. `"foo"`,
+   *    `"42"`, `"true"`). This enables native form submission and browser autocomplete
+   *    since the submitted value matches the enum value. Object/array values still
+   *    fall back to their index since `String(obj)` would produce `"[object Object]"`.
+   *
+   *  The form data passed to `onChange` is always the typed enum value; this option
+   *  only affects the DOM-level encoding.
+   */
+  optionValueFormat?: OptionValueFormat;
 };
 
 /** The set of options from the `Form` that will be available on the `Registry` for use in everywhere the `registry` is