@react-querybuilder/core 8.14.4 → 8.16.0

package/dist/react-querybuilder_core.legacy-esm.d.ts

@@ -12,7 +12,7 @@ type Primitive = null | undefined | string | number | boolean | symbol | bigint;
 //#endregion
 //#region ../../node_modules/type-fest/source/union-to-intersection.d.ts
 /**
-Convert a union type to an intersection type using [distributive conditional types](https://www.typescriptlang.org/docs/handbook/release-notes/typescript-2-8.html#distributive-conditional-types).
+Convert a union type to an intersection type.
 
 Inspired by [this Stack Overflow answer](https://stackoverflow.com/a/50375286/2172153).
 
@@ -972,7 +972,7 @@ type _Except<ObjectType, KeysType extends keyof ObjectType, Options extends Requ
 //#endregion
 //#region ../../node_modules/type-fest/source/require-at-least-one.d.ts
 /**
-Create a type that requires at least one of the given keys. The remaining keys are kept as is.
+Create a type that requires at least one of the given keys, while keeping the remaining keys as is.
 
 @example
 ```
@@ -994,19 +994,20 @@ const responder: RequireAtLeastOne<Responder, 'text' | 'json'> = {
 */
 type RequireAtLeastOne$1<ObjectType, KeysType extends keyof ObjectType = keyof ObjectType> = IfNotAnyOrNever<ObjectType, If<IsNever<KeysType>, never, _RequireAtLeastOne<ObjectType, If<IsAny<KeysType>, keyof ObjectType, KeysType>>>>;
 type _RequireAtLeastOne<ObjectType, KeysType extends keyof ObjectType> = { // For each `Key` in `KeysType` make a mapped type:
-[Key in KeysType]-?: Required<Pick<ObjectType, Key>> & // 1. Make `Key`'s type required
-// 2. Make all other keys in `KeysType` optional
-Partial<Pick<ObjectType, Exclude<KeysType, Key>>> }[KeysType] & // 3. Add the remaining keys not in `KeysType`
-Except<ObjectType, KeysType>;
+  // 2. Make all other keys in `KeysType` optional
+[Key in KeysType]-?: Required<Pick<ObjectType, Key>> // 1. Make `Key`'s type required
+& Partial<Pick<ObjectType, Exclude<KeysType, Key>>> }[KeysType] & Except<ObjectType, KeysType>; // 3. Add the remaining keys not in `KeysType`
 //#endregion
 //#region ../../node_modules/type-fest/source/required-deep.d.ts
 /**
-Create a type from another type with all keys and nested keys set to required.
+Create a deeply required version of another type.
 
 Use-cases:
 - Creating optional configuration interfaces where the underlying implementation still requires all options to be fully specified.
 - Modeling the resulting type after a deep merge with a set of defaults.
 
+Use [`Required<T>`](https://www.typescriptlang.org/docs/handbook/utility-types.html#requiredtype) if you only need one level deep.
+
 @example
 ```
 import type {RequiredDeep} from 'type-fest';
@@ -1047,7 +1048,7 @@ type RequiredObjectDeep<ObjectType extends object> = { [KeyType in keyof ObjectT
 //#endregion
 //#region ../../node_modules/type-fest/source/set-optional.d.ts
 /**
-Create a type that makes the given keys optional. The remaining keys are kept as is. The sister of the `SetRequired` type.
+Create a type that makes the given keys optional, while keeping the remaining keys as is.
 
 Use-case: You want to define a single model where the only thing that changes is whether or not some of the keys are optional.
 
@@ -1070,12 +1071,12 @@ type SomeOptional = SetOptional<Foo, 'b' | 'c'>;
 type SetOptional<BaseType, Keys extends keyof BaseType> = (BaseType extends ((...arguments_: never) => any) ? (...arguments_: Parameters<BaseType>) => ReturnType<BaseType> : unknown) & _SetOptional<BaseType, Keys>;
 type _SetOptional<BaseType, Keys extends keyof BaseType> = BaseType extends unknown // To distribute `BaseType` when it's a union type.
 ? Simplify< // Pick just the keys that are readonly from the base type.
-Except<BaseType, Keys> & // Pick the keys that should be mutable from the base type and make them mutable.
-Partial<HomomorphicPick<BaseType, Keys>>> : never;
+Except<BaseType, Keys> // Pick the keys that should be mutable from the base type and make them mutable.
+& Partial<HomomorphicPick<BaseType, Keys>>> : never;
 //#endregion
 //#region ../../node_modules/type-fest/source/set-required.d.ts
 /**
-Create a type that makes the given keys required. The remaining keys are kept as is. The sister of the `SetOptional` type.
+Create a type that makes the given keys required, while keeping the remaining keys as is.
 
 Use-case: You want to define a single model where the only thing that changes is whether or not some of the keys are required.
 
@@ -1101,8 +1102,8 @@ type ArrayExample = SetRequired<[number?, number?, number?], 0 | 1>;
 */
 type SetRequired<BaseType, Keys extends keyof BaseType> = (BaseType extends ((...arguments_: never) => any) ? (...arguments_: Parameters<BaseType>) => ReturnType<BaseType> : unknown) & _SetRequired<BaseType, Keys>;
 type _SetRequired<BaseType, Keys extends keyof BaseType> = BaseType extends UnknownArray ? SetArrayRequired<BaseType, Keys> extends infer ResultantArray ? If<IsArrayReadonly<BaseType>, Readonly<ResultantArray>, ResultantArray> : never : Simplify< // Pick just the keys that are optional from the base type.
-Except<BaseType, Keys> & // Pick the keys that should be required from the base type and make them required.
-Required<HomomorphicPick<BaseType, Keys>>>;
+Except<BaseType, Keys> // Pick the keys that should be required from the base type and make them required.
+& Required<HomomorphicPick<BaseType, Keys>>>;
 /**
 Remove the optional modifier from the specified keys in an array.
 */
@@ -1301,7 +1302,7 @@ interface CommonRuleAndGroupProperties {
 * The main rule type. The `field`, `operator`, and `value` properties
 * can be narrowed with generics.
 */
-interface RuleType<F extends string = string, O extends string = string, V = any, C extends string = string> extends CommonRuleAndGroupProperties {
+interface RuleType<F extends string = string, O extends string = string, V = any, C extends string = string, M = Record<string, any>> extends CommonRuleAndGroupProperties {
   field: F;
   operator: O;
   value: V;
@@ -1311,6 +1312,13 @@ interface RuleType<F extends string = string, O extends string = string, V = any
   * Only used when adding a rule to a query that uses independent combinators.
   */
   combinatorPreceding?: C;
+  /**
+  * Opaque metadata for use by extension packages. The core library
+  * preserves this property but does not read or interpret it.
+  * Extensions like `@react-querybuilder/graph` use `meta` to store
+  * domain-specific context (e.g., graph pattern information).
+  */
+  meta?: M;
 }
 /**
 * The main rule group type. This type is used for query definitions as well as
@@ -1452,6 +1460,20 @@ type GetRuleTypeFromGroupWithFieldAndOperator<RG extends RuleGroupTypeAny, F ext
 * Converts a narrowed rule group type to its most generic form.
 */
 type GenericizeRuleGroupType<RG> = RG extends RuleGroupType ? RuleGroupType : RuleGroupTypeIC;
+/**
+* Converts a {@link RuleGroupType} extension to the corresponding
+* {@link RuleGroupTypeIC} type, preserving any additional properties.
+* If the type already extends {@link RuleGroupTypeIC}, it is returned as-is.
+*/
+type ToRuleGroupTypeIC<T extends RuleGroupTypeAny> = T extends RuleGroupTypeIC ? T : T extends DefaultRuleGroupType<infer F> ? DefaultRuleGroupTypeIC<F> : T extends RuleGroupType<infer R, infer C> ? RuleGroupTypeIC<R, C> & Omit<T, keyof RuleGroupType<R, C>> : T;
+/**
+* Converts a {@link RuleGroupTypeIC} extension to the corresponding
+* {@link RuleGroupType} type, preserving any additional properties.
+* If the type already extends {@link RuleGroupType} (non-IC), it is returned as-is.
+*/
+type ToRuleGroupType<T extends RuleGroupTypeAny> = T extends {
+  combinator: string;
+} ? T : T extends DefaultRuleGroupTypeIC<infer F> ? DefaultRuleGroupType<F> : T extends RuleGroupTypeIC<infer R, infer C> ? RuleGroupType<R, C> & Omit<T, keyof RuleGroupTypeIC<R, C>> : T;
 //#endregion
 //#region src/types/validation.d.ts
 /**
@@ -1506,7 +1528,7 @@ type ToOptionArrays<Sources extends readonly string[]> = Sources extends unknown
   value: Sources[K];
   label: string;
 } } : never;
-type ToFlexibleOptionArrays<Sources extends readonly string[]> = Sources extends unknown ? { [K in keyof Sources]: FlexibleOption<Sources[K]> } : never;
+type ToFlexibleOptionArrays<Sources extends readonly string[]> = Sources extends unknown ? { [K in keyof Sources]: FlexibleOption } : never;
 type WithOptionalClassName<T> = T & {
   className?: Classname;
 };
@@ -1726,13 +1748,13 @@ interface DropCollection {
 *
 * @group Export
 */
-type ExportFormat = "json" | "sql" | "json_without_ids" | "parameterized" | "parameterized_named" | "mongodb" | "mongodb_query" | "cel" | "jsonlogic" | "spel" | "elasticsearch" | "jsonata" | "natural_language" | "ldap" | "drizzle" | "prisma" | "sequelize";
+type ExportFormat = "json" | "sql" | "json_without_ids" | "parameterized" | "parameterized_named" | "mongodb" | "mongodb_query" | "cel" | "jsonlogic" | "spel" | "elasticsearch" | "jsonata" | "natural_language" | "ldap" | "drizzle" | "prisma" | "sequelize" | "cypher" | "gql" | "sparql" | "gremlin" | "diagnostics";
 /**
 * Export formats for {@link formatQuery} that produce objects instead of strings.
 *
 * @group Export
 */
-type ExportObjectFormats = "parameterized" | "parameterized_named" | "jsonlogic" | "elasticsearch" | "jsonata" | "mongodb_query";
+type ExportObjectFormats = "parameterized" | "parameterized_named" | "jsonlogic" | "elasticsearch" | "jsonata" | "mongodb_query" | "diagnostics";
 /**
 * Available presets for the "sql" export format.
 *
@@ -2111,6 +2133,150 @@ interface ParameterizedNamedSQL {
   params: Record<string, any>;
 }
 /**
+* A {@link RuleType} annotated with diagnostics results, as produced
+* by {@link formatQuery} for the `"diagnostics"` format.
+*
+* The generics mirror those of {@link RuleType}.
+*
+* @group Export
+*/
+type RuleDiagnosticsResult<F extends string = string, O extends string = string, V = any, C extends string = string> = RuleType<F, O, V, C> & {
+  /** Whether the rule passed all validation checks. */valid: boolean;
+  /**
+  * Reasons why the rule is invalid. Only present when
+  * the rule is invalid and specific reasons were provided
+  * by the validator.
+  */
+  reasons?: any[]; /** The path to this rule within the query tree. */
+  path: number[]; /** The nesting depth of this rule (`path.length`). */
+  level: number;
+};
+/**
+* The type of the `rules` array in a {@link RuleGroupDiagnosticsResult}.
+*
+* @group Export
+*/
+type RuleGroupDiagnosticsArray<RG extends RuleGroupDiagnosticsResult = RuleGroupDiagnosticsResult, R extends RuleDiagnosticsResult = RuleDiagnosticsResult> = RuleGroupArray<RG, R>;
+/**
+* A {@link RuleGroupType} annotated with diagnostics results, as produced
+* by {@link formatQuery} for the `"diagnostics"` format.
+*
+* The generics mirror those of {@link RuleGroupType}.
+*
+* @group Export
+*/
+interface RuleGroupDiagnosticsResult<R extends RuleDiagnosticsResult = RuleDiagnosticsResult, C extends string = string> extends Omit<RuleGroupType<R, C>, "rules"> {
+  /** Whether the group and all of its descendants are valid. */
+  valid: boolean;
+  /**
+  * Reasons why the group itself is invalid. Only present when
+  * the group is invalid and specific reasons were provided
+  * by the validator.
+  */
+  reasons?: any[];
+  /** The path to this group within the query tree. */
+  path: number[];
+  /** The nesting depth of this group (`path.length`). */
+  level: number;
+  rules: RuleGroupDiagnosticsArray<RuleGroupDiagnosticsResult<R, C>, R>;
+}
+/**
+* The type of the `rules` array in a {@link RuleGroupICDiagnosticsResult}.
+*
+* Mirrors {@link RuleGroupICArray} but with diagnostics-annotated node types.
+*
+* @group Export
+*/
+type RuleGroupICDiagnosticsArray<RG extends RuleGroupICDiagnosticsResult = RuleGroupICDiagnosticsResult, R extends RuleDiagnosticsResult = RuleDiagnosticsResult, C extends string = string> = RuleGroupICArray<RG, R, C>;
+/**
+* A {@link RuleGroupTypeIC} annotated with diagnostics results, as produced
+* by {@link formatQuery} for the `"diagnostics"` format (independent combinators).
+*
+* The generics mirror those of {@link RuleGroupTypeIC}.
+*
+* @group Export
+*/
+interface RuleGroupICDiagnosticsResult<R extends RuleDiagnosticsResult = RuleDiagnosticsResult, C extends string = string> extends Omit<RuleGroupTypeIC<R, C>, "rules"> {
+  /** Whether the group and all of its descendants are valid. */
+  valid: boolean;
+  /**
+  * Reasons why the group itself is invalid. Only present when
+  * the group is invalid and specific reasons were provided
+  * by the validator.
+  */
+  reasons?: any[];
+  /** The path to this group within the query tree. */
+  path: number[];
+  /** The nesting depth of this group (`path.length`). */
+  level: number;
+  rules: RuleGroupICDiagnosticsArray<RuleGroupICDiagnosticsResult<R, C>, R, C>;
+}
+/**
+* A single diagnostic entry produced by the `"diagnostics"` format.
+*
+* @group Export
+*/
+interface DiagnosticEntry {
+  /** The `id` of the rule or group this diagnostic pertains to. */
+  id: string;
+  /** The path to the rule or group within the query tree. */
+  path: number[];
+  /** A machine-readable code identifying the type of diagnostic. */
+  code: string;
+  /** A human-readable description of the diagnostic. */
+  message: string;
+  /**
+  * Which check produced this diagnostic.
+  *
+  * - `"placeholder"` — a placeholder field, operator, or value
+  * - `"muted"` — a muted rule or group
+  * - `"query-validator"` — the query-level validator
+  * - `"field-validator"` — a field-level validator
+  * - `"type-check"` — value/type mismatch based on field `inputType`
+  * - `"field-check"` — field existence check against the `fields` config
+  */
+  source: "placeholder" | "muted" | "query-validator" | "field-validator" | "type-check" | "field-check";
+}
+/**
+* Aggregate statistics for the `"diagnostics"` format.
+*
+* @group Export
+*/
+interface DiagnosticsStats {
+  totalRules: number;
+  totalGroups: number;
+  validRules: number;
+  invalidRules: number;
+  validGroups: number;
+  invalidGroups: number;
+}
+/**
+* Per-field summary entry for the `"diagnostics"` format.
+*
+* @group Export
+*/
+interface DiagnosticsFieldSummaryEntry {
+  /** Number of rules referencing this field. */
+  ruleCount: number;
+  /** Number of invalid rules referencing this field. */
+  invalidCount: number;
+}
+/**
+* Top-level result of {@link formatQuery} for the `"diagnostics"` format.
+*
+* @group Export
+*/
+interface DiagnosticsResult {
+  /** The annotated query tree with `valid`, `path`, and `level` on every node. */
+  query: RuleGroupDiagnosticsResult | RuleGroupICDiagnosticsResult;
+  /** A flat array of all diagnostic entries across the tree. */
+  diagnostics: DiagnosticEntry[];
+  /** Aggregate statistics about the query. */
+  stats: DiagnosticsStats;
+  /** Per-field summary of rule counts and invalid counts. */
+  fieldSummary: Record<string, DiagnosticsFieldSummaryEntry>;
+}
+/**
 * @group Export
 */
 interface RQBJsonLogicStartsWith {
@@ -2335,6 +2501,16 @@ interface Classnames {
   */
   dndDropNotAllowed: Classname;
   /**
+  * Classname(s) applied to a rule or group at its prospective position
+  * during an active drag when `updateWhileDragging` is enabled.
+  */
+  dndPreviewPosition: Classname;
+  /**
+  * Classname(s) applied to a dragged rule or group at its original position
+  * to hide it when `updateWhileDragging` is enabled.
+  */
+  dndHidden: Classname;
+  /**
   * Classname(s) applied to disabled elements.
   */
   disabled: Classname;
@@ -2708,6 +2884,8 @@ declare const standardClassnames: {
   readonly dndCopy: "dndCopy";
   readonly dndGroup: "dndGroup";
   readonly dndDropNotAllowed: "dndDropNotAllowed";
+  readonly dndPreviewPosition: "dndPreviewPosition";
+  readonly dndHidden: "dndHidden";
   readonly dragHandle: "queryBuilder-dragHandle";
   readonly disabled: "queryBuilder-disabled";
   readonly muted: "queryBuilder-muted";
@@ -2864,7 +3042,7 @@ declare function clsx(...args: ClassValue[]): string;
 *
 * @group Query Tools
 */
-declare const convertFromIC: <RG extends RuleGroupType = RuleGroupType>(rg: RuleGroupTypeAny) => RG;
+declare const convertFromIC: <RG extends RuleGroupTypeAny>(rg: RG) => ToRuleGroupType<RG>;
 /**
 * Converts a {@link RuleGroupType} to {@link RuleGroupTypeIC}.
 *
@@ -2873,7 +3051,7 @@ declare const convertFromIC: <RG extends RuleGroupType = RuleGroupType>(rg: Rule
 *
 * @group Query Tools
 */
-declare const convertToIC: <RGIC extends RuleGroupTypeIC = RuleGroupTypeIC>(rg: RuleGroupTypeAny) => RGIC;
+declare const convertToIC: <RG extends RuleGroupTypeAny>(rg: RG) => ToRuleGroupTypeIC<RG>;
 /**
 * Converts a {@link RuleGroupType} to {@link RuleGroupTypeIC}. For a more explicit
 * operation, use {@link convertToIC}.
@@ -2956,6 +3134,23 @@ declare const defaultValueProcessorByRule: ValueProcessorByRule;
 */
 declare const defaultRuleGroupProcessorCEL: RuleGroupProcessor<string>;
 //#endregion
+//#region src/utils/formatQuery/defaultRuleGroupProcessorCypher.d.ts
+/**
+* Maps a {@link DefaultCombinatorName} to a Cypher combinator keyword.
+*
+* @group Export
+*/
+declare const cypherCombinatorMap: {
+  and: "AND";
+  or: "OR";
+};
+/**
+* Rule group processor used by {@link formatQuery} for "cypher" and "gql" formats.
+*
+* @group Export
+*/
+declare const defaultRuleGroupProcessorCypher: RuleGroupProcessor<string>;
+//#endregion
 //#region src/utils/formatQuery/defaultRuleGroupProcessorDrizzle.d.ts
 /**
 * Default rule group processor used by {@link formatQuery} for the "drizzle" format. The returned
@@ -2979,6 +3174,18 @@ declare const defaultRuleGroupProcessorDrizzle: RuleGroupProcessor<(columns: Rec
 */
 declare const defaultRuleGroupProcessorElasticSearch: RuleGroupProcessor<Record<string, unknown>>;
 //#endregion
+//#region src/utils/formatQuery/defaultRuleGroupProcessorGremlin.d.ts
+/**
+* Rule group processor used by {@link formatQuery} for "gremlin" format.
+*
+* At the top level, filter rules produce chained `.has()` steps (implicit AND).
+* Nested groups use `.and()` / `.or()` / `.not()` compound traversals with
+* `__` anonymous traversal prefixes.
+*
+* @group Export
+*/
+declare const defaultRuleGroupProcessorGremlin: RuleGroupProcessor<string>;
+//#endregion
 //#region src/utils/formatQuery/defaultRuleGroupProcessorJSONata.d.ts
 /**
 * Rule group processor used by {@link formatQuery} for "jsonata" format.
@@ -3070,6 +3277,16 @@ declare const defaultRuleGroupProcessorPrisma: RuleGroupProcessor<Record<string,
 */
 declare const defaultRuleGroupProcessorSequelize: RuleGroupProcessor<WhereOptions | undefined>;
 //#endregion
+//#region src/utils/formatQuery/defaultRuleGroupProcessorSPARQL.d.ts
+/**
+* Rule group processor used by {@link formatQuery} for "sparql" format.
+*
+* SPARQL uses the same combinators as CEL (`&&` / `||`) and `!()` for negation.
+*
+* @group Export
+*/
+declare const defaultRuleGroupProcessorSPARQL: RuleGroupProcessor<string>;
+//#endregion
 //#region src/utils/formatQuery/defaultRuleGroupProcessorSpEL.d.ts
 /**
 * Default rule processor used by {@link formatQuery} for "spel" format.
@@ -3086,6 +3303,27 @@ declare const defaultRuleGroupProcessorSpEL: RuleGroupProcessor<string>;
 */
 declare const defaultRuleGroupProcessorSQL: RuleGroupProcessor<string>;
 //#endregion
+//#region src/utils/formatQuery/defaultRuleGroupProcessorDiagnostics.d.ts
+/**
+* Rule group processor used by {@link formatQuery} for "diagnostics" format.
+*
+* Produces a {@link DiagnosticsResult} containing an annotated copy of the query
+* tree (`query`) with `valid`, `reasons`, `path`, and `level` properties on every
+* rule and group; a flat `diagnostics` array; aggregate `stats`; and a per-field
+* `fieldSummary`.
+*
+* @group Export
+*/
+declare const defaultRuleGroupProcessorDiagnostics: RuleGroupProcessor<DiagnosticsResult>;
+//#endregion
+//#region src/utils/formatQuery/defaultRuleProcessorCypher.d.ts
+/**
+* Default rule processor used by {@link formatQuery} for "cypher" and "gql" formats.
+*
+* @group Export
+*/
+declare const defaultRuleProcessorCypher: RuleProcessor;
+//#endregion
 //#region src/utils/formatQuery/defaultRuleProcessorDrizzle.d.ts
 /**
 * Default rule processor used by {@link formatQuery} for the "drizzle" format.
@@ -3102,6 +3340,16 @@ declare const defaultRuleProcessorDrizzle: RuleProcessor;
 */
 declare const defaultRuleProcessorElasticSearch: RuleProcessor;
 //#endregion
+//#region src/utils/formatQuery/defaultRuleProcessorGremlin.d.ts
+/**
+* Default rule processor used by {@link formatQuery} for "gremlin" format.
+*
+* Each rule becomes a `.has()` step (or `.hasNot()`/`.has()` for null checks).
+*
+* @group Export
+*/
+declare const defaultRuleProcessorGremlin: RuleProcessor;
+//#endregion
 //#region src/utils/formatQuery/defaultRuleProcessorJSONata.d.ts
 /**
 * Default rule processor used by {@link formatQuery} for "jsonata" format.
@@ -3179,6 +3427,14 @@ declare const defaultRuleProcessorPrisma: RuleProcessor;
 */
 declare const defaultRuleProcessorSequelize: RuleProcessor;
 //#endregion
+//#region src/utils/formatQuery/defaultRuleProcessorSPARQL.d.ts
+/**
+* Default rule processor used by {@link formatQuery} for "sparql" format.
+*
+* @group Export
+*/
+declare const defaultRuleProcessorSPARQL: RuleProcessor;
+//#endregion
 //#region src/utils/formatQuery/defaultRuleProcessorSQL.d.ts
 /**
 * Default operator processor used by {@link formatQuery} for "sql" and "parameterized*" formats.
@@ -3334,6 +3590,15 @@ declare function formatQuery(ruleGroup: RuleGroupTypeAny, options: "ldap" | (For
   format: "ldap";
 })): string;
 /**
+* Generates a {@link DiagnosticsResult} from a query object, containing an annotated
+* query tree, a flat diagnostics array, aggregate stats, and a per-field summary.
+*
+* @group Export
+*/
+declare function formatQuery(ruleGroup: RuleGroupTypeAny, options: "diagnostics" | (FormatQueryOptions & {
+  format: "diagnostics";
+})): DiagnosticsResult;
+/**
 * Generates a formatted (indented two spaces) JSON string from a query object.
 *
 * @group Export
@@ -3592,6 +3857,7 @@ declare const generateAccessibleDescription: AccessibleDescriptionGenerator;
 //#endregion
 //#region src/utils/generateID.d.ts
 type UUID = `${string}-${string}-${string}-${string}-${string}`;
+declare const uuidV4regex: RegExp;
 /**
 * Default `id` generator. Generates a valid v4 UUID. Uses `crypto.randomUUID()`
 * when available, otherwise uses an alternate method based on `getRandomValues`.
@@ -3835,7 +4101,7 @@ declare function getFirstOption<Opt extends Option>(arr?: OptionGroup<Opt>[] | O
 *
 * @group Option Lists
 */
-declare const toFlatOptionArray: <T extends FullOption, OL extends FullOptionList<T>>(arr: OL) => T[];
+declare const toFlatOptionArray: <T extends FullOption>(arr: FullOptionList<T>) => T[];
 /**
 * Generates a new {@link OptionGroup} array with duplicates
 * removed based on the identifying property (`value` or `name`).
@@ -3970,7 +4236,7 @@ declare const prepareRuleGroup: <RG extends RuleGroupTypeAny>(queryObject: RG, {
 /**
 * Ensures that a rule or group is valid. See {@link prepareRule} and {@link prepareRuleGroup}.
 */
-declare const prepareRuleOrGroup: <RG extends RuleGroupTypeAny>(rg: RG | RuleType, {
+declare const prepareRuleOrGroup: (rg: RuleGroupTypeAny | RuleType, {
   idGenerator
 }?: PreparerOptions) => RuleGroupType | RuleGroupTypeIC | RuleType;
 //#endregion
@@ -4368,5 +4634,5 @@ declare function transformQuery(query: RuleGroupType, options?: TransformQueryOp
 */
 declare function transformQuery(query: RuleGroupTypeIC, options?: TransformQueryOptions<RuleGroupTypeIC>): any;
 //#endregion
-export { AccessibleDescriptionGenerator, ActionElementEventHandler, AddMethod, AddOptions, Arity, BaseFullOption, BaseOption, BaseOptionMap, BaseTranslation, BaseTranslationWithLabel, BaseTranslationWithPlaceholders, BaseTranslations, BaseTranslationsFull, Classname, Classnames, Combinator, CombinatorByValue, CommonRuleAndGroupProperties, CommonRuleSubComponentProps, ConstituentWordOrder, ConstituentWordOrderString, DefaultCombinator, DefaultCombinatorExtended, DefaultCombinatorName, DefaultCombinatorNameExtended, DefaultCombinators, DefaultCombinatorsExtended, DefaultMatchModes, DefaultOperator, DefaultOperatorName, DefaultOperators, DefaultRuleGroupArray, DefaultRuleGroupICArray, DefaultRuleGroupType, DefaultRuleGroupTypeAny, DefaultRuleGroupTypeIC, DefaultRuleOrGroupArray, DefaultRuleType, DndDropTargetType, DragCollection, DraggedItem, DropCollection, DropEffect, DropResult, ExportFormat, ExportObjectFormats, ExportOperatorMap, Field, FieldByValue, FindPathReturnType, FlexibleOption, FlexibleOptionGroup, FlexibleOptionList, FlexibleOptionListProp, FormatQueryFinalOptions, FormatQueryOptions, FormatQueryValidateRule, FullCombinator, FullField, FullOperator, FullOption, FullOptionList, FullOptionMap, FullOptionRecord, GenericizeRuleGroupType, GetOptionIdentifierType, GetOptionType, GetRuleGroupType, GetRuleTypeFromGroupWithFieldAndOperator, GroupMethod, GroupOptions, GroupVariantCondition, InputType, InsertMethod, InsertOptions, type JsonLogicAll, type JsonLogicAnd, type JsonLogicDoubleNegation, type JsonLogicEqual, type JsonLogicGreaterThan, type JsonLogicGreaterThanOrEqual, type JsonLogicInArray, type JsonLogicInString, type JsonLogicLessThan, type JsonLogicLessThanOrEqual, type JsonLogicNegation, type JsonLogicNone, type JsonLogicNotEqual, type JsonLogicOr, type JsonLogicReservedOperations, type JsonLogicRulesLogic, type JsonLogicSome, type JsonLogicStrictEqual, type JsonLogicStrictNotEqual, type JsonLogicVar, LogType, MatchConfig, MatchMode, MatchModeOptions, MoveMethod, MoveOptions, NLTranslationKey, NLTranslations, NameLabelPair, Operator, OperatorByValue, Option, OptionGroup, OptionList, ParameterizedNamedSQL, ParameterizedSQL, ParseNumberMethod, ParseNumberOptions, ParseNumbersPropConfig, Path, Placeholder, PrepareOptionListParams, PreparedOptionList, PreparerOptions, QueryActions, QueryBuilderFlags, QueryValidator, RQBJsonLogic, RQBJsonLogicEndsWith, RQBJsonLogicStartsWith, RQBJsonLogicVar, RegenerateIdOptions, RemoveMethod, RemoveNullability, RuleGroupArray, RuleGroupICArray, RuleGroupProcessor, RuleGroupType, RuleGroupTypeAny, RuleGroupTypeIC, RuleOrGroupArray, RuleProcessor, RuleType, RuleValidator, SQLPreset, StringUnionToFlexibleOptionArray, StringUnionToFullOptionArray, TestID, ToFlexibleOption, ToFullOption, TransformQueryOptions, UpdateMethod, UpdateOptions, UpdateableProperties, ValidationMap, ValidationResult, ValueChangeEventHandler, ValueEditorType, ValueOption, ValueProcessor, ValueProcessorByRule, ValueProcessorLegacy, ValueProcessorOptions, ValueSource, ValueSourceFlexibleOptions, ValueSourceFullOptions, ValueSources, WithRequired, WithUnknownIndex, add, addInPlace, bigIntJsonParseReviver, bigIntJsonStringifyReplacer, celCombinatorMap, clsx, convertFromIC, convertQuery, convertToIC, defaultCELValueProcessor, defaultCombinatorLabelMap, defaultCombinators, defaultCombinatorsExtended, defaultControlClassnames, defaultExportOperatorMap, defaultJoinChar, defaultMatchModes, defaultMongoDBValueProcessor, defaultNLTranslations, defaultOperatorLabelMap, defaultOperatorNegationMap, defaultOperatorProcessorNL, defaultOperatorProcessorSQL, defaultOperators, defaultPlaceholderFieldGroupLabel, defaultPlaceholderFieldLabel, defaultPlaceholderFieldName, defaultPlaceholderLabel, defaultPlaceholderName, defaultPlaceholderOperatorGroupLabel, defaultPlaceholderOperatorLabel, defaultPlaceholderOperatorName, defaultPlaceholderValueGroupLabel, defaultPlaceholderValueLabel, defaultPlaceholderValueName, defaultRuleGroupProcessorCEL, defaultRuleGroupProcessorDrizzle, defaultRuleGroupProcessorElasticSearch, defaultRuleGroupProcessorJSONata, defaultRuleGroupProcessorJsonLogic, defaultRuleGroupProcessorLDAP, defaultRuleGroupProcessorMongoDB, defaultRuleGroupProcessorMongoDBQuery, defaultRuleGroupProcessorNL, defaultRuleGroupProcessorParameterized, defaultRuleGroupProcessorPrisma, defaultRuleGroupProcessorSQL, defaultRuleGroupProcessorSequelize, defaultRuleGroupProcessorSpEL, defaultRuleProcessorCEL, defaultRuleProcessorDrizzle, defaultRuleProcessorElasticSearch, defaultRuleProcessorJSONata, defaultRuleProcessorJsonLogic, defaultRuleProcessorLDAP, defaultRuleProcessorMongoDB, defaultRuleProcessorMongoDBQuery, defaultRuleProcessorNL, defaultRuleProcessorParameterized, defaultRuleProcessorPrisma, defaultRuleProcessorSQL, defaultRuleProcessorSequelize, defaultRuleProcessorSpEL, defaultSpELValueProcessor, defaultTranslations, defaultValidator, defaultValueProcessor, defaultValueProcessorByRule, defaultValueProcessorCELByRule, defaultValueProcessorMongoDBByRule, defaultValueProcessorNL, defaultValueProcessorSpELByRule, filterFieldsByComparator, findID, findPath, formatQuery, formatQueryOptionPresets, generateAccessibleDescription, generateID, getCommonAncestorPath, getFirstOption, getMatchModesUtil, getNLTranslataion, getOption, getParentPath, getParseNumberMethod, getPathOfID, getQuoteFieldNamesWithArray, getQuotedFieldName, getValidationClassNames, getValueSourcesUtil, group, groupInPlace, groupInvalidReasons, insert, insertInPlace, isAncestor, isFlexibleOptionArray, isFlexibleOptionGroupArray, isFullOptionArray, isFullOptionGroupArray, isOptionGroupArray, isPojo, isRuleGroup, isRuleGroupType, isRuleGroupTypeIC, isRuleOrGroupValid, isRuleType, isUnsafeKey, isValidValue, isValidationResult, isValueProcessorLegacy, joinWith, jsonLogicAdditionalOperators, lc, mapSQLOperator, mergeAnyTranslation, mergeAnyTranslations, mergeClassnames, mongoDbFallback, mongoOperators, move, moveInPlace, normalizeConstituentWordOrder, nullFreeArray, nullOrUndefinedOrEmpty, numericRegex, numerifyValues, objectEntries, objectKeys, parseNumber, pathIsDisabled, pathsAreEqual, preferAnyProp, preferFlagProps, preferProp, prepareOptionList, prepareRule, prepareRuleGroup, prepareRuleOrGroup, prismaFallback, prismaOperators, processMatchMode, queryBuilderFlagDefaults, regenerateID, regenerateIDs, remove, removeInPlace, rootPath, shouldRenderAsNumber, splitBy, sqlDialectPresets, standardClassnames, toArray, toFlatOptionArray, toFullOption, toFullOptionList, toFullOptionMap, transformQuery, trimIfString, uniqByIdentifier, uniqByName, uniqOptGroups, uniqOptList, update, updateInPlace };
+export { AccessibleDescriptionGenerator, ActionElementEventHandler, AddMethod, AddOptions, Arity, BaseFullOption, BaseOption, BaseOptionMap, BaseTranslation, BaseTranslationWithLabel, BaseTranslationWithPlaceholders, BaseTranslations, BaseTranslationsFull, Classname, Classnames, Combinator, CombinatorByValue, CommonRuleAndGroupProperties, CommonRuleSubComponentProps, ConstituentWordOrder, ConstituentWordOrderString, DefaultCombinator, DefaultCombinatorExtended, DefaultCombinatorName, DefaultCombinatorNameExtended, DefaultCombinators, DefaultCombinatorsExtended, DefaultMatchModes, DefaultOperator, DefaultOperatorName, DefaultOperators, DefaultRuleGroupArray, DefaultRuleGroupICArray, DefaultRuleGroupType, DefaultRuleGroupTypeAny, DefaultRuleGroupTypeIC, DefaultRuleOrGroupArray, DefaultRuleType, DiagnosticEntry, DiagnosticsFieldSummaryEntry, DiagnosticsResult, DiagnosticsStats, DndDropTargetType, DragCollection, DraggedItem, DropCollection, DropEffect, DropResult, ExportFormat, ExportObjectFormats, ExportOperatorMap, Field, FieldByValue, FindPathReturnType, FlexibleOption, FlexibleOptionGroup, FlexibleOptionList, FlexibleOptionListProp, FormatQueryFinalOptions, FormatQueryOptions, FormatQueryValidateRule, FullCombinator, FullField, FullOperator, FullOption, FullOptionList, FullOptionMap, FullOptionRecord, GenericizeRuleGroupType, GetOptionIdentifierType, GetOptionType, GetRuleGroupType, GetRuleTypeFromGroupWithFieldAndOperator, GroupMethod, GroupOptions, GroupVariantCondition, InputType, InsertMethod, InsertOptions, type JsonLogicAll, type JsonLogicAnd, type JsonLogicDoubleNegation, type JsonLogicEqual, type JsonLogicGreaterThan, type JsonLogicGreaterThanOrEqual, type JsonLogicInArray, type JsonLogicInString, type JsonLogicLessThan, type JsonLogicLessThanOrEqual, type JsonLogicNegation, type JsonLogicNone, type JsonLogicNotEqual, type JsonLogicOr, type JsonLogicReservedOperations, type JsonLogicRulesLogic, type JsonLogicSome, type JsonLogicStrictEqual, type JsonLogicStrictNotEqual, type JsonLogicVar, LogType, MatchConfig, MatchMode, MatchModeOptions, MoveMethod, MoveOptions, NLTranslationKey, NLTranslations, NameLabelPair, Operator, OperatorByValue, Option, OptionGroup, OptionList, ParameterizedNamedSQL, ParameterizedSQL, ParseNumberMethod, ParseNumberOptions, ParseNumbersPropConfig, Path, Placeholder, PrepareOptionListParams, PreparedOptionList, PreparerOptions, QueryActions, QueryBuilderFlags, QueryValidator, RQBJsonLogic, RQBJsonLogicEndsWith, RQBJsonLogicStartsWith, RQBJsonLogicVar, RegenerateIdOptions, RemoveMethod, RemoveNullability, RuleDiagnosticsResult, RuleGroupArray, RuleGroupDiagnosticsArray, RuleGroupDiagnosticsResult, RuleGroupICArray, RuleGroupICDiagnosticsArray, RuleGroupICDiagnosticsResult, RuleGroupProcessor, RuleGroupType, RuleGroupTypeAny, RuleGroupTypeIC, RuleOrGroupArray, RuleProcessor, RuleType, RuleValidator, SQLPreset, StringUnionToFlexibleOptionArray, StringUnionToFullOptionArray, TestID, ToFlexibleOption, ToFullOption, ToRuleGroupType, ToRuleGroupTypeIC, TransformQueryOptions, UpdateMethod, UpdateOptions, UpdateableProperties, ValidationMap, ValidationResult, ValueChangeEventHandler, ValueEditorType, ValueOption, ValueProcessor, ValueProcessorByRule, ValueProcessorLegacy, ValueProcessorOptions, ValueSource, ValueSourceFlexibleOptions, ValueSourceFullOptions, ValueSources, WithRequired, WithUnknownIndex, add, addInPlace, bigIntJsonParseReviver, bigIntJsonStringifyReplacer, celCombinatorMap, clsx, convertFromIC, convertQuery, convertToIC, cypherCombinatorMap, defaultCELValueProcessor, defaultCombinatorLabelMap, defaultCombinators, defaultCombinatorsExtended, defaultControlClassnames, defaultExportOperatorMap, defaultJoinChar, defaultMatchModes, defaultMongoDBValueProcessor, defaultNLTranslations, defaultOperatorLabelMap, defaultOperatorNegationMap, defaultOperatorProcessorNL, defaultOperatorProcessorSQL, defaultOperators, defaultPlaceholderFieldGroupLabel, defaultPlaceholderFieldLabel, defaultPlaceholderFieldName, defaultPlaceholderLabel, defaultPlaceholderName, defaultPlaceholderOperatorGroupLabel, defaultPlaceholderOperatorLabel, defaultPlaceholderOperatorName, defaultPlaceholderValueGroupLabel, defaultPlaceholderValueLabel, defaultPlaceholderValueName, defaultRuleGroupProcessorCEL, defaultRuleGroupProcessorCypher, defaultRuleGroupProcessorDiagnostics, defaultRuleGroupProcessorDrizzle, defaultRuleGroupProcessorElasticSearch, defaultRuleGroupProcessorGremlin, defaultRuleGroupProcessorJSONata, defaultRuleGroupProcessorJsonLogic, defaultRuleGroupProcessorLDAP, defaultRuleGroupProcessorMongoDB, defaultRuleGroupProcessorMongoDBQuery, defaultRuleGroupProcessorNL, defaultRuleGroupProcessorParameterized, defaultRuleGroupProcessorPrisma, defaultRuleGroupProcessorSPARQL, defaultRuleGroupProcessorSQL, defaultRuleGroupProcessorSequelize, defaultRuleGroupProcessorSpEL, defaultRuleProcessorCEL, defaultRuleProcessorCypher, defaultRuleProcessorDrizzle, defaultRuleProcessorElasticSearch, defaultRuleProcessorGremlin, defaultRuleProcessorJSONata, defaultRuleProcessorJsonLogic, defaultRuleProcessorLDAP, defaultRuleProcessorMongoDB, defaultRuleProcessorMongoDBQuery, defaultRuleProcessorNL, defaultRuleProcessorParameterized, defaultRuleProcessorPrisma, defaultRuleProcessorSPARQL, defaultRuleProcessorSQL, defaultRuleProcessorSequelize, defaultRuleProcessorSpEL, defaultSpELValueProcessor, defaultTranslations, defaultValidator, defaultValueProcessor, defaultValueProcessorByRule, defaultValueProcessorCELByRule, defaultValueProcessorMongoDBByRule, defaultValueProcessorNL, defaultValueProcessorSpELByRule, filterFieldsByComparator, findID, findPath, formatQuery, formatQueryOptionPresets, generateAccessibleDescription, generateID, getCommonAncestorPath, getFirstOption, getMatchModesUtil, getNLTranslataion, getOption, getParentPath, getParseNumberMethod, getPathOfID, getQuoteFieldNamesWithArray, getQuotedFieldName, getValidationClassNames, getValueSourcesUtil, group, groupInPlace, groupInvalidReasons, insert, insertInPlace, isAncestor, isFlexibleOptionArray, isFlexibleOptionGroupArray, isFullOptionArray, isFullOptionGroupArray, isOptionGroupArray, isPojo, isRuleGroup, isRuleGroupType, isRuleGroupTypeIC, isRuleOrGroupValid, isRuleType, isUnsafeKey, isValidValue, isValidationResult, isValueProcessorLegacy, joinWith, jsonLogicAdditionalOperators, lc, mapSQLOperator, mergeAnyTranslation, mergeAnyTranslations, mergeClassnames, mongoDbFallback, mongoOperators, move, moveInPlace, normalizeConstituentWordOrder, nullFreeArray, nullOrUndefinedOrEmpty, numericRegex, numerifyValues, objectEntries, objectKeys, parseNumber, pathIsDisabled, pathsAreEqual, preferAnyProp, preferFlagProps, preferProp, prepareOptionList, prepareRule, prepareRuleGroup, prepareRuleOrGroup, prismaFallback, prismaOperators, processMatchMode, queryBuilderFlagDefaults, regenerateID, regenerateIDs, remove, removeInPlace, rootPath, shouldRenderAsNumber, splitBy, sqlDialectPresets, standardClassnames, toArray, toFlatOptionArray, toFullOption, toFullOptionList, toFullOptionMap, transformQuery, trimIfString, uniqByIdentifier, uniqByName, uniqOptGroups, uniqOptList, update, updateInPlace, uuidV4regex };
 //# sourceMappingURL=react-querybuilder_core.legacy-esm.d.ts.map