@react-querybuilder/core 8.18.0 → 8.19.0

package/dist/cjs/react-querybuilder_core.cjs.development.d.ts

@@ -2581,6 +2581,10 @@ interface Classnames {
   * Classname(s) applied to async components in their "loading" state.
   */
   loading: Classname;
+  /**
+  * Classname(s) applied to value editors for relative date/time values.
+  */
+  valueDateTimeRelative: Classname;
 }
 /**
 * Placeholder strings for option lists.
@@ -2948,6 +2952,7 @@ declare const standardClassnames: {
   readonly justified: "queryBuilder-justified";
   readonly hasSubQuery: "rule-hasSubQuery";
   readonly loading: "queryBuilder-loading";
+  readonly valueDateTimeRelative: "rule-value-dateTimeRelative";
 };
 /**
 * Default classnames for each component.
@@ -3052,20 +3057,23 @@ declare const splitBy: (str?: string, splitChar?: string) => string[];
 * // would return
 * 'this\\,\\,that, , the other, , , \\,'
 */
-declare const joinWith: (strArr: any[], joinChar?: string) => string;
+declare const joinWith: (strArr: unknown[], joinChar?: string) => string;
+type IsUnknown<T> = unknown extends T ? true : false;
+type Trimmed<T> = IsUnknown<T> extends true ? string : T;
 /**
 * Trims the value if it is a string. Otherwise returns the value as is.
 */
-declare const trimIfString: (val: any) => any;
+declare const trimIfString: <T>(val: T) => Trimmed<T>;
+type ToArrayResult<T> = IsUnknown<T> extends true ? string[] : T extends readonly (infer U)[] ? Trimmed<U>[] : T extends string ? string[] : T extends number ? number[] : never[];
 /**
 * Splits a string by comma then trims each element. Arrays are returned as is except
 * any string elements are trimmed.
 */
-declare const toArray: (a: any, {
+declare const toArray: <T>(a: T, {
   retainEmptyStrings
 }?: {
   retainEmptyStrings?: boolean;
-}) => any[];
+}) => ToArrayResult<T>;
 /**
 * Determines if an array is free of `null`/`undefined`.
 */
@@ -3782,7 +3790,7 @@ declare const numerifyValues: (rg: RuleGroupTypeAny, options: SetRequired<Format
 *
 * @group Export
 */
-declare const isValidValue: (value: any) => boolean;
+declare const isValidValue: (value: unknown) => boolean;
 /**
 * Determines whether {@link formatQuery} should render the given value as a number.
 * As long as `parseNumbers` is `true`, `number` and `bigint` values will return `true` and
@@ -3790,7 +3798,7 @@ declare const isValidValue: (value: any) => boolean;
 *
 * @group Export
 */
-declare const shouldRenderAsNumber: (value: any, parseNumbers?: boolean) => boolean;
+declare const shouldRenderAsNumber: (value: unknown, parseNumbers?: boolean) => boolean;
 /**
 * Used by {@link formatQuery} to determine whether the given value processor is a
 * "legacy" value processor by counting the number of arguments. Legacy value
@@ -4053,7 +4061,7 @@ declare const numericRegex: RegExp;
 /**
 * Determines if a variable is a plain old JavaScript object, aka POJO.
 */
-declare const isPojo: (obj: any) => obj is Record<string, any>;
+declare const isPojo: (obj: unknown) => obj is Record<string, any>;
 /**
 * Simple helper to determine whether a value is null, undefined, or an empty string.
 */
@@ -4134,25 +4142,25 @@ declare const uniqByIdentifier: <T extends RequireAtLeastOne$1<{
 *
 * @group Option Lists
 */
-declare const isOptionGroupArray: (arr: any) => arr is OptionGroup<BaseOption>[];
+declare const isOptionGroupArray: (arr: unknown) => arr is OptionGroup<BaseOption>[];
 /**
 * Determines if an array is a flat array of {@link FlexibleOption}.
 *
 * @group Option Lists
 */
-declare const isFlexibleOptionArray: (arr: any) => arr is FlexibleOption[];
+declare const isFlexibleOptionArray: (arr: unknown) => arr is FlexibleOption[];
 /**
 * Determines if an array is a flat array of {@link FullOption}.
 *
 * @group Option Lists
 */
-declare const isFullOptionArray: (arr: any) => arr is FullOption[];
+declare const isFullOptionArray: (arr: unknown) => arr is FullOption[];
 /**
 * Determines if a {@link FlexibleOptionList} is a {@link FlexibleOptionGroup} array.
 *
 * @group Option Lists
 */
-declare const isFlexibleOptionGroupArray: (arr: any, {
+declare const isFlexibleOptionGroupArray: (arr: unknown, {
   allowEmpty
 }?: {
   allowEmpty?: boolean;
@@ -4162,7 +4170,7 @@ declare const isFlexibleOptionGroupArray: (arr: any, {
 *
 * @group Option Lists
 */
-declare const isFullOptionGroupArray: (arr: any, {
+declare const isFullOptionGroupArray: (arr: unknown, {
   allowEmpty
 }?: {
   allowEmpty?: boolean;
@@ -4237,7 +4245,7 @@ interface ParseNumberOptions {
 * If that returns `NaN`, the string is returned unchanged. Numeric values are returned
 * as-is regardless of the `parseNumbers` option.
 */
-declare const parseNumber: (val: any, {
+declare const parseNumber: (val: unknown, {
   parseNumbers,
   bigIntOnOverflow
 }?: ParseNumberOptions) => any;

package/dist/cjs/react-querybuilder_core.cjs.development.js

@@ -430,7 +430,8 @@ const standardClassnames = {
 	branches: "queryBuilder-branches",
 	justified: "queryBuilder-justified",
 	hasSubQuery: "rule-hasSubQuery",
-	loading: "queryBuilder-loading"
+	loading: "queryBuilder-loading",
+	valueDateTimeRelative: "rule-value-dateTimeRelative"
 };
 /**
 * Default classnames for each component.
@@ -480,7 +481,8 @@ const defaultControlClassnames = {
 	valueListItem: "",
 	branches: "",
 	hasSubQuery: "",
-	loading: ""
+	loading: "",
+	valueDateTimeRelative: ""
 };
 /**
 * Default reason codes for a group being invalid.
@@ -613,7 +615,7 @@ 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 = (a, { retainEmptyStrings } = {}) => Array.isArray(a) ? a.map((v) => trimIfString(v)) : typeof a === "string" ? splitBy(a, ",").filter(retainEmptyStrings ? () => true : (s) => !/^\s*$/.test(s)).map((s) => s.trim()) : typeof a === "number" ? [a] : [];
+const toArray = (a, { retainEmptyStrings } = {}) => Array.isArray(a) ? a.map(trimIfString) : typeof a === "string" ? splitBy(a, ",").filter(retainEmptyStrings ? () => true : (s) => !/^\s*$/.test(s)).map((s) => s.trim()) : typeof a === "number" ? [a] : [];
 /**
 * Determines if an array is free of `null`/`undefined`.
 */
@@ -674,7 +676,7 @@ const numericRegex = new RegExp(numeric_quantity.numericRegex.source.replace(/^\
 /**
 * Determines if a variable is a plain old JavaScript object, aka POJO.
 */
-const isPojo = (obj) => obj === null || typeof obj !== "object" ? false : Object.getPrototypeOf(obj) === Object.prototype;
+const isPojo = (obj) => obj !== null && typeof obj === "object" && Object.getPrototypeOf(obj) === Object.prototype;
 /**
 * Simple helper to determine whether a value is null, undefined, or an empty string.
 */
@@ -2003,106 +2005,6 @@ const defaultRuleGroupProcessorCypher = (ruleGroup, options) => {
 	return processRuleGroup(ruleGroup, true);
 };
 //#endregion
-//#region src/utils/formatQuery/defaultRuleProcessorDrizzle.ts
-/**
-* Default rule processor used by {@link formatQuery} for the "drizzle" format.
-*
-* @group Export
-*/
-const defaultRuleProcessorDrizzle = (rule, _options) => {
-	const opts = _options ?? (	/* v8 ignore start -- @preserve */ {});
-	// v8 ignore next
-	const { parseNumbers, preserveValueOrder, context = {} } = opts;
-	const { columns, drizzleOperators, useRawFields } = context;
-	if (!columns || !drizzleOperators) return void 0;
-	const { between, eq, gt, gte, inArray, isNotNull, isNull, like, lt, lte, ne, notBetween, notInArray, notLike, sql } = drizzleOperators;
-	const { field, operator, value, valueSource } = rule;
-	const column = useRawFields && /^[a-z_][a-z0-9_.]*$/i.test(field) ? sql.raw(field) : columns[field];
-	const operatorLC = lc(operator);
-	const valueIsField = valueSource === "field";
-	const asFieldOrValue = (v) => valueIsField ? columns[v] : v;
-	const maybeParseNumber = (v) => {
-		if (valueIsField || !parseNumbers) return asFieldOrValue(v);
-		return shouldRenderAsNumber(v, true) ? parseNumber(v, { parseNumbers: true }) : v;
-	};
-	if (!column) return void 0;
-	const matchEval = processMatchMode(rule);
-	if (matchEval === false) return;
-	else if (matchEval) {
-		if (opts.preset !== "postgresql") return void 0;
-		const { mode, threshold } = matchEval;
-		const arrayElementAlias = "elem_alias";
-		const nestedArrayFilter = defaultRuleGroupProcessorDrizzle(transformQuery(rule.value, { ruleProcessor: (r) => ({
-			...r,
-			field: arrayElementAlias
-		}) }), {
-			...opts,
-			context: {
-				...opts.context,
-				useRawFields: true
-			}
-		});
-		switch (mode) {
-			case "all": return sql`(select count(*) from unnest(${column}) as ${sql.raw(arrayElementAlias)} where ${nestedArrayFilter({}, drizzleOperators)}) = array_length(${column}, 1)`;
-			case "none": return sql`not exists (select 1 from unnest(${column}) as ${sql.raw(arrayElementAlias)} where ${nestedArrayFilter({}, drizzleOperators)})`;
-			case "some": return sql`exists (select 1 from unnest(${column}) as ${sql.raw(arrayElementAlias)} where ${nestedArrayFilter({}, drizzleOperators)})`;
-			case "atleast":
-			case "atmost":
-			case "exactly": {
-				const op = mode === "atleast" ? ">=" : mode === "atmost" ? "<=" : "=";
-				return threshold > 0 && threshold < 1 ? sql`(select count(*)::float / array_length(${column}, 1) from unnest(${column}) as ${sql.raw(arrayElementAlias)} where ${nestedArrayFilter({}, drizzleOperators)}) ${sql.raw(`${op} ${threshold}`)}` : sql`(select count(*) from unnest(${column}) as ${sql.raw(arrayElementAlias)} where ${nestedArrayFilter({}, drizzleOperators)}) ${sql.raw(`${op} ${threshold}`)}`;
-			}
-		}
-	}
-	switch (operatorLC) {
-		case "=": return eq(column, maybeParseNumber(value));
-		case "!=": return ne(column, maybeParseNumber(value));
-		case ">": return gt(column, maybeParseNumber(value));
-		case "<": return lt(column, maybeParseNumber(value));
-		case ">=": return gte(column, maybeParseNumber(value));
-		case "<=": return lte(column, maybeParseNumber(value));
-		case "beginswith":
-		case "doesnotbeginwith": return (operatorLC === "doesnotbeginwith" ? notLike : like)(column, valueIsField ? sql`${asFieldOrValue(value)} || '%'` : `${value}%`);
-		case "contains":
-		case "doesnotcontain": return (operatorLC === "doesnotcontain" ? notLike : like)(column, valueIsField ? sql`'%' || ${asFieldOrValue(value)} || '%'` : `%${value}%`);
-		case "endswith":
-		case "doesnotendwith": return (operatorLC === "doesnotendwith" ? notLike : like)(column, valueIsField ? sql`'%' || ${asFieldOrValue(value)}` : `%${value}`);
-		case "null": return isNull(column);
-		case "notnull": return isNotNull(column);
-		case "in":
-		case "notin": {
-			const valueAsArray = toArray(value).map((v) => maybeParseNumber(v));
-			return operatorLC === "notin" ? notInArray(column, valueAsArray) : inArray(column, valueAsArray);
-		}
-		case "between":
-		case "notbetween": {
-			const valueAsArray = toArray(value);
-			if (valueAsArray.length >= 2 && isValidValue(valueAsArray[0]) && isValidValue(valueAsArray[1])) {
-				let [first, second] = valueAsArray;
-				const shouldParseNumbers = !(parseNumbers === false);
-				if (!valueIsField && shouldRenderAsNumber(first, shouldParseNumbers) && shouldRenderAsNumber(second, shouldParseNumbers)) {
-					const firstNum = parseNumber(first, { parseNumbers: shouldParseNumbers });
-					const secondNum = parseNumber(second, { parseNumbers: shouldParseNumbers });
-					if (!preserveValueOrder && secondNum < firstNum) {
-						const tempNum = secondNum;
-						second = firstNum;
-						first = tempNum;
-					} else {
-						first = firstNum;
-						second = secondNum;
-					}
-				} else if (valueIsField) {
-					first = asFieldOrValue(first);
-					second = asFieldOrValue(second);
-				}
-				return operatorLC === "notbetween" ? notBetween(column, first, second) : between(column, first, second);
-			}
-			return;
-		}
-		default: return;
-	}
-};
-//#endregion
 //#region src/utils/formatQuery/defaultRuleGroupProcessorDrizzle.ts
 /**
 * Default rule group processor used by {@link formatQuery} for the "drizzle" format. The returned
@@ -2117,10 +2019,9 @@ const defaultRuleProcessorDrizzle = (rule, _options) => {
 * @group Export
 */
 const defaultRuleGroupProcessorDrizzle = (ruleGroup, options, _meta) => (columns, drizzleOperators) => {
-	const { fields, getParseNumberBoolean, placeholderFieldName, placeholderOperatorName, placeholderValueName, validateRule, validationMap } = options;
+	const { fields, getParseNumberBoolean, placeholderFieldName, placeholderOperatorName, placeholderValueName, validateRule, validationMap, ruleProcessor } = options;
 	if (!columns || !drizzleOperators) return void 0;
 	const { and, not, or } = drizzleOperators;
-	const ruleProcessor = defaultRuleProcessorDrizzle;
 	const processRuleGroup = (rg, _outermost) => {
 		if (!isRuleOrGroupValid(rg, validationMap[rg.id ?? ""])) return;
 		const processedRules = rg.rules.map((rule) => {
@@ -2736,96 +2637,6 @@ const defaultRuleGroupProcessorSQL = (ruleGroup, options) => {
 	return processRuleGroup(ruleGroup, true);
 };
 //#endregion
-//#region src/utils/formatQuery/defaultRuleProcessorTanStackDB.ts
-/**
-* Default rule processor used by {@link formatQuery} for the "tanstack_db" format.
-*
-* @group Export
-*/
-const defaultRuleProcessorTanStackDB = (rule, _options) => {
-	const { parseNumbers, preserveValueOrder, context = {} } = _options ?? (	/* v8 ignore start -- @preserve */ {});
-	const ops = context.tanStackDbOperators;
-	const refs = context._tanstackDbRefs;
-	const primaryRef = context._tanstackDbPrimaryRef;
-	if (!ops || !refs || !primaryRef) return void 0;
-	const { and, eq, gt, gte, inArray, isNull, like, lt, lte, not } = ops;
-	const resolveField = (fieldName) => {
-		const dotIdx = fieldName.indexOf(".");
-		if (dotIdx > 0) {
-			const prefix = fieldName.slice(0, dotIdx);
-			const rest = fieldName.slice(dotIdx + 1);
-			if (refs[prefix]) return refs[prefix][rest];
-		}
-		return refs[primaryRef][fieldName];
-	};
-	const { field, operator, value, valueSource } = rule;
-	const column = resolveField(field);
-	const operatorLC = lc(operator);
-	const valueIsField = valueSource === "field";
-	const asFieldOrValue = (v) => valueIsField ? resolveField(v) : v;
-	const maybeParseNumber = (v) => {
-		if (valueIsField || !parseNumbers) return asFieldOrValue(v);
-		return shouldRenderAsNumber(v, true) ? parseNumber(v, { parseNumbers: true }) : v;
-	};
-	switch (operatorLC) {
-		case "=": return eq(column, maybeParseNumber(value));
-		case "!=": return not(eq(column, maybeParseNumber(value)));
-		case ">": return gt(column, maybeParseNumber(value));
-		case "<": return lt(column, maybeParseNumber(value));
-		case ">=": return gte(column, maybeParseNumber(value));
-		case "<=": return lte(column, maybeParseNumber(value));
-		case "beginswith":
-		case "doesnotbeginwith": {
-			const expr = like(column, valueIsField ? void 0 : `${value}%`);
-			return operatorLC === "doesnotbeginwith" ? not(expr) : expr;
-		}
-		case "contains":
-		case "doesnotcontain": {
-			const expr = like(column, valueIsField ? void 0 : `%${value}%`);
-			return operatorLC === "doesnotcontain" ? not(expr) : expr;
-		}
-		case "endswith":
-		case "doesnotendwith": {
-			const expr = like(column, valueIsField ? void 0 : `%${value}`);
-			return operatorLC === "doesnotendwith" ? not(expr) : expr;
-		}
-		case "null": return isNull(column);
-		case "notnull": return not(isNull(column));
-		case "in":
-		case "notin": {
-			const expr = inArray(column, toArray(value).map((v) => maybeParseNumber(v)));
-			return operatorLC === "notin" ? not(expr) : expr;
-		}
-		case "between":
-		case "notbetween": {
-			const valueAsArray = toArray(value);
-			if (valueAsArray.length >= 2 && isValidValue(valueAsArray[0]) && isValidValue(valueAsArray[1])) {
-				let [first, second] = valueAsArray;
-				const shouldParseNumbers = !(parseNumbers === false);
-				if (!valueIsField && shouldRenderAsNumber(first, shouldParseNumbers) && shouldRenderAsNumber(second, shouldParseNumbers)) {
-					const firstNum = parseNumber(first, { parseNumbers: shouldParseNumbers });
-					const secondNum = parseNumber(second, { parseNumbers: shouldParseNumbers });
-					if (!preserveValueOrder && secondNum < firstNum) {
-						const tempNum = secondNum;
-						second = firstNum;
-						first = tempNum;
-					} else {
-						first = firstNum;
-						second = secondNum;
-					}
-				} else if (valueIsField) {
-					first = asFieldOrValue(first);
-					second = asFieldOrValue(second);
-				}
-				const expr = and(gte(column, first), lte(column, second));
-				return operatorLC === "notbetween" ? not(expr) : expr;
-			}
-			return;
-		}
-		default: return;
-	}
-};
-//#endregion
 //#region src/utils/formatQuery/defaultRuleGroupProcessorTanStackDB.ts
 /**
 * Default rule group processor used by {@link formatQuery} for the "tanstack_db" format.
@@ -2838,7 +2649,7 @@ const defaultRuleProcessorTanStackDB = (rule, _options) => {
 * @group Export
 */
 const defaultRuleGroupProcessorTanStackDB = (ruleGroup, options) => (refs) => {
-	const { fields, getParseNumberBoolean, placeholderFieldName, placeholderOperatorName, placeholderValueName, validateRule, validationMap, context = {} } = options;
+	const { fields, getParseNumberBoolean, placeholderFieldName, placeholderOperatorName, placeholderValueName, validateRule, validationMap, context = {}, ruleProcessor } = options;
 	const ops = context.tanStackDbOperators;
 	if (!ops) return void 0;
 	const { and, eq, not, or } = ops;
@@ -2846,7 +2657,6 @@ const defaultRuleGroupProcessorTanStackDB = (ruleGroup, options) => (refs) => {
 	const refKeys = Object.keys(refs);
 	/* v8 ignore next -- @preserve */
 	if (refKeys.length === 0) return fallback;
-	const ruleProcessor = defaultRuleProcessorTanStackDB;
 	const processRuleGroup = (rg) => {
 		if (!isRuleOrGroupValid(rg, validationMap[rg.id ?? ""])) return;
 		const processedRules = rg.rules.map((rule) => {
@@ -3244,6 +3054,106 @@ const defaultRuleProcessorCypher = (rule, opts = {}) => {
 	}
 };
 //#endregion
+//#region src/utils/formatQuery/defaultRuleProcessorDrizzle.ts
+/**
+* Default rule processor used by {@link formatQuery} for the "drizzle" format.
+*
+* @group Export
+*/
+const defaultRuleProcessorDrizzle = (rule, _options) => {
+	const opts = _options ?? (	/* v8 ignore start -- @preserve */ {});
+	// v8 ignore next
+	const { parseNumbers, preserveValueOrder, context = {} } = opts;
+	const { columns, drizzleOperators, useRawFields } = context;
+	if (!columns || !drizzleOperators) return void 0;
+	const { between, eq, gt, gte, inArray, isNotNull, isNull, like, lt, lte, ne, notBetween, notInArray, notLike, sql } = drizzleOperators;
+	const { field, operator, value, valueSource } = rule;
+	const column = useRawFields && /^[a-z_][a-z0-9_.]*$/i.test(field) ? sql.raw(field) : columns[field];
+	const operatorLC = lc(operator);
+	const valueIsField = valueSource === "field";
+	const asFieldOrValue = (v) => valueIsField ? columns[v] : v;
+	const maybeParseNumber = (v) => {
+		if (valueIsField || !parseNumbers) return asFieldOrValue(v);
+		return shouldRenderAsNumber(v, true) ? parseNumber(v, { parseNumbers: true }) : v;
+	};
+	if (!column) return void 0;
+	const matchEval = processMatchMode(rule);
+	if (matchEval === false) return;
+	else if (matchEval) {
+		if (opts.preset !== "postgresql") return void 0;
+		const { mode, threshold } = matchEval;
+		const arrayElementAlias = "elem_alias";
+		const nestedArrayFilter = defaultRuleGroupProcessorDrizzle(transformQuery(rule.value, { ruleProcessor: (r) => ({
+			...r,
+			field: arrayElementAlias
+		}) }), {
+			...opts,
+			context: {
+				...opts.context,
+				useRawFields: true
+			}
+		});
+		switch (mode) {
+			case "all": return sql`(select count(*) from unnest(${column}) as ${sql.raw(arrayElementAlias)} where ${nestedArrayFilter({}, drizzleOperators)}) = array_length(${column}, 1)`;
+			case "none": return sql`not exists (select 1 from unnest(${column}) as ${sql.raw(arrayElementAlias)} where ${nestedArrayFilter({}, drizzleOperators)})`;
+			case "some": return sql`exists (select 1 from unnest(${column}) as ${sql.raw(arrayElementAlias)} where ${nestedArrayFilter({}, drizzleOperators)})`;
+			case "atleast":
+			case "atmost":
+			case "exactly": {
+				const op = mode === "atleast" ? ">=" : mode === "atmost" ? "<=" : "=";
+				return threshold > 0 && threshold < 1 ? sql`(select count(*)::float / array_length(${column}, 1) from unnest(${column}) as ${sql.raw(arrayElementAlias)} where ${nestedArrayFilter({}, drizzleOperators)}) ${sql.raw(`${op} ${threshold}`)}` : sql`(select count(*) from unnest(${column}) as ${sql.raw(arrayElementAlias)} where ${nestedArrayFilter({}, drizzleOperators)}) ${sql.raw(`${op} ${threshold}`)}`;
+			}
+		}
+	}
+	switch (operatorLC) {
+		case "=": return eq(column, maybeParseNumber(value));
+		case "!=": return ne(column, maybeParseNumber(value));
+		case ">": return gt(column, maybeParseNumber(value));
+		case "<": return lt(column, maybeParseNumber(value));
+		case ">=": return gte(column, maybeParseNumber(value));
+		case "<=": return lte(column, maybeParseNumber(value));
+		case "beginswith":
+		case "doesnotbeginwith": return (operatorLC === "doesnotbeginwith" ? notLike : like)(column, valueIsField ? sql`${asFieldOrValue(value)} || '%'` : `${value}%`);
+		case "contains":
+		case "doesnotcontain": return (operatorLC === "doesnotcontain" ? notLike : like)(column, valueIsField ? sql`'%' || ${asFieldOrValue(value)} || '%'` : `%${value}%`);
+		case "endswith":
+		case "doesnotendwith": return (operatorLC === "doesnotendwith" ? notLike : like)(column, valueIsField ? sql`'%' || ${asFieldOrValue(value)}` : `%${value}`);
+		case "null": return isNull(column);
+		case "notnull": return isNotNull(column);
+		case "in":
+		case "notin": {
+			const valueAsArray = toArray(value).map((v) => maybeParseNumber(v));
+			return operatorLC === "notin" ? notInArray(column, valueAsArray) : inArray(column, valueAsArray);
+		}
+		case "between":
+		case "notbetween": {
+			const valueAsArray = toArray(value);
+			if (valueAsArray.length >= 2 && isValidValue(valueAsArray[0]) && isValidValue(valueAsArray[1])) {
+				let [first, second] = valueAsArray;
+				const shouldParseNumbers = !(parseNumbers === false);
+				if (!valueIsField && shouldRenderAsNumber(first, shouldParseNumbers) && shouldRenderAsNumber(second, shouldParseNumbers)) {
+					const firstNum = parseNumber(first, { parseNumbers: shouldParseNumbers });
+					const secondNum = parseNumber(second, { parseNumbers: shouldParseNumbers });
+					if (!preserveValueOrder && secondNum < firstNum) {
+						const tempNum = secondNum;
+						second = firstNum;
+						first = tempNum;
+					} else {
+						first = firstNum;
+						second = secondNum;
+					}
+				} else if (valueIsField) {
+					first = asFieldOrValue(first);
+					second = asFieldOrValue(second);
+				}
+				return operatorLC === "notbetween" ? notBetween(column, first, second) : between(column, first, second);
+			}
+			return;
+		}
+		default: return;
+	}
+};
+//#endregion
 //#region src/utils/formatQuery/defaultRuleProcessorElasticSearch.ts
 const rangeOperatorMap = {
 	"<": "lt",
@@ -4213,6 +4123,96 @@ const defaultRuleProcessorSPARQL = (rule, opts = {}) => {
 	}
 };
 //#endregion
+//#region src/utils/formatQuery/defaultRuleProcessorTanStackDB.ts
+/**
+* Default rule processor used by {@link formatQuery} for the "tanstack_db" format.
+*
+* @group Export
+*/
+const defaultRuleProcessorTanStackDB = (rule, _options) => {
+	const { parseNumbers, preserveValueOrder, context = {} } = _options ?? (	/* v8 ignore start -- @preserve */ {});
+	const ops = context.tanStackDbOperators;
+	const refs = context._tanstackDbRefs;
+	const primaryRef = context._tanstackDbPrimaryRef;
+	if (!ops || !refs || !primaryRef) return void 0;
+	const { and, eq, gt, gte, inArray, isNull, like, lt, lte, not } = ops;
+	const resolveField = (fieldName) => {
+		const dotIdx = fieldName.indexOf(".");
+		if (dotIdx > 0) {
+			const prefix = fieldName.slice(0, dotIdx);
+			const rest = fieldName.slice(dotIdx + 1);
+			if (refs[prefix]) return refs[prefix][rest];
+		}
+		return refs[primaryRef][fieldName];
+	};
+	const { field, operator, value, valueSource } = rule;
+	const column = resolveField(field);
+	const operatorLC = lc(operator);
+	const valueIsField = valueSource === "field";
+	const asFieldOrValue = (v) => valueIsField ? resolveField(v) : v;
+	const maybeParseNumber = (v) => {
+		if (valueIsField || !parseNumbers) return asFieldOrValue(v);
+		return shouldRenderAsNumber(v, true) ? parseNumber(v, { parseNumbers: true }) : v;
+	};
+	switch (operatorLC) {
+		case "=": return eq(column, maybeParseNumber(value));
+		case "!=": return not(eq(column, maybeParseNumber(value)));
+		case ">": return gt(column, maybeParseNumber(value));
+		case "<": return lt(column, maybeParseNumber(value));
+		case ">=": return gte(column, maybeParseNumber(value));
+		case "<=": return lte(column, maybeParseNumber(value));
+		case "beginswith":
+		case "doesnotbeginwith": {
+			const expr = like(column, valueIsField ? void 0 : `${value}%`);
+			return operatorLC === "doesnotbeginwith" ? not(expr) : expr;
+		}
+		case "contains":
+		case "doesnotcontain": {
+			const expr = like(column, valueIsField ? void 0 : `%${value}%`);
+			return operatorLC === "doesnotcontain" ? not(expr) : expr;
+		}
+		case "endswith":
+		case "doesnotendwith": {
+			const expr = like(column, valueIsField ? void 0 : `%${value}`);
+			return operatorLC === "doesnotendwith" ? not(expr) : expr;
+		}
+		case "null": return isNull(column);
+		case "notnull": return not(isNull(column));
+		case "in":
+		case "notin": {
+			const expr = inArray(column, toArray(value).map((v) => maybeParseNumber(v)));
+			return operatorLC === "notin" ? not(expr) : expr;
+		}
+		case "between":
+		case "notbetween": {
+			const valueAsArray = toArray(value);
+			if (valueAsArray.length >= 2 && isValidValue(valueAsArray[0]) && isValidValue(valueAsArray[1])) {
+				let [first, second] = valueAsArray;
+				const shouldParseNumbers = !(parseNumbers === false);
+				if (!valueIsField && shouldRenderAsNumber(first, shouldParseNumbers) && shouldRenderAsNumber(second, shouldParseNumbers)) {
+					const firstNum = parseNumber(first, { parseNumbers: shouldParseNumbers });
+					const secondNum = parseNumber(second, { parseNumbers: shouldParseNumbers });
+					if (!preserveValueOrder && secondNum < firstNum) {
+						const tempNum = secondNum;
+						second = firstNum;
+						first = tempNum;
+					} else {
+						first = firstNum;
+						second = secondNum;
+					}
+				} else if (valueIsField) {
+					first = asFieldOrValue(first);
+					second = asFieldOrValue(second);
+				}
+				const expr = and(gte(column, first), lte(column, second));
+				return operatorLC === "notbetween" ? not(expr) : expr;
+			}
+			return;
+		}
+		default: return;
+	}
+};
+//#endregion
 //#region src/utils/formatQuery/formatQuery.ts
 /**
 * A collection of option presets for {@link formatQuery}, specifically for SQL-based formats.
@@ -4778,7 +4778,8 @@ const mergeClassnames = (...args) => ({
 	matchThreshold: joinClassnamesByName("matchThreshold", args),
 	branches: joinClassnamesByName("branches", args),
 	hasSubQuery: joinClassnamesByName("hasSubQuery", args),
-	loading: joinClassnamesByName("loading", args)
+	loading: joinClassnamesByName("loading", args),
+	valueDateTimeRelative: joinClassnamesByName("valueDateTimeRelative", args)
 });
 //#endregion
 //#region src/utils/preferProp.ts