@react-querybuilder/core 8.16.0 → 8.16.2

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

@@ -1,6 +1,7 @@
 import { JsonLogicAll, JsonLogicAnd, JsonLogicDoubleNegation, JsonLogicEqual, JsonLogicGreaterThan, JsonLogicGreaterThanOrEqual, JsonLogicInArray, JsonLogicInString, JsonLogicLessThan, JsonLogicLessThanOrEqual, JsonLogicNegation, JsonLogicNone, JsonLogicNotEqual, JsonLogicOr, JsonLogicSome, JsonLogicStrictEqual, JsonLogicStrictNotEqual, JsonLogicVar, ReservedOperations as JsonLogicReservedOperations, RulesLogic, RulesLogic as JsonLogicRulesLogic } from "json-logic-js";
 import { Column, Operators, SQL, Table } from "drizzle-orm";
 import { WhereOptions } from "sequelize";
+import { eq } from "@tanstack/db";
 
 //#region ../../node_modules/type-fest/source/primitive.d.ts
 /**
@@ -1748,7 +1749,7 @@ 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" | "cypher" | "gql" | "sparql" | "gremlin" | "diagnostics";
+type ExportFormat = "json" | "sql" | "json_without_ids" | "parameterized" | "parameterized_named" | "mongodb" | "mongodb_query" | "cel" | "jsonlogic" | "spel" | "elasticsearch" | "jsonata" | "natural_language" | "ldap" | "drizzle" | "tanstack_db" | "prisma" | "sequelize" | "cypher" | "gql" | "sparql" | "gremlin" | "diagnostics";
 /**
 * Export formats for {@link formatQuery} that produce objects instead of strings.
 *
@@ -2334,7 +2335,7 @@ type GroupVariantCondition = "not" | "xor";
 *
 * @group Export
 */
-type NLTranslationKey = "and" | "or" | "true" | "false" | `groupPrefix${ZeroOrMoreGroupVariants}` | `groupSuffix${ZeroOrMoreGroupVariants}`;
+type NLTranslationKey = "and" | "or" | "true" | "false" | "ruleSeparator" | "betweenAnd" | "afterSubject" | "afterVerb" | "afterObject" | "listSeparator" | `groupPrefix${ZeroOrMoreGroupVariants}` | `groupSuffix${ZeroOrMoreGroupVariants}`;
 /**
 * `translations` config object for "natural_language" format.
 *
@@ -3303,6 +3304,23 @@ declare const defaultRuleGroupProcessorSpEL: RuleGroupProcessor<string>;
 */
 declare const defaultRuleGroupProcessorSQL: RuleGroupProcessor<string>;
 //#endregion
+//#region src/utils/formatQuery/tanStackDbTypes.d.ts
+type TanStackDbWhereCallbackReturnType = ReturnType<typeof eq>;
+type TanStackDbWhereCallback = (refs: Record<string, unknown>) => TanStackDbWhereCallbackReturnType;
+//#endregion
+//#region src/utils/formatQuery/defaultRuleGroupProcessorTanStackDB.d.ts
+/**
+* Default rule group processor used by {@link formatQuery} for the "tanstack_db" format.
+* Returns a `WhereCallback` suitable for TanStack DB's `.where()` method.
+*
+* @example
+* const where = formatQuery(query, { format: 'tanstack_db', context: { tanstackDb: tsdb } });
+* const results = useLiveQuery(q => q.from({ todo: todosCollection }).where(where));
+*
+* @group Export
+*/
+declare const defaultRuleGroupProcessorTanStackDB: RuleGroupProcessor<TanStackDbWhereCallback>;
+//#endregion
 //#region src/utils/formatQuery/defaultRuleGroupProcessorDiagnostics.d.ts
 /**
 * Rule group processor used by {@link formatQuery} for "diagnostics" format.
@@ -3428,6 +3446,11 @@ declare const defaultRuleProcessorPrisma: RuleProcessor;
 declare const defaultRuleProcessorSequelize: RuleProcessor;
 //#endregion
 //#region src/utils/formatQuery/defaultRuleProcessorSPARQL.d.ts
+/** Auto-prefix a SPARQL variable name with `?` unless it's already prefixed, a URI, or a prefixed name.
+*
+* @group Export
+*/
+declare const sparqlVar: (name: string) => string;
 /**
 * Default rule processor used by {@link formatQuery} for "sparql" format.
 *
@@ -3449,6 +3472,14 @@ declare const defaultOperatorProcessorSQL: RuleProcessor;
 */
 declare const defaultRuleProcessorSQL: RuleProcessor;
 //#endregion
+//#region src/utils/formatQuery/defaultRuleProcessorTanStackDB.d.ts
+/**
+* Default rule processor used by {@link formatQuery} for the "tanstack_db" format.
+*
+* @group Export
+*/
+declare const defaultRuleProcessorTanStackDB: RuleProcessor;
+//#endregion
 //#region src/utils/formatQuery/defaultValueProcessorNL.d.ts
 /**
 * Default value processor used by {@link formatQuery} for "natural_language" format.
@@ -3562,7 +3593,15 @@ declare function formatQuery(ruleGroup: RuleGroupTypeAny, options: "drizzle" | (
   format: "drizzle";
 })): ReturnType<typeof defaultRuleGroupProcessorDrizzle>;
 /**
-* Generates a Sequelize query object from an RQB query object. The object can
+* Generates a TanStack DB WhereCallback from an RQB query object. The callback can
+* be passed directly to TanStack DB's `.where()` method.
+*
+* @group Export
+*/
+declare function formatQuery(ruleGroup: RuleGroupTypeAny, options: "tanstack_db" | (FormatQueryOptions & {
+  format: "tanstack_db";
+})): ReturnType<typeof defaultRuleGroupProcessorTanStackDB>;
+/**
 * be assigned to the `where` property in the Sequelize query functions.
 *
 * @group Export
@@ -4634,5 +4673,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, 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 };
+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, defaultRuleGroupProcessorTanStackDB, defaultRuleProcessorCEL, defaultRuleProcessorCypher, defaultRuleProcessorDrizzle, defaultRuleProcessorElasticSearch, defaultRuleProcessorGremlin, defaultRuleProcessorJSONata, defaultRuleProcessorJsonLogic, defaultRuleProcessorLDAP, defaultRuleProcessorMongoDB, defaultRuleProcessorMongoDBQuery, defaultRuleProcessorNL, defaultRuleProcessorParameterized, defaultRuleProcessorPrisma, defaultRuleProcessorSPARQL, defaultRuleProcessorSQL, defaultRuleProcessorSequelize, defaultRuleProcessorSpEL, defaultRuleProcessorTanStackDB, 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, sparqlVar, splitBy, sqlDialectPresets, standardClassnames, toArray, toFlatOptionArray, toFullOption, toFullOptionList, toFullOptionMap, transformQuery, trimIfString, uniqByIdentifier, uniqByName, uniqOptGroups, uniqOptList, update, updateInPlace, uuidV4regex };
 //# sourceMappingURL=react-querybuilder_core.cjs.development.d.ts.map

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

@@ -1923,7 +1923,7 @@ const defaultValueProcessorByRule = ({ operator, value, valueSource }, { escapeQ
 				valsOneAndTwoOnly[0] = secondNum;
 				valsOneAndTwoOnly[1] = firstNum;
 			}
-			return (valueIsField ? valsOneAndTwoOnly.map((v) => wrapFieldName(v)) : valsOneAndTwoOnly.every((v) => shouldRenderAsNumber(v, parseNumbers)) ? valsOneAndTwoOnly.map((v) => parseNumber(v, { parseNumbers: "strict" })) : valsOneAndTwoOnly.map((v) => wrapAndEscape(v))).join(` ${translations?.and ?? "and"} `);
+			return (valueIsField ? valsOneAndTwoOnly.map((v) => wrapFieldName(v)) : valsOneAndTwoOnly.every((v) => shouldRenderAsNumber(v, parseNumbers)) ? valsOneAndTwoOnly.map((v) => parseNumber(v, { parseNumbers: "strict" })) : valsOneAndTwoOnly.map((v) => wrapAndEscape(v))).join(` ${translations?.betweenAnd ?? translations?.and ?? "and"} `);
 		}
 		case "contains":
 		case "doesnotcontain": return valueIsField ? concat(quoteValue("%"), wrapFieldName(value), quoteValue("%")) : quoteValue(`%${escapeValue(value)}%`);
@@ -2018,6 +2018,10 @@ const defaultRuleProcessorDrizzle = (rule, _options) => {
 	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;
@@ -2048,12 +2052,12 @@ const defaultRuleProcessorDrizzle = (rule, _options) => {
 		}
 	}
 	switch (operatorLC) {
-		case "=": return eq(column, asFieldOrValue(value));
-		case "!=": return ne(column, asFieldOrValue(value));
-		case ">": return gt(column, asFieldOrValue(value));
-		case "<": return lt(column, asFieldOrValue(value));
-		case ">=": return gte(column, asFieldOrValue(value));
-		case "<=": return lte(column, asFieldOrValue(value));
+		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":
@@ -2064,7 +2068,7 @@ const defaultRuleProcessorDrizzle = (rule, _options) => {
 		case "notnull": return isNotNull(column);
 		case "in":
 		case "notin": {
-			const valueAsArray = toArray(value).map((v) => asFieldOrValue(v));
+			const valueAsArray = toArray(value).map((v) => maybeParseNumber(v));
 			return operatorLC === "notin" ? notInArray(column, valueAsArray) : inArray(column, valueAsArray);
 		}
 		case "between":
@@ -2398,7 +2402,7 @@ const defaultRuleGroupProcessorNL = (ruleGroup, options) => {
 		let firstRule = true;
 		for (const rule of rg2.rules) {
 			if (typeof rule === "string") {
-				precedingCombinator = `, ${translations[rule] ?? rule} `;
+				precedingCombinator = `${translations.ruleSeparator ?? ", "}${translations[rule] ?? rule} `;
 				continue;
 			}
 			if (isRuleGroup(rule)) {
@@ -2440,7 +2444,8 @@ const defaultRuleGroupProcessorNL = (ruleGroup, options) => {
 		const [prefixTL, suffixTL] = ["groupPrefix", "groupSuffix"].map((key) => rg2.not ? isXOR ? getNLTranslataion(key, translations, ["not", "xor"]) : getNLTranslataion(key, translations, ["not"]) : isXOR ? getNLTranslataion(key, translations, ["xor"]) : getNLTranslataion(key, translations));
 		const prefix = mustWrap ? `${prefixTL} (`.trim() : "";
 		const suffix = mustWrap ? `) ${suffixTL}`.trim() : "";
-		return `${prefix}${processedRules.join(isRuleGroupType(rg2) ? `, ${translations[combinator] ?? combinator} ` : "")}${suffix}`;
+		const sep = translations.ruleSeparator ?? ", ";
+		return `${prefix}${processedRules.join(isRuleGroupType(rg2) ? `${sep}${translations[combinator] ?? combinator} ` : "")}${suffix}`;
 	};
 	return processRuleGroup(ruleGroup, true);
 };
@@ -2728,6 +2733,142 @@ 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.
+* Returns a `WhereCallback` suitable for TanStack DB's `.where()` method.
+*
+* @example
+* const where = formatQuery(query, { format: 'tanstack_db', context: { tanstackDb: tsdb } });
+* const results = useLiveQuery(q => q.from({ todo: todosCollection }).where(where));
+*
+* @group Export
+*/
+const defaultRuleGroupProcessorTanStackDB = (ruleGroup, options) => (refs) => {
+	const { fields, getParseNumberBoolean, placeholderFieldName, placeholderOperatorName, placeholderValueName, validateRule, validationMap, context = {} } = options;
+	const ops = context.tanStackDbOperators;
+	if (!ops) return void 0;
+	const { and, eq, not, or } = ops;
+	const fallback = eq(1, 1);
+	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) => {
+			if (isRuleGroup(rule)) return processRuleGroup(rule);
+			const [validationResult, fieldValidator] = validateRule(rule);
+			if (!isRuleOrGroupValid(rule, validationResult, fieldValidator) || rule.field === placeholderFieldName || rule.operator === placeholderOperatorName || placeholderValueName !== void 0 && rule.value === placeholderValueName) return;
+			const fieldData = getOption(fields, rule.field);
+			return ruleProcessor(rule, {
+				...options,
+				parseNumbers: getParseNumberBoolean(fieldData?.inputType),
+				fieldData,
+				context: {
+					...context,
+					_tanstackDbRefs: refs,
+					_tanstackDbPrimaryRef: refKeys[0]
+				}
+			});
+		}).filter(Boolean);
+		if (processedRules.length === 0) return fallback;
+		const ruleGroupExpr = processedRules.length === 1 ? processedRules[0] : rg.combinator === "or" ? or(...processedRules) : and(...processedRules);
+		return rg.not ? not(ruleGroupExpr) : ruleGroupExpr;
+	};
+	return processRuleGroup(convertFromIC(ruleGroup)) ?? fallback;
+};
+//#endregion
 //#region src/utils/formatQuery/defaultRuleGroupProcessorDiagnostics.ts
 const numericInputTypes = new Set([
 	"number",
@@ -3567,6 +3708,8 @@ const defaultValueProcessorNL = (rule, opts = {}) => {
 	const orTL = t.or ?? "or";
 	const trueTL = t.true ?? "true";
 	const falseTL = t.false ?? "false";
+	const listSep = t.listSeparator ?? ", ";
+	const useOxfordComma = !t.listSeparator;
 	switch (operatorLowerCase) {
 		case "null":
 		case "notnull": return "";
@@ -3586,7 +3729,8 @@ const defaultValueProcessorNL = (rule, opts = {}) => {
 			if (valueAsArray.length === 0) return "";
 			const valStringArray = valueAsArray.map((v) => valueIsField ? wrapFieldName(getOption(fields ?? [], v)?.label ?? v) : shouldRenderAsNumber(v, parseNumbers) ? `${trimIfString(v)}` : `${wrapAndEscape(v)}`);
 			if (valStringArray.length === 1) return valStringArray[0];
-			return `(${`${valStringArray.slice(0, -1).join(", ")}${valStringArray.length > 2 ? "," : ""} ${orTL} ${valStringArray.at(-1)}`})`;
+			const oxfordComma = useOxfordComma && valStringArray.length > 2 ? "," : "";
+			return `(${`${valStringArray.slice(0, -1).join(listSep)}${oxfordComma} ${orTL} ${valStringArray.at(-1)}`})`;
 		}
 	}
 	if (typeof rule.value === "boolean") return rule.value ? trueTL : falseTL;
@@ -3699,7 +3843,14 @@ const defaultRuleProcessorNL = (rule, opts) => {
 		V: operatorProcessor(rule, opts),
 		O: value
 	};
-	return normalizeConstituentWordOrder(wordOrder).map((term) => `${wordOrderMap[term]}`).join(" ").trim();
+	const translations = opts?.translations ?? {};
+	const suffixMap = {
+		S: translations.afterSubject ?? " ",
+		V: translations.afterVerb ?? " ",
+		O: translations.afterObject ?? " "
+	};
+	const wordOrderTuple = normalizeConstituentWordOrder(wordOrder).filter((term) => wordOrderMap[term] !== "");
+	return wordOrderTuple.map((term, i) => `${wordOrderMap[term]}${i < wordOrderTuple.length - 1 ? suffixMap[term] : ""}`).join("").trim();
 };
 //#endregion
 //#region src/utils/formatQuery/defaultRuleProcessorSQL.ts
@@ -3993,6 +4144,11 @@ const defaultRuleProcessorSequelize = (rule, { parseNumbers, preserveValueOrder,
 //#endregion
 //#region src/utils/formatQuery/defaultRuleProcessorSPARQL.ts
 const escapeDoubleQuotes = (v, escapeQuotes) => typeof v !== "string" || !escapeQuotes ? `${v}` : v.replaceAll(`"`, `\\"`);
+/** Auto-prefix a SPARQL variable name with `?` unless it's already prefixed, a URI, or a prefixed name.
+*
+* @group Export
+*/
+const sparqlVar = (name) => /^[?<]/.test(name) || name.includes(":") ? name : `?${name}`;
 /**
 * Default rule processor used by {@link formatQuery} for "sparql" format.
 *
@@ -4000,14 +4156,15 @@ const escapeDoubleQuotes = (v, escapeQuotes) => typeof v !== "string" || !escape
 */
 const defaultRuleProcessorSPARQL = (rule, opts = {}) => {
 	const { escapeQuotes, parseNumbers } = opts;
-	const { field, operator, value, valueSource } = rule;
+	const { field: rawField, operator, value, valueSource } = rule;
 	const valueIsField = valueSource === "field";
 	const operatorTL = operator.toLowerCase();
+	const field = sparqlVar(rawField);
 	const fmtVal = (v) => {
 		if (v === null || v === void 0) return "\"\"";
 		if (typeof v === "boolean") return `"${v}"^^xsd:boolean`;
 		if (typeof v === "bigint") return String(v);
-		if (valueIsField) return trimIfString(v);
+		if (valueIsField) return sparqlVar(trimIfString(v));
 		if (typeof v === "number" || shouldRenderAsNumber(v, parseNumbers)) return trimIfString(v);
 		const s = typeof v === "string" ? v : JSON.stringify(v) ?? "";
 		if (s.startsWith("?") || s.startsWith("<") || s.includes(":")) return s;
@@ -4032,12 +4189,12 @@ const defaultRuleProcessorSPARQL = (rule, opts = {}) => {
 		case "in": {
 			const items = toArray(value).map(fmtVal);
 			if (!items.length) return "";
-			return items.map((item) => `${field} = ${item}`).join(" || ");
+			return `${field} IN (${items.join(", ")})`;
 		}
 		case "notin": {
 			const items = toArray(value).map(fmtVal);
 			if (!items.length) return "";
-			return items.map((item) => `${field} != ${item}`).join(" && ");
+			return `${field} NOT IN (${items.join(", ")})`;
 		}
 		case "between": {
 			const arr = toArray(value);
@@ -4100,6 +4257,7 @@ const defaultRuleProcessors = {
 	sequelize: defaultRuleProcessorSequelize,
 	spel: defaultRuleProcessorSpEL,
 	sql: defaultRuleProcessorSQL,
+	tanstack_db: defaultRuleProcessorTanStackDB,
 	cypher: defaultRuleProcessorCypher,
 	gql: defaultRuleProcessorCypher,
 	sparql: defaultRuleProcessorSPARQL,
@@ -4126,6 +4284,7 @@ const defaultOperatorProcessors = {
 	sequelize: defaultOperatorProcessor,
 	spel: defaultOperatorProcessor,
 	sql: defaultOperatorProcessorSQL,
+	tanstack_db: defaultOperatorProcessor,
 	cypher: defaultOperatorProcessor,
 	gql: defaultOperatorProcessor,
 	sparql: defaultOperatorProcessor,
@@ -4172,7 +4331,8 @@ const valueProcessorCanActAsRuleProcessor = new Set([
 	"mongodb",
 	"prisma",
 	"sequelize",
-	"spel"
+	"spel",
+	"tanstack_db"
 ]);
 const sqlFormats = new Set([
 	"sql",
@@ -4218,7 +4378,7 @@ function formatQuery(ruleGroup, optionParam = {}) {
 				} : format === "parameterized_named" ? {
 					sql: fallbackExpression,
 					params: {}
-				} : format === "mongodb" ? `{${fallbackExpression}}` : format === "mongodb_query" ? mongoDbFallback : format === "prisma" ? prismaFallback : format === "jsonlogic" ? false : format === "elasticsearch" ? {} : format === "drizzle" || format === "sequelize" ? void 0 : fallbackExpression;
+				} : format === "mongodb" ? `{${fallbackExpression}}` : format === "mongodb_query" ? mongoDbFallback : format === "prisma" ? prismaFallback : format === "jsonlogic" ? false : format === "elasticsearch" ? {} : format === "drizzle" || format === "sequelize" || format === "tanstack_db" ? void 0 : fallbackExpression;
 			}
 		} else validationMap = validationResult;
 	}
@@ -4278,6 +4438,7 @@ function formatQuery(ruleGroup, optionParam = {}) {
 		case "ldap": return defaultRuleGroupProcessorLDAP(ruleGroup, finalOptions);
 		case "prisma": return defaultRuleGroupProcessorPrisma(ruleGroup, finalOptions);
 		case "drizzle": return defaultRuleGroupProcessorDrizzle(ruleGroup, finalOptions);
+		case "tanstack_db": return defaultRuleGroupProcessorTanStackDB(ruleGroup, finalOptions);
 		case "sequelize": return defaultRuleGroupProcessorSequelize(ruleGroup, finalOptions);
 		case "cypher":
 		case "gql": return defaultRuleGroupProcessorCypher(ruleGroup, finalOptions);
@@ -5051,6 +5212,7 @@ exports.defaultRuleGroupProcessorSPARQL = defaultRuleGroupProcessorSPARQL;
 exports.defaultRuleGroupProcessorSQL = defaultRuleGroupProcessorSQL;
 exports.defaultRuleGroupProcessorSequelize = defaultRuleGroupProcessorSequelize;
 exports.defaultRuleGroupProcessorSpEL = defaultRuleGroupProcessorSpEL;
+exports.defaultRuleGroupProcessorTanStackDB = defaultRuleGroupProcessorTanStackDB;
 exports.defaultRuleProcessorCEL = defaultRuleProcessorCEL;
 exports.defaultRuleProcessorCypher = defaultRuleProcessorCypher;
 exports.defaultRuleProcessorDrizzle = defaultRuleProcessorDrizzle;
@@ -5068,6 +5230,7 @@ exports.defaultRuleProcessorSPARQL = defaultRuleProcessorSPARQL;
 exports.defaultRuleProcessorSQL = defaultRuleProcessorSQL;
 exports.defaultRuleProcessorSequelize = defaultRuleProcessorSequelize;
 exports.defaultRuleProcessorSpEL = defaultRuleProcessorSpEL;
+exports.defaultRuleProcessorTanStackDB = defaultRuleProcessorTanStackDB;
 exports.defaultSpELValueProcessor = defaultSpELValueProcessor;
 exports.defaultTranslations = defaultTranslations;
 exports.defaultValidator = defaultValidator;
@@ -5160,6 +5323,7 @@ exports.remove = remove;
 exports.removeInPlace = removeInPlace;
 exports.rootPath = rootPath;
 exports.shouldRenderAsNumber = shouldRenderAsNumber;
+exports.sparqlVar = sparqlVar;
 exports.splitBy = splitBy;
 exports.sqlDialectPresets = sqlDialectPresets;
 exports.standardClassnames = standardClassnames;