@react-querybuilder/core 8.9.1 → 8.10.0

package/dist/arrayUtils-C9sO4qLO.mjs

@@ -0,0 +1,50 @@
+import { defaultJoinChar } from "./optGroupUtils-DrubUpx0.mjs";
+
+//#region src/utils/arrayUtils.ts
+/**
+* Splits a string by a given character (see {@link defaultJoinChar}). Escaped characters
+* (characters preceded by a backslash) will not apply to the split, and the backslash will
+* be removed in the array element. Inverse of {@link joinWith}.
+*
+* @example
+* splitBy('this\\,\\,that,,the other,,,\\,')
+* // or
+* splitBy('this\\,\\,that,,the other,,,\\,', ',')
+* // would return
+* ['this,,that', '', 'the other', '', '', ',']
+*/
+const splitBy = (str, splitChar = defaultJoinChar) => typeof str === "string" ? str.split(`\\${splitChar}`).map((c) => c.split(splitChar)).reduce((prev, curr, idx) => {
+	if (idx === 0) return curr;
+	return [
+		...prev.slice(0, -1),
+		`${prev.at(-1)}${splitChar}${curr[0]}`,
+		...curr.slice(1)
+	];
+}, []) : [];
+/**
+* Joins an array of strings using the given character (see {@link defaultJoinChar}). When
+* the given character appears in an array element, a backslash will be added just before it
+* to distinguish it from the join character. Effectively the inverse of {@link splitBy}.
+*
+* TIP: The join character can actually be a string of any length. Only the first character
+* will be searched for in the array elements and preceded by a backslash.
+*
+* @example
+* joinWith(['this,,that', '', 'the other', '', '', ','], ', ')
+* // would return
+* 'this\\,\\,that, , the other, , , \\,'
+*/
+const joinWith = (strArr, joinChar = defaultJoinChar) => strArr.map((str) => `${str ?? ""}`.replaceAll(joinChar[0], `\\${joinChar[0]}`)).join(joinChar);
+/**
+* Trims the value if it is a string. Otherwise returns the value as is.
+*/
+const trimIfString = (val) => typeof val === "string" ? val.trim() : val;
+/**
+* Splits a string by comma then trims each element. Arrays are returned as is except
+* any string elements are trimmed.
+*/
+const toArray = (v, { retainEmptyStrings } = {}) => Array.isArray(v) ? v.map((v$1) => trimIfString(v$1)) : typeof v === "string" ? splitBy(v, defaultJoinChar).filter(retainEmptyStrings ? () => true : (s) => !/^\s*$/.test(s)).map((s) => s.trim()) : typeof v === "number" ? [v] : [];
+
+//#endregion
+export { joinWith, splitBy, toArray, trimIfString };
+//# sourceMappingURL=arrayUtils-C9sO4qLO.mjs.map

package/dist/arrayUtils-C9sO4qLO.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrayUtils-C9sO4qLO.mjs","names":["v"],"sources":["../src/utils/arrayUtils.ts"],"sourcesContent":["import { defaultJoinChar } from '../defaults';\n\n/**\n * Splits a string by a given character (see {@link defaultJoinChar}). Escaped characters\n * (characters preceded by a backslash) will not apply to the split, and the backslash will\n * be removed in the array element. Inverse of {@link joinWith}.\n *\n * @example\n * splitBy('this\\\\,\\\\,that,,the other,,,\\\\,')\n * // or\n * splitBy('this\\\\,\\\\,that,,the other,,,\\\\,', ',')\n * // would return\n * ['this,,that', '', 'the other', '', '', ',']\n */\nexport const splitBy = (str?: string, splitChar: string = defaultJoinChar): string[] =>\n  typeof str === 'string'\n    ? str\n        .split(`\\\\${splitChar}`)\n        .map(c => c.split(splitChar))\n        .reduce((prev, curr, idx) => {\n          if (idx === 0) {\n            return curr;\n          }\n          return [...prev.slice(0, -1), `${prev.at(-1)}${splitChar}${curr[0]}`, ...curr.slice(1)];\n        }, [])\n    : [];\n\n/**\n * Joins an array of strings using the given character (see {@link defaultJoinChar}). When\n * the given character appears in an array element, a backslash will be added just before it\n * to distinguish it from the join character. Effectively the inverse of {@link splitBy}.\n *\n * TIP: The join character can actually be a string of any length. Only the first character\n * will be searched for in the array elements and preceded by a backslash.\n *\n * @example\n * joinWith(['this,,that', '', 'the other', '', '', ','], ', ')\n * // would return\n * 'this\\\\,\\\\,that, , the other, , , \\\\,'\n */\n// oxlint-disable-next-line typescript/no-explicit-any\nexport const joinWith = (strArr: any[], joinChar: string = defaultJoinChar): string =>\n  strArr.map(str => `${str ?? ''}`.replaceAll(joinChar[0], `\\\\${joinChar[0]}`)).join(joinChar);\n\n/**\n * Trims the value if it is a string. Otherwise returns the value as is.\n */\n// oxlint-disable-next-line typescript/no-explicit-any\nexport const trimIfString = (val: any): any => (typeof val === 'string' ? val.trim() : val);\n\n/**\n * Splits a string by comma then trims each element. Arrays are returned as is except\n * any string elements are trimmed.\n */\nexport const toArray = (\n  // oxlint-disable-next-line typescript/no-explicit-any\n  v: any,\n  { retainEmptyStrings }: { retainEmptyStrings?: boolean } = {}\n  // oxlint-disable-next-line typescript/no-explicit-any\n): any[] =>\n  Array.isArray(v)\n    ? v.map(v => trimIfString(v))\n    : typeof v === 'string'\n      ? splitBy(v, defaultJoinChar)\n          .filter(retainEmptyStrings ? () => true : s => !/^\\s*$/.test(s))\n          .map(s => s.trim())\n      : typeof v === 'number'\n        ? [v]\n        : [];\n\n/**\n * Determines if an array is free of `null`/`undefined`.\n */\nexport const nullFreeArray = <T>(arr: T[]): arr is Exclude<T, null>[] =>\n  arr.every(el => el === false || (el ?? false) !== false);\n"],"mappings":";;;;;;;;;;;;;;;AAcA,MAAa,WAAW,KAAc,YAAoB,oBACxD,OAAO,QAAQ,WACX,IACG,MAAM,KAAK,YAAY,CACvB,KAAI,MAAK,EAAE,MAAM,UAAU,CAAC,CAC5B,QAAQ,MAAM,MAAM,QAAQ;AAC3B,KAAI,QAAQ,EACV,QAAO;AAET,QAAO;EAAC,GAAG,KAAK,MAAM,GAAG,GAAG;EAAE,GAAG,KAAK,GAAG,GAAG,GAAG,YAAY,KAAK;EAAM,GAAG,KAAK,MAAM,EAAE;EAAC;GACtF,EAAE,CAAC,GACR,EAAE;;;;;;;;;;;;;;AAgBR,MAAa,YAAY,QAAe,WAAmB,oBACzD,OAAO,KAAI,QAAO,GAAG,OAAO,KAAK,WAAW,SAAS,IAAI,KAAK,SAAS,KAAK,CAAC,CAAC,KAAK,SAAS;;;;AAM9F,MAAa,gBAAgB,QAAmB,OAAO,QAAQ,WAAW,IAAI,MAAM,GAAG;;;;;AAMvF,MAAa,WAEX,GACA,EAAE,uBAAyD,EAAE,KAG7D,MAAM,QAAQ,EAAE,GACZ,EAAE,KAAI,QAAK,aAAaA,IAAE,CAAC,GAC3B,OAAO,MAAM,WACX,QAAQ,GAAG,gBAAgB,CACxB,OAAO,2BAA2B,QAAO,MAAK,CAAC,QAAQ,KAAK,EAAE,CAAC,CAC/D,KAAI,MAAK,EAAE,MAAM,CAAC,GACrB,OAAO,MAAM,WACX,CAAC,EAAE,GACH,EAAE"}

package/dist/arrayUtils-QxZOZTf6.js

@@ -0,0 +1,73 @@
+const require_optGroupUtils = require('./optGroupUtils-B0hTpodo.js');
+
+//#region src/utils/arrayUtils.ts
+/**
+* Splits a string by a given character (see {@link defaultJoinChar}). Escaped characters
+* (characters preceded by a backslash) will not apply to the split, and the backslash will
+* be removed in the array element. Inverse of {@link joinWith}.
+*
+* @example
+* splitBy('this\\,\\,that,,the other,,,\\,')
+* // or
+* splitBy('this\\,\\,that,,the other,,,\\,', ',')
+* // would return
+* ['this,,that', '', 'the other', '', '', ',']
+*/
+const splitBy = (str, splitChar = require_optGroupUtils.defaultJoinChar) => typeof str === "string" ? str.split(`\\${splitChar}`).map((c) => c.split(splitChar)).reduce((prev, curr, idx) => {
+	if (idx === 0) return curr;
+	return [
+		...prev.slice(0, -1),
+		`${prev.at(-1)}${splitChar}${curr[0]}`,
+		...curr.slice(1)
+	];
+}, []) : [];
+/**
+* Joins an array of strings using the given character (see {@link defaultJoinChar}). When
+* the given character appears in an array element, a backslash will be added just before it
+* to distinguish it from the join character. Effectively the inverse of {@link splitBy}.
+*
+* TIP: The join character can actually be a string of any length. Only the first character
+* will be searched for in the array elements and preceded by a backslash.
+*
+* @example
+* joinWith(['this,,that', '', 'the other', '', '', ','], ', ')
+* // would return
+* 'this\\,\\,that, , the other, , , \\,'
+*/
+const joinWith = (strArr, joinChar = require_optGroupUtils.defaultJoinChar) => strArr.map((str) => `${str ?? ""}`.replaceAll(joinChar[0], `\\${joinChar[0]}`)).join(joinChar);
+/**
+* Trims the value if it is a string. Otherwise returns the value as is.
+*/
+const trimIfString = (val) => typeof val === "string" ? val.trim() : val;
+/**
+* Splits a string by comma then trims each element. Arrays are returned as is except
+* any string elements are trimmed.
+*/
+const toArray = (v, { retainEmptyStrings } = {}) => Array.isArray(v) ? v.map((v$1) => trimIfString(v$1)) : typeof v === "string" ? splitBy(v, require_optGroupUtils.defaultJoinChar).filter(retainEmptyStrings ? () => true : (s) => !/^\s*$/.test(s)).map((s) => s.trim()) : typeof v === "number" ? [v] : [];
+
+//#endregion
+Object.defineProperty(exports, 'joinWith', {
+  enumerable: true,
+  get: function () {
+    return joinWith;
+  }
+});
+Object.defineProperty(exports, 'splitBy', {
+  enumerable: true,
+  get: function () {
+    return splitBy;
+  }
+});
+Object.defineProperty(exports, 'toArray', {
+  enumerable: true,
+  get: function () {
+    return toArray;
+  }
+});
+Object.defineProperty(exports, 'trimIfString', {
+  enumerable: true,
+  get: function () {
+    return trimIfString;
+  }
+});
+//# sourceMappingURL=arrayUtils-QxZOZTf6.js.map

package/dist/arrayUtils-QxZOZTf6.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrayUtils-QxZOZTf6.js","names":["defaultJoinChar","v"],"sources":["../src/utils/arrayUtils.ts"],"sourcesContent":["import { defaultJoinChar } from '../defaults';\n\n/**\n * Splits a string by a given character (see {@link defaultJoinChar}). Escaped characters\n * (characters preceded by a backslash) will not apply to the split, and the backslash will\n * be removed in the array element. Inverse of {@link joinWith}.\n *\n * @example\n * splitBy('this\\\\,\\\\,that,,the other,,,\\\\,')\n * // or\n * splitBy('this\\\\,\\\\,that,,the other,,,\\\\,', ',')\n * // would return\n * ['this,,that', '', 'the other', '', '', ',']\n */\nexport const splitBy = (str?: string, splitChar: string = defaultJoinChar): string[] =>\n  typeof str === 'string'\n    ? str\n        .split(`\\\\${splitChar}`)\n        .map(c => c.split(splitChar))\n        .reduce((prev, curr, idx) => {\n          if (idx === 0) {\n            return curr;\n          }\n          return [...prev.slice(0, -1), `${prev.at(-1)}${splitChar}${curr[0]}`, ...curr.slice(1)];\n        }, [])\n    : [];\n\n/**\n * Joins an array of strings using the given character (see {@link defaultJoinChar}). When\n * the given character appears in an array element, a backslash will be added just before it\n * to distinguish it from the join character. Effectively the inverse of {@link splitBy}.\n *\n * TIP: The join character can actually be a string of any length. Only the first character\n * will be searched for in the array elements and preceded by a backslash.\n *\n * @example\n * joinWith(['this,,that', '', 'the other', '', '', ','], ', ')\n * // would return\n * 'this\\\\,\\\\,that, , the other, , , \\\\,'\n */\n// oxlint-disable-next-line typescript/no-explicit-any\nexport const joinWith = (strArr: any[], joinChar: string = defaultJoinChar): string =>\n  strArr.map(str => `${str ?? ''}`.replaceAll(joinChar[0], `\\\\${joinChar[0]}`)).join(joinChar);\n\n/**\n * Trims the value if it is a string. Otherwise returns the value as is.\n */\n// oxlint-disable-next-line typescript/no-explicit-any\nexport const trimIfString = (val: any): any => (typeof val === 'string' ? val.trim() : val);\n\n/**\n * Splits a string by comma then trims each element. Arrays are returned as is except\n * any string elements are trimmed.\n */\nexport const toArray = (\n  // oxlint-disable-next-line typescript/no-explicit-any\n  v: any,\n  { retainEmptyStrings }: { retainEmptyStrings?: boolean } = {}\n  // oxlint-disable-next-line typescript/no-explicit-any\n): any[] =>\n  Array.isArray(v)\n    ? v.map(v => trimIfString(v))\n    : typeof v === 'string'\n      ? splitBy(v, defaultJoinChar)\n          .filter(retainEmptyStrings ? () => true : s => !/^\\s*$/.test(s))\n          .map(s => s.trim())\n      : typeof v === 'number'\n        ? [v]\n        : [];\n\n/**\n * Determines if an array is free of `null`/`undefined`.\n */\nexport const nullFreeArray = <T>(arr: T[]): arr is Exclude<T, null>[] =>\n  arr.every(el => el === false || (el ?? false) !== false);\n"],"mappings":";;;;;;;;;;;;;;;AAcA,MAAa,WAAW,KAAc,YAAoBA,0CACxD,OAAO,QAAQ,WACX,IACG,MAAM,KAAK,YAAY,CACvB,KAAI,MAAK,EAAE,MAAM,UAAU,CAAC,CAC5B,QAAQ,MAAM,MAAM,QAAQ;AAC3B,KAAI,QAAQ,EACV,QAAO;AAET,QAAO;EAAC,GAAG,KAAK,MAAM,GAAG,GAAG;EAAE,GAAG,KAAK,GAAG,GAAG,GAAG,YAAY,KAAK;EAAM,GAAG,KAAK,MAAM,EAAE;EAAC;GACtF,EAAE,CAAC,GACR,EAAE;;;;;;;;;;;;;;AAgBR,MAAa,YAAY,QAAe,WAAmBA,0CACzD,OAAO,KAAI,QAAO,GAAG,OAAO,KAAK,WAAW,SAAS,IAAI,KAAK,SAAS,KAAK,CAAC,CAAC,KAAK,SAAS;;;;AAM9F,MAAa,gBAAgB,QAAmB,OAAO,QAAQ,WAAW,IAAI,MAAM,GAAG;;;;;AAMvF,MAAa,WAEX,GACA,EAAE,uBAAyD,EAAE,KAG7D,MAAM,QAAQ,EAAE,GACZ,EAAE,KAAI,QAAK,aAAaC,IAAE,CAAC,GAC3B,OAAO,MAAM,WACX,QAAQ,GAAGD,sCAAgB,CACxB,OAAO,2BAA2B,QAAO,MAAK,CAAC,QAAQ,KAAK,EAAE,CAAC,CAC/D,KAAI,MAAK,EAAE,MAAM,CAAC,GACrB,OAAO,MAAM,WACX,CAAC,EAAE,GACH,EAAE"}

package/dist/basic-BmpEwexQ.d.mts

@@ -0,0 +1,363 @@
+import { Except, RequireAtLeastOne, SetRequired, Simplify } from "type-fest";
+
+//#region src/types/options.d.ts
+
+/**
+* Adds an `unknown` index property to an interface.
+*/
+type WithUnknownIndex<T> = T & {
+  [key: string]: unknown;
+};
+/**
+* Do not use this type directly; use {@link Option}, {@link ValueOption},
+* or {@link FullOption} instead. For specific option types, you can use
+* {@link FullField}, {@link FullOperator}, or {@link FullCombinator},
+* all of which extend {@link FullOption}.
+*
+* @group Option Lists
+*/
+interface BaseOption<N extends string = string> {
+  name?: N;
+  value?: N;
+  label: string;
+  disabled?: boolean;
+}
+/**
+* A generic option. Used directly in {@link OptionList} or
+* as the child element of an {@link OptionGroup}.
+*
+* @group Option Lists
+*/
+type Option<N extends string = string> = Simplify<WithUnknownIndex<SetRequired<BaseOption<N>, "name">>>;
+/**
+* A generic {@link Option} with either a `name` or `value` as its primary identifier.
+* {@link OptionList}-type props on the {@link QueryBuilder} component accept this type,
+* but corresponding props passed down to subcomponents will always be translated
+* to {@link FullOption} first.
+*
+* @group Option Lists
+*/
+type FlexibleOption<N extends string = string> = Simplify<WithUnknownIndex<RequireAtLeastOne<BaseOption<N>, "name" | "value">>>;
+/**
+* Utility type to turn an {@link Option}, {@link ValueOption}, or {@link BaseOption}
+* into a {@link FlexibleOption}.
+*
+* @group Option Lists
+*/
+type ToFlexibleOption<Opt extends BaseOption | string> = WithUnknownIndex<RequireAtLeastOne<Opt extends string ? FlexibleOption<Opt> : Opt, "name" | "value">>;
+/**
+* A generic {@link Option} requiring both `name` _and_ `value` properties.
+* Props that extend {@link OptionList} accept {@link BaseOption}, but
+* corresponding props sent to subcomponents will always be translated to this
+* type first to ensure both `name` and `value` are available.
+*
+* NOTE: Do not extend from this type directly. Use {@link BaseFullOption}
+* (optionally wrapped in {@link WithUnknownIndex}) instead, otherwise
+* the `unknown` index property will cause issues. See {@link Option} and
+* {@link ValueOption} for examples.
+*
+* @group Option Lists
+*/
+type FullOption<N extends string = string> = Simplify<WithUnknownIndex<SetRequired<BaseOption<N>, "name" | "value">>>;
+/**
+* This type is identical to {@link FullOption} but without the `unknown` index
+* property. Extend from this type instead of {@link FullOption} directly.
+*
+* @group Option Lists
+*/
+type BaseFullOption<N extends string = string> = Simplify<SetRequired<BaseOption<N>, "name" | "value">>;
+/**
+* Utility type to turn an {@link Option}, {@link ValueOption} or
+* {@link BaseOption} into a {@link FullOption}.
+*
+* @group Option Lists
+*/
+type ToFullOption<Opt extends BaseOption> = Opt extends BaseFullOption ? Opt : Opt extends BaseOption<infer IdentifierType> ? WithUnknownIndex<Opt & FullOption<IdentifierType>> : never;
+/**
+* A group of {@link Option}s, usually within an {@link OptionList}.
+*
+* @group Option Lists
+*/
+interface OptionGroup<Opt extends BaseOption = FlexibleOption> {
+  label: string;
+  options: WithUnknownIndex<Opt>[];
+}
+/**
+* A group of {@link BaseOption}s, usually within a {@link FlexibleOptionList}.
+*
+* @group Option Lists
+*/
+type FlexibleOptionGroup<Opt extends BaseOption | string = BaseOption> = {
+  label: string;
+  options: (Opt extends BaseFullOption ? Opt : ToFlexibleOption<Opt>)[];
+};
+/**
+* Either an array of {@link Option}s or an array of {@link OptionGroup}s.
+*
+* @group Option Lists
+*/
+type OptionList<Opt extends Option = Option> = Opt[] | OptionGroup<Opt>[];
+/**
+* An array of options or option groups, like {@link OptionList} but the option type
+* may use either `name` or `value` as the primary identifier.
+*
+* @group Option Lists
+*/
+type FlexibleOptionList<Opt extends BaseOption> = ToFlexibleOption<Opt>[] | FlexibleOptionGroup<ToFlexibleOption<Opt>>[];
+/**
+* An array of options or option groups, like {@link OptionList}, but using
+* {@link FullOption} instead of {@link Option}. This means that every member is
+* guaranteed to have both `name` and `value`.
+*
+* @group Option Lists
+*/
+type FullOptionList<Opt extends BaseOption> = Opt extends BaseFullOption ? Opt[] | OptionGroup<Opt>[] : ToFullOption<Opt>[] | OptionGroup<ToFullOption<Opt>>[];
+//#endregion
+//#region src/types/ruleGroups.d.ts
+/**
+* Properties common to both rules and groups.
+*/
+interface CommonRuleAndGroupProperties {
+  path?: Path;
+  id?: string;
+  disabled?: boolean;
+  /**
+  * Whether this rule or group is muted. When muted, the rule or group
+  * is excluded from query export formats (SQL, JSON, MongoDB, etc.).
+  * For groups, muting recursively mutes all children.
+  */
+  muted?: boolean;
+}
+/**
+* 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 {
+  field: F;
+  operator: O;
+  value: V;
+  valueSource?: ValueSource;
+  match?: MatchConfig;
+  /**
+  * Only used when adding a rule to a query that uses independent combinators.
+  */
+  combinatorPreceding?: C;
+}
+/**
+* The main rule group type. This type is used for query definitions as well as
+* all sub-groups of queries.
+*/
+interface RuleGroupType<R extends RuleType = RuleType, C extends string = string> extends CommonRuleAndGroupProperties {
+  combinator: C;
+  rules: RuleGroupArray<RuleGroupType<R, C>, R>;
+  not?: boolean;
+}
+/**
+* The type of the `rules` array in a {@link RuleGroupType}.
+*/
+type RuleGroupArray<RG extends RuleGroupType = RuleGroupType, R extends RuleType = RuleType> = (R | RG)[];
+/**
+* The type of the `rules` array in a {@link DefaultRuleGroupType}.
+*/
+type DefaultRuleGroupArray<F extends string = string> = RuleGroupArray<DefaultRuleGroupType, DefaultRuleType<F>>;
+/**
+* {@link RuleGroupType} with the `combinator` property limited to
+* {@link DefaultCombinatorNameExtended} and `rules` limited to {@link DefaultRuleType}.
+*/
+type DefaultRuleGroupType<F extends string = string> = RuleGroupType<DefaultRuleType<F>, DefaultCombinatorNameExtended> & {
+  rules: DefaultRuleGroupArray<F>;
+};
+/**
+* {@link RuleType} with the `operator` property limited to {@link DefaultOperatorName}.
+*/
+type DefaultRuleType<F extends string = string> = RuleType<F, DefaultOperatorName>;
+/**
+* Default allowed values for the `combinator` property.
+*
+* @group Option Lists
+*/
+type DefaultCombinatorName = "and" | "or";
+/**
+* Default allowed values for the `combinator` property, plus `"xor"`.
+*
+* @group Option Lists
+*/
+type DefaultCombinatorNameExtended = DefaultCombinatorName | "xor";
+/**
+* Default values for the `operator` property.
+*
+* @group Option Lists
+*/
+type DefaultOperatorName = "=" | "!=" | "<" | ">" | "<=" | ">=" | "contains" | "beginsWith" | "endsWith" | "doesNotContain" | "doesNotBeginWith" | "doesNotEndWith" | "null" | "notNull" | "in" | "notIn" | "between" | "notBetween";
+//#endregion
+//#region src/types/ruleGroupsIC.utils.d.ts
+type MAXIMUM_ALLOWED_BOUNDARY = 80;
+type MappedTuple<Tuple extends Array<unknown>, Result extends Array<unknown> = [], Count extends ReadonlyArray<number> = []> = Count["length"] extends MAXIMUM_ALLOWED_BOUNDARY ? Result : Tuple extends [] ? [] : Result extends [] ? MappedTuple<Tuple, Tuple, [...Count, 1]> : MappedTuple<Tuple, Result | [...Result, ...Tuple], [...Count, 1]>;
+//#endregion
+//#region src/types/ruleGroupsIC.d.ts
+/**
+* The main rule group interface when using independent combinators. This type is used
+* for query definitions as well as all sub-groups of queries.
+*/
+interface RuleGroupTypeIC<R extends RuleType = RuleType, C extends string = string> extends Except<RuleGroupType<R, C>, "combinator" | "rules"> {
+  combinator?: undefined;
+  rules: RuleGroupICArray<RuleGroupTypeIC<R, C>, R, C>;
+  /**
+  * Only used when adding a rule to a query that uses independent combinators
+  */
+  combinatorPreceding?: C;
+}
+/**
+* Shorthand for "either {@link RuleGroupType} or {@link RuleGroupTypeIC}".
+*/
+type RuleGroupTypeAny<R extends RuleType = RuleType, C extends string = string> = RuleGroupType<R, C> | RuleGroupTypeIC<R, C>;
+/**
+* The type of the `rules` array in a {@link RuleGroupTypeIC}.
+*/
+type RuleGroupICArray<RG extends RuleGroupTypeIC = RuleGroupTypeIC, R extends RuleType = RuleType, C extends string = string> = [R | RG] | [R | RG, ...MappedTuple<[C, R | RG]>] | ((R | RG)[] & {
+  length: 0;
+});
+/**
+* The type of the `rules` array in a {@link DefaultRuleGroupTypeIC}.
+*/
+type DefaultRuleGroupICArray<F extends string = string> = RuleGroupICArray<DefaultRuleGroupTypeIC<F>, DefaultRuleType<F>, DefaultCombinatorName>;
+/**
+* {@link RuleGroupTypeIC} with combinators limited to
+* {@link DefaultCombinatorName} and rules limited to {@link DefaultRuleType}.
+*/
+interface DefaultRuleGroupTypeIC<F extends string = string> extends RuleGroupTypeIC<DefaultRuleType<F>> {
+  rules: DefaultRuleGroupICArray<F>;
+}
+//#endregion
+//#region src/types/validation.d.ts
+/**
+* Object with a `valid` boolean value and optional `reasons`.
+*/
+interface ValidationResult {
+  valid: boolean;
+  reasons?: any[];
+}
+/**
+* Map of rule/group `id` to its respective {@link ValidationResult}.
+*/
+type ValidationMap = Record<string, boolean | ValidationResult>;
+/**
+* Function that validates a query.
+*/
+type QueryValidator = (query: RuleGroupTypeAny) => boolean | ValidationMap;
+/**
+* Function that validates a rule.
+*/
+type RuleValidator = (rule: RuleType) => boolean | ValidationResult;
+//#endregion
+//#region src/types/basic.d.ts
+/**
+* @see https://react-querybuilder.js.org/docs/tips/path
+*/
+type Path = number[];
+/**
+* String of classnames, array of classname strings, or object where the
+* keys are classnames and those with truthy values will be included.
+* Suitable for passing to the `clsx` package.
+*/
+type Classname = string | string[] | Record<string, any>;
+/**
+* A source for the `value` property of a rule.
+*/
+type ValueSource = "value" | "field";
+/**
+* Type of {@link ValueEditor} that will be displayed.
+*/
+type ValueEditorType = "text" | "select" | "checkbox" | "radio" | "textarea" | "switch" | "multiselect" | null;
+/**
+* A valid array of potential value sources.
+*
+* @see {@link ValueSource}
+*/
+type ValueSources = ["value"] | ["value", "field"] | ["field", "value"] | ["field"];
+type ValueSourceFlexibleOptions = ToFlexibleOptionArrays<ValueSources>;
+type ToFlexibleOptionArrays<Sources extends readonly string[]> = Sources extends unknown ? { [K in keyof Sources]: FlexibleOption<Sources[K]> } : never;
+type WithOptionalClassName<T> = T & {
+  className?: Classname;
+};
+/**
+* HTML5 input types
+*/
+type InputType = "button" | "checkbox" | "color" | "date" | "datetime-local" | "email" | "file" | "hidden" | "image" | "month" | "number" | "password" | "radio" | "range" | "reset" | "search" | "submit" | "tel" | "text" | "time" | "url" | "week" | "bigint" | (string & {});
+/**
+* Quantification mode describing how many elements of the value array must pass
+* the filter for the rule itself to pass.
+*
+* For "atLeast", "atMost", and "exactly", the threshold value will be converted to
+* a percentage if the number is less than 1. Non-numeric values and numbers less
+* than 0 will be ignored.
+*/
+interface MatchConfig {
+  mode: MatchMode;
+  threshold?: number | null | undefined;
+}
+type MatchMode = "all" | "some" | "none" | "atLeast" | "atMost" | "exactly";
+/**
+* Base for all Field types/interfaces.
+*/
+interface BaseFullField<FieldName extends string = string, OperatorName extends string = string, ValueName extends string = string, OperatorObj extends FullOption = FullOption<OperatorName>, ValueObj extends FullOption = FullOption<ValueName>> extends WithOptionalClassName<BaseFullOption<FieldName>> {
+  id?: string;
+  operators?: FlexibleOptionList<OperatorObj> | OperatorName[] | FlexibleOption<OperatorName>[] | (OperatorName | FlexibleOption<OperatorName>)[];
+  valueEditorType?: ValueEditorType | ((operator: OperatorName) => ValueEditorType);
+  valueSources?: ValueSources | ValueSourceFlexibleOptions | ((operator: OperatorName) => ValueSources | ValueSourceFlexibleOptions);
+  inputType?: InputType | null;
+  values?: FlexibleOptionList<ValueObj>;
+  matchModes?: boolean | MatchMode[] | FlexibleOption<MatchMode>[];
+  /** Properties of items in the value. */
+  subproperties?: FlexibleOptionList<FullField>;
+  defaultOperator?: OperatorName;
+  defaultValue?: any;
+  placeholder?: string;
+  validator?: RuleValidator;
+  comparator?: string | ((f: FullField, operator: string) => boolean);
+}
+/**
+* Full field definition used in the `fields` prop of {@link QueryBuilder}.
+* This type requires both `name` and `value`, but the `fields` prop itself
+* can use a {@link FlexibleOption} where only one of `name` or `value` is
+* required (along with `label`), or {@link Field} where only `name` and
+* `label` are required.
+*
+* The `name`/`value`, `operators`, and `values` properties of this interface
+* can be narrowed with generics.
+*
+* @group Option Lists
+*/
+type FullField<FieldName extends string = string, OperatorName extends string = string, ValueName extends string = string, OperatorObj extends FullOption = FullOption<OperatorName>, ValueObj extends FullOption = FullOption<ValueName>> = Simplify<FullOption<FieldName> & BaseFullField<FieldName, OperatorName, ValueName, OperatorObj, ValueObj>>;
+/**
+* Allowed values of the {@link FullOperator} property `arity`. A value of `"unary"` or
+* a number less than two will cause the default {@link ValueEditor} to render `null`.
+*/
+type Arity = number | "unary" | "binary" | "ternary";
+/**
+* Full operator definition used in the `operators`/`getOperators` props of
+* {@link QueryBuilder}. This type requires both `name` and `value`, but the
+* `operators`/`getOperators` props themselves can use a {@link FlexibleOption}
+* where only one of `name` or `value` is required, or {@link FullOperator} where
+* only `name` is required.
+*
+* The `name`/`value` properties of this interface can be narrowed with generics.
+*
+* @group Option Lists
+*/
+interface FullOperator<N extends string = string> extends WithOptionalClassName<FullOption<N>> {
+  arity?: Arity;
+}
+type ParseNumberMethodName = "enhanced" | "native" | "strict";
+/**
+* Parsing algorithms used by {@link parseNumber}.
+*/
+
+type ParseNumbersModerationLevel = "-limited" | "";
+/**
+* Options for the `parseNumbers` prop of {@link QueryBuilder}.
+*/
+type ParseNumbersPropConfig = boolean | `${ParseNumberMethodName}${ParseNumbersModerationLevel}`;
+//#endregion
+export { DefaultCombinatorName, DefaultOperatorName, DefaultRuleGroupType, DefaultRuleGroupTypeIC, FlexibleOptionList, FullField, FullOperator, FullOptionList, InputType, OptionList, ParseNumbersPropConfig, QueryValidator, RuleGroupType, RuleGroupTypeAny, RuleGroupTypeIC, RuleType, RuleValidator, ValidationMap, ValidationResult, ValueSource, ValueSources };
+//# sourceMappingURL=basic-BmpEwexQ.d.mts.map