@react-querybuilder/core 8.14.4 → 8.16.0

package/dist/formatQuery.js

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_utils = require("./utils-CZRhzje-.js");
-const require_objectUtils = require("./objectUtils-ButT0Mng.js");
+const require_utils = require("./utils-Qwkq2Q0F.js");
+const require_objectUtils = require("./objectUtils-Bzug_QfX.js");
 const require_transformQuery = require("./transformQuery.js");
-const require_convertQuery = require("./convertQuery-J8LpTG-7.js");
+const require_convertQuery = require("./convertQuery-Lx2HQa0m.js");
 //#region src/utils/isRuleOrGroupValid.ts
 /**
 * Determines if an object is useful as a validation result.
@@ -20,7 +20,7 @@ const isRuleOrGroupValid = (rg, validationResult, validator) => {
 	if (typeof validator === "function" && !require_objectUtils.isRuleGroup(rg)) {
 		const vr = validator(rg);
 		if (typeof vr === "boolean") return vr;
-		// istanbul ignore else
+		// v8 ignore else
 		if (isValidationResult(vr)) return vr.valid;
 	}
 	return true;
@@ -83,7 +83,7 @@ const defaultRuleGroupProcessorCEL = (ruleGroup, options) => {
 //#endregion
 //#region src/utils/formatQuery/defaultRuleProcessorCEL.ts
 const shouldNegate$2 = (op) => op.startsWith("not") || op.startsWith("doesnot");
-const escapeDoubleQuotes = (v, escapeQuotes) => typeof v !== "string" || !escapeQuotes ? `${v}` : v.replaceAll(`"`, `\\"`);
+const escapeDoubleQuotes$1 = (v, escapeQuotes) => typeof v !== "string" || !escapeQuotes ? `${v}` : v.replaceAll(`"`, `\\"`);
 /**
 * Default rule processor used by {@link formatQuery} for "cel" format.
 *
@@ -125,19 +125,19 @@ const defaultRuleProcessorCEL = (rule, opts = {}) => {
 		case "==":
 		case "!=":
 		case ">":
-		case ">=": return `${field} ${operatorTL} ${valueIsField || useBareValue ? require_utils.trimIfString(value) : `"${escapeDoubleQuotes(value, escapeQuotes)}"`}`;
+		case ">=": return `${field} ${operatorTL} ${valueIsField || useBareValue ? require_utils.trimIfString(value) : `"${escapeDoubleQuotes$1(value, escapeQuotes)}"`}`;
 		case "contains":
-		case "doesnotcontain": return `${shouldNegate$2(operatorTL) ? "!" : ""}${field}.contains(${valueIsField ? require_utils.trimIfString(value) : `"${escapeDoubleQuotes(value, escapeQuotes)}"`})`;
+		case "doesnotcontain": return `${shouldNegate$2(operatorTL) ? "!" : ""}${field}.contains(${valueIsField ? require_utils.trimIfString(value) : `"${escapeDoubleQuotes$1(value, escapeQuotes)}"`})`;
 		case "beginswith":
-		case "doesnotbeginwith": return `${shouldNegate$2(operatorTL) ? "!" : ""}${field}.startsWith(${valueIsField ? require_utils.trimIfString(value) : `"${escapeDoubleQuotes(value, escapeQuotes)}"`})`;
+		case "doesnotbeginwith": return `${shouldNegate$2(operatorTL) ? "!" : ""}${field}.startsWith(${valueIsField ? require_utils.trimIfString(value) : `"${escapeDoubleQuotes$1(value, escapeQuotes)}"`})`;
 		case "endswith":
-		case "doesnotendwith": return `${shouldNegate$2(operatorTL) ? "!" : ""}${field}.endsWith(${valueIsField ? require_utils.trimIfString(value) : `"${escapeDoubleQuotes(value, escapeQuotes)}"`})`;
+		case "doesnotendwith": return `${shouldNegate$2(operatorTL) ? "!" : ""}${field}.endsWith(${valueIsField ? require_utils.trimIfString(value) : `"${escapeDoubleQuotes$1(value, escapeQuotes)}"`})`;
 		case "null": return `${field} == null`;
 		case "notnull": return `${field} != null`;
 		case "in":
 		case "notin": {
 			const [prefix, suffix] = shouldNegate$2(operatorTL) ? ["!(", ")"] : ["", ""];
-			return `${prefix}${field} in [${require_utils.toArray(value).map((val) => valueIsField || require_utils.shouldRenderAsNumber(val, parseNumbers) ? `${require_utils.trimIfString(val)}` : `"${escapeDoubleQuotes(val, escapeQuotes)}"`).join(", ")}]${suffix}`;
+			return `${prefix}${field} in [${require_utils.toArray(value).map((val) => valueIsField || require_utils.shouldRenderAsNumber(val, parseNumbers) ? `${require_utils.trimIfString(val)}` : `"${escapeDoubleQuotes$1(val, escapeQuotes)}"`).join(", ")}]${suffix}`;
 		}
 		case "between":
 		case "notbetween": {
@@ -147,8 +147,8 @@ const defaultRuleProcessorCEL = (rule, opts = {}) => {
 				const shouldParseNumbers = !(parseNumbers === false);
 				const firstNum = require_utils.shouldRenderAsNumber(first, shouldParseNumbers) ? require_utils.parseNumber(first, { parseNumbers: shouldParseNumbers }) : NaN;
 				const secondNum = require_utils.shouldRenderAsNumber(second, shouldParseNumbers) ? require_utils.parseNumber(second, { parseNumbers: shouldParseNumbers }) : NaN;
-				let firstValue = Number.isNaN(firstNum) ? valueIsField ? `${first}` : `"${escapeDoubleQuotes(first, escapeQuotes)}"` : firstNum;
-				let secondValue = Number.isNaN(secondNum) ? valueIsField ? `${second}` : `"${escapeDoubleQuotes(second, escapeQuotes)}"` : secondNum;
+				let firstValue = Number.isNaN(firstNum) ? valueIsField ? `${first}` : `"${escapeDoubleQuotes$1(first, escapeQuotes)}"` : firstNum;
+				let secondValue = Number.isNaN(secondNum) ? valueIsField ? `${second}` : `"${escapeDoubleQuotes$1(second, escapeQuotes)}"` : secondNum;
 				if (!preserveValueOrder && firstValue === firstNum && secondValue === secondNum && secondNum < firstNum) {
 					const tempNum = secondNum;
 					secondValue = firstNum;
@@ -404,7 +404,7 @@ const defaultRuleGroupProcessorSpEL = (ruleGroup, options) => {
 //#region src/utils/formatQuery/defaultRuleProcessorSpEL.ts
 const shouldNegate$1 = (op) => op.startsWith("not") || op.startsWith("doesnot");
 const wrapInNegation = (clause, negate) => negate ? `!(${clause})` : clause;
-const escapeSingleQuotes = (v, escapeQuotes) => typeof v !== "string" || !escapeQuotes ? `${v}` : v.replaceAll(`'`, `\\'`);
+const escapeSingleQuotes$2 = (v, escapeQuotes) => typeof v !== "string" || !escapeQuotes ? `${v}` : v.replaceAll(`'`, `\\'`);
 /**
 * Default rule processor used by {@link formatQuery} for "spel" format.
 *
@@ -445,20 +445,20 @@ const defaultRuleProcessorSpEL = (rule, opts = {}) => {
 		case "==":
 		case "!=":
 		case ">":
-		case ">=": return `${field} ${operatorTL} ${valueIsField || useBareValue ? require_utils.trimIfString(value) : `'${escapeSingleQuotes(value, escapeQuotes)}'`}`;
+		case ">=": return `${field} ${operatorTL} ${valueIsField || useBareValue ? require_utils.trimIfString(value) : `'${escapeSingleQuotes$2(value, escapeQuotes)}'`}`;
 		case "contains":
-		case "doesnotcontain": return wrapInNegation(`${field} matches ${valueIsField || useBareValue ? require_utils.trimIfString(value) : `'${escapeSingleQuotes(value, escapeQuotes)}'`}`, shouldNegate$1(operatorTL));
+		case "doesnotcontain": return wrapInNegation(`${field} matches ${valueIsField || useBareValue ? require_utils.trimIfString(value) : `'${escapeSingleQuotes$2(value, escapeQuotes)}'`}`, shouldNegate$1(operatorTL));
 		case "beginswith":
-		case "doesnotbeginwith": return wrapInNegation(`${field} matches ${valueIsField ? `'^'.concat(${require_utils.trimIfString(value)})` : `'${typeof value === "string" && !value.startsWith("^") || useBareValue ? "^" : ""}${escapeSingleQuotes(value, escapeQuotes)}'`}`, shouldNegate$1(operatorTL));
+		case "doesnotbeginwith": return wrapInNegation(`${field} matches ${valueIsField ? `'^'.concat(${require_utils.trimIfString(value)})` : `'${typeof value === "string" && !value.startsWith("^") || useBareValue ? "^" : ""}${escapeSingleQuotes$2(value, escapeQuotes)}'`}`, shouldNegate$1(operatorTL));
 		case "endswith":
-		case "doesnotendwith": return wrapInNegation(`${field} matches ${valueIsField ? `${require_utils.trimIfString(value)}.concat('$')` : `'${escapeSingleQuotes(value, escapeQuotes)}${typeof value === "string" && !value.endsWith("$") || useBareValue ? "$" : ""}'`}`, shouldNegate$1(operatorTL));
+		case "doesnotendwith": return wrapInNegation(`${field} matches ${valueIsField ? `${require_utils.trimIfString(value)}.concat('$')` : `'${escapeSingleQuotes$2(value, escapeQuotes)}${typeof value === "string" && !value.endsWith("$") || useBareValue ? "$" : ""}'`}`, shouldNegate$1(operatorTL));
 		case "null": return `${field} == null`;
 		case "notnull": return `${field} != null`;
 		case "in":
 		case "notin": {
 			const negate = shouldNegate$1(operatorTL) ? "!" : "";
 			const valueAsArray = require_utils.toArray(value);
-			return valueAsArray.length > 0 ? `${negate}(${valueAsArray.map((val) => `${field} == ${valueIsField || require_utils.shouldRenderAsNumber(val, parseNumbers) ? `${require_utils.trimIfString(val)}` : `'${escapeSingleQuotes(val, escapeQuotes)}'`}`).join(" or ")})` : "";
+			return valueAsArray.length > 0 ? `${negate}(${valueAsArray.map((val) => `${field} == ${valueIsField || require_utils.shouldRenderAsNumber(val, parseNumbers) ? `${require_utils.trimIfString(val)}` : `'${escapeSingleQuotes$2(val, escapeQuotes)}'`}`).join(" or ")})` : "";
 		}
 		case "between":
 		case "notbetween": {
@@ -468,8 +468,8 @@ const defaultRuleProcessorSpEL = (rule, opts = {}) => {
 				const shouldParseNumbers = !(parseNumbers === false);
 				const firstNum = require_utils.shouldRenderAsNumber(first, shouldParseNumbers) ? require_utils.parseNumber(first, { parseNumbers: shouldParseNumbers }) : NaN;
 				const secondNum = require_utils.shouldRenderAsNumber(second, shouldParseNumbers) ? require_utils.parseNumber(second, { parseNumbers: shouldParseNumbers }) : NaN;
-				let firstValue = Number.isNaN(firstNum) ? valueIsField ? `${first}` : `'${escapeSingleQuotes(first, escapeQuotes)}'` : firstNum;
-				let secondValue = Number.isNaN(secondNum) ? valueIsField ? `${second}` : `'${escapeSingleQuotes(second, escapeQuotes)}'` : secondNum;
+				let firstValue = Number.isNaN(firstNum) ? valueIsField ? `${first}` : `'${escapeSingleQuotes$2(first, escapeQuotes)}'` : firstNum;
+				let secondValue = Number.isNaN(secondNum) ? valueIsField ? `${second}` : `'${escapeSingleQuotes$2(second, escapeQuotes)}'` : secondNum;
 				if (!preserveValueOrder && firstValue === firstNum && secondValue === secondNum && secondNum < firstNum) {
 					const tempNum = secondNum;
 					secondValue = firstNum;
@@ -537,6 +537,70 @@ const defaultValueProcessorByRule = ({ operator, value, valueSource }, { escapeQ
 	return valueIsField ? wrapFieldName(value) : require_utils.shouldRenderAsNumber(value, parseNumbers) ? `${require_utils.trimIfString(value)}` : `${wrapAndEscape(value)}`;
 };
 //#endregion
+//#region src/utils/formatQuery/defaultRuleGroupProcessorCypher.ts
+/**
+* Maps a {@link DefaultCombinatorName} to a Cypher combinator keyword.
+*
+* @group Export
+*/
+const cypherCombinatorMap = {
+	and: "AND",
+	or: "OR"
+};
+/**
+* Rule group processor used by {@link formatQuery} for "cypher" and "gql" formats.
+*
+* @group Export
+*/
+const defaultRuleGroupProcessorCypher = (ruleGroup, options) => {
+	const { fields, fallbackExpression, getParseNumberBoolean, placeholderFieldName, placeholderOperatorName, placeholderValueName, ruleProcessor, validateRule, validationMap } = options;
+	const processRuleGroup = (rg, outermost) => {
+		if (!isRuleOrGroupValid(rg, validationMap[rg.id ?? ""])) return outermost ? fallbackExpression : "";
+		const processedRules = [];
+		let precedingCombinator = "";
+		let firstRule = true;
+		for (const rule of rg.rules) {
+			if (typeof rule === "string") {
+				precedingCombinator = cypherCombinatorMap[rule];
+				continue;
+			}
+			if (require_objectUtils.isRuleGroup(rule)) {
+				const processedGroup = processRuleGroup(rule);
+				if (processedGroup) {
+					if (!firstRule && precedingCombinator) {
+						processedRules.push(precedingCombinator);
+						precedingCombinator = "";
+					}
+					firstRule = false;
+					processedRules.push(processedGroup);
+				}
+				continue;
+			}
+			const [validationResult, fieldValidator] = validateRule(rule);
+			if (!isRuleOrGroupValid(rule, validationResult, fieldValidator) || rule.field === placeholderFieldName || rule.operator === placeholderOperatorName || placeholderValueName !== void 0 && rule.value === placeholderValueName) continue;
+			const fieldData = require_utils.getOption(fields, rule.field);
+			const processedRule = ruleProcessor(rule, {
+				...options,
+				parseNumbers: getParseNumberBoolean(fieldData?.inputType),
+				escapeQuotes: (rule.valueSource ?? "value") === "value",
+				fieldData
+			});
+			if (processedRule) {
+				if (!firstRule && precedingCombinator) {
+					processedRules.push(precedingCombinator);
+					precedingCombinator = "";
+				}
+				firstRule = false;
+				processedRules.push(processedRule);
+			}
+		}
+		const expression = processedRules.join(require_objectUtils.isRuleGroupType(rg) ? ` ${cypherCombinatorMap[rg.combinator]} ` : " ");
+		const [prefix, suffix] = rg.not || !outermost ? [`${rg.not ? "NOT " : ""}(`, ")"] : ["", ""];
+		return expression ? `${prefix}${expression}${suffix}` : fallbackExpression;
+	};
+	return processRuleGroup(ruleGroup, true);
+};
+//#endregion
 //#region src/utils/formatQuery/defaultRuleProcessorDrizzle.ts
 /**
 * Default rule processor used by {@link formatQuery} for the "drizzle" format.
@@ -544,22 +608,22 @@ const defaultValueProcessorByRule = ({ operator, value, valueSource }, { escapeQ
 * @group Export
 */
 const defaultRuleProcessorDrizzle = (rule, _options) => {
-	const opts = _options ?? (	/* istanbul ignore next */ {});
-	// istanbul ignore next
+	const opts = _options ?? (	/* v8 ignore start -- @preserve */ {});
+	// v8 ignore next
 	const { parseNumbers, preserveValueOrder, context = {} } = opts;
 	const { columns, drizzleOperators, useRawFields } = context;
-	if (!columns || !drizzleOperators) return;
+	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 = require_objectUtils.lc(operator);
 	const valueIsField = valueSource === "field";
 	const asFieldOrValue = (v) => valueIsField ? columns[v] : v;
-	if (!column) return;
+	if (!column) return void 0;
 	const matchEval = require_utils.processMatchMode(rule);
 	if (matchEval === false) return;
 	else if (matchEval) {
-		if (opts.preset !== "postgresql") return;
+		if (opts.preset !== "postgresql") return void 0;
 		const { mode, threshold } = matchEval;
 		const arrayElementAlias = "elem_alias";
 		const nestedArrayFilter = defaultRuleGroupProcessorDrizzle(require_transformQuery.transformQuery(rule.value, { ruleProcessor: (r) => ({
@@ -648,7 +712,7 @@ const defaultRuleProcessorDrizzle = (rule, _options) => {
 */
 const defaultRuleGroupProcessorDrizzle = (ruleGroup, options, _meta) => (columns, drizzleOperators) => {
 	const { fields, getParseNumberBoolean, placeholderFieldName, placeholderOperatorName, placeholderValueName, validateRule, validationMap } = options;
-	if (!columns || !drizzleOperators) return;
+	if (!columns || !drizzleOperators) return void 0;
 	const { and, not, or } = drizzleOperators;
 	const ruleProcessor = defaultRuleProcessorDrizzle;
 	const processRuleGroup = (rg, _outermost) => {
@@ -704,6 +768,67 @@ const defaultRuleGroupProcessorElasticSearch = (ruleGroup, options) => {
 	return processedRuleGroup === false ? {} : processedRuleGroup;
 };
 //#endregion
+//#region src/utils/formatQuery/defaultRuleGroupProcessorGremlin.ts
+/**
+* Rule group processor used by {@link formatQuery} for "gremlin" format.
+*
+* At the top level, filter rules produce chained `.has()` steps (implicit AND).
+* Nested groups use `.and()` / `.or()` / `.not()` compound traversals with
+* `__` anonymous traversal prefixes.
+*
+* @group Export
+*/
+const defaultRuleGroupProcessorGremlin = (ruleGroup, options) => {
+	const { fields, fallbackExpression, getParseNumberBoolean, placeholderFieldName, placeholderOperatorName, placeholderValueName, ruleProcessor, validateRule, validationMap } = options;
+	const validateAndProcess = (rule) => {
+		// v8 ignore next -- @preserve
+		if (typeof rule === "string" || require_objectUtils.isRuleGroup(rule)) return void 0;
+		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 = require_utils.getOption(fields, rule.field);
+		return ruleProcessor(rule, {
+			...options,
+			parseNumbers: getParseNumberBoolean(fieldData?.inputType),
+			escapeQuotes: (rule.valueSource ?? "value") === "value",
+			fieldData
+		});
+	};
+	/** Recursively processes a nested group into `.and()`/`.or()`/`.not()` form. */
+	const processNested = (rg) => {
+		if (!isRuleOrGroupValid(rg, validationMap[rg.id ?? ""])) return "";
+		const predicates = [];
+		for (const rule of rg.rules) {
+			if (typeof rule === "string") continue;
+			if (require_objectUtils.isRuleGroup(rule)) {
+				const nested = processNested(rule);
+				if (nested) predicates.push(nested);
+				continue;
+			}
+			const processed = validateAndProcess(rule);
+			if (processed) predicates.push(processed);
+		}
+		if (predicates.length === 0) return "";
+		const combinator = rg.combinator ?? "and";
+		const prefix = rg.not ? "not" : combinator;
+		if (predicates.length === 1 && !rg.not) return predicates[0];
+		return `.${prefix}(${predicates.map((p) => p.startsWith(".") ? `__${p}` : p).join(", ")})`;
+	};
+	if (!isRuleOrGroupValid(ruleGroup, validationMap[ruleGroup.id ?? ""])) return fallbackExpression;
+	const steps = [];
+	for (const rule of ruleGroup.rules) {
+		if (typeof rule === "string") continue;
+		if (require_objectUtils.isRuleGroup(rule)) {
+			const compound = processNested(rule);
+			if (compound) steps.push(compound);
+			continue;
+		}
+		const processed = validateAndProcess(rule);
+		if (processed) steps.push(processed);
+	}
+	if (steps.length === 0) return fallbackExpression;
+	return steps.join("");
+};
+//#endregion
 //#region src/utils/formatQuery/defaultRuleGroupProcessorJSONata.ts
 /**
 * Rule group processor used by {@link formatQuery} for "jsonata" format.
@@ -867,7 +992,7 @@ const defaultRuleGroupProcessorMongoDB = (ruleGroup, options, meta) => {
 const defaultRuleGroupProcessorNL = (ruleGroup, options) => {
 	const { fields, fallbackExpression, getParseNumberBoolean, placeholderFieldName, placeholderOperatorName, placeholderValueName, ruleProcessor, translations, validateRule, validationMap } = options;
 	const processRuleGroup = (rg, outermostOrLonelyInGroup) => {
-		if (!isRuleOrGroupValid(rg, validationMap[rg.id ?? ""])) return outermostOrLonelyInGroup ? fallbackExpression : "";
+		if (!isRuleOrGroupValid(rg, validationMap[rg.id ?? ""])) return outermostOrLonelyInGroup ? fallbackExpression : 		/* v8 ignore next -- @preserve */ "";
 		const rg2 = require_objectUtils.isRuleGroupTypeIC(rg) && rg.rules.some((r) => typeof r === "string" && require_objectUtils.lc(r) === "xor") ? require_convertQuery.convertFromIC(rg) : rg;
 		const processedRules = [];
 		let precedingCombinator = "";
@@ -879,7 +1004,7 @@ const defaultRuleGroupProcessorNL = (ruleGroup, options) => {
 			}
 			if (require_objectUtils.isRuleGroup(rule)) {
 				const processedGroup = processRuleGroup(rule, rg2.rules.length === 1 && !(rg2.not || /^xor$/i.test(rg2.combinator ?? "")));
-				// istanbul ignore else
+				// v8 ignore else
 				if (processedGroup) {
 					if (!firstRule && precedingCombinator) {
 						processedRules.push(precedingCombinator);
@@ -955,7 +1080,7 @@ const defaultRuleGroupProcessorParameterized = (ruleGroup, options) => {
 		if (!require_objectUtils.isPojo(processedRule)) return "";
 		const { sql, params: customParams } = processedRule;
 		if (typeof sql !== "string" || !sql) return "";
-		// istanbul ignore else
+		// v8 ignore else
 		if (format === "parameterized" && Array.isArray(customParams)) params.push(...customParams);
 		else if (format === "parameterized_named" && require_objectUtils.isPojo(customParams)) {
 			Object.assign(paramsNamed, customParams);
@@ -964,7 +1089,7 @@ const defaultRuleGroupProcessorParameterized = (ruleGroup, options) => {
 		return sql;
 	};
 	const processRuleGroup = (rg, outermostOrLonelyInGroup) => {
-		if (!isRuleOrGroupValid(rg, validationMap[rg.id ?? ""])) return outermostOrLonelyInGroup ? fallbackExpression : "";
+		if (!isRuleOrGroupValid(rg, validationMap[rg.id ?? ""])) return outermostOrLonelyInGroup ? fallbackExpression : 		/* v8 ignore next -- @preserve */ "";
 		const processedRules = [];
 		let precedingCombinator = "";
 		let firstRule = true;
@@ -975,7 +1100,7 @@ const defaultRuleGroupProcessorParameterized = (ruleGroup, options) => {
 			}
 			if (require_objectUtils.isRuleGroup(rule)) {
 				const processedGroup = processRuleGroup(rule, rg.rules.length === 1);
-				// istanbul ignore else
+				// v8 ignore else
 				if (processedGroup) {
 					if (!firstRule && precedingCombinator) {
 						processedRules.push(precedingCombinator);
@@ -1058,10 +1183,10 @@ const defaultRuleGroupProcessorPrisma = (ruleGroup, options) => {
 * @group Export
 */
 const defaultRuleGroupProcessorSequelize = (ruleGroup, options) => {
-	// istanbul ignore next
+	// v8 ignore next
 	const { fields, getParseNumberBoolean, placeholderFieldName, placeholderOperatorName, placeholderValueName, ruleProcessor, validateRule, validationMap, context = {} } = options;
 	const { sequelizeOperators: Op } = context;
-	if (!Op) return;
+	if (!Op) return void 0;
 	const processRuleGroup = (rg, _outermost) => {
 		if (!isRuleOrGroupValid(rg, validationMap[rg.id ?? ""])) return;
 		const combinator = rg.combinator.toUpperCase();
@@ -1084,13 +1209,70 @@ const defaultRuleGroupProcessorSequelize = (ruleGroup, options) => {
 				fieldData
 			});
 		}).filter(Boolean);
-		if (expressions.length === 0) return;
+		if (expressions.length === 0) return void 0;
 		const result = expressions.length === 1 && !hasChildRules ? expressions[0] : { [require_objectUtils.lc(combinator) === "or" ? Op.or : Op.and]: expressions };
 		return rg.not ? { [Op.not]: result } : result;
 	};
 	return processRuleGroup(require_convertQuery.convertFromIC(ruleGroup), true);
 };
 //#endregion
+//#region src/utils/formatQuery/defaultRuleGroupProcessorSPARQL.ts
+/**
+* Rule group processor used by {@link formatQuery} for "sparql" format.
+*
+* SPARQL uses the same combinators as CEL (`&&` / `||`) and `!()` for negation.
+*
+* @group Export
+*/
+const defaultRuleGroupProcessorSPARQL = (ruleGroup, options) => {
+	const { fields, fallbackExpression, getParseNumberBoolean, placeholderFieldName, placeholderOperatorName, placeholderValueName, ruleProcessor, validateRule, validationMap } = options;
+	const processRuleGroup = (rg, outermost) => {
+		if (!isRuleOrGroupValid(rg, validationMap[rg.id ?? ""])) return outermost ? fallbackExpression : "";
+		const processedRules = [];
+		let precedingCombinator = "";
+		let firstRule = true;
+		for (const rule of rg.rules) {
+			if (typeof rule === "string") {
+				precedingCombinator = require_utils.celCombinatorMap[rule];
+				continue;
+			}
+			if (require_objectUtils.isRuleGroup(rule)) {
+				const processedGroup = processRuleGroup(rule);
+				if (processedGroup) {
+					if (!firstRule && precedingCombinator) {
+						processedRules.push(precedingCombinator);
+						precedingCombinator = "";
+					}
+					firstRule = false;
+					processedRules.push(processedGroup);
+				}
+				continue;
+			}
+			const [validationResult, fieldValidator] = validateRule(rule);
+			if (!isRuleOrGroupValid(rule, validationResult, fieldValidator) || rule.field === placeholderFieldName || rule.operator === placeholderOperatorName || placeholderValueName !== void 0 && rule.value === placeholderValueName) continue;
+			const fieldData = require_utils.getOption(fields, rule.field);
+			const processedRule = ruleProcessor(rule, {
+				...options,
+				parseNumbers: getParseNumberBoolean(fieldData?.inputType),
+				escapeQuotes: (rule.valueSource ?? "value") === "value",
+				fieldData
+			});
+			if (processedRule) {
+				if (!firstRule && precedingCombinator) {
+					processedRules.push(precedingCombinator);
+					precedingCombinator = "";
+				}
+				firstRule = false;
+				processedRules.push(processedRule);
+			}
+		}
+		const expression = processedRules.join(require_objectUtils.isRuleGroupType(rg) ? ` ${require_utils.celCombinatorMap[rg.combinator]} ` : " ");
+		const [prefix, suffix] = rg.not || !outermost ? [`${rg.not ? "!" : ""}(`, ")"] : ["", ""];
+		return expression ? `${prefix}${expression}${suffix}` : fallbackExpression;
+	};
+	return processRuleGroup(ruleGroup, true);
+};
+//#endregion
 //#region src/utils/formatQuery/defaultRuleGroupProcessorSQL.ts
 /**
 * Default rule processor used by {@link formatQuery} for "sql" format.
@@ -1100,7 +1282,7 @@ const defaultRuleGroupProcessorSequelize = (ruleGroup, options) => {
 const defaultRuleGroupProcessorSQL = (ruleGroup, options) => {
 	const { fields, fallbackExpression, getParseNumberBoolean, placeholderFieldName, placeholderOperatorName, placeholderValueName, ruleProcessor, validateRule, validationMap } = options;
 	const processRuleGroup = (rg, outermostOrLonelyInGroup) => {
-		if (!isRuleOrGroupValid(rg, validationMap[rg.id ?? ""])) return outermostOrLonelyInGroup ? fallbackExpression : "";
+		if (!isRuleOrGroupValid(rg, validationMap[rg.id ?? ""])) return outermostOrLonelyInGroup ? fallbackExpression : 		/* v8 ignore next -- @preserve */ "";
 		const processedRules = [];
 		let precedingCombinator = "";
 		let firstRule = true;
@@ -1111,7 +1293,7 @@ const defaultRuleGroupProcessorSQL = (ruleGroup, options) => {
 			}
 			if (require_objectUtils.isRuleGroup(rule)) {
 				const processedGroup = processRuleGroup(rule, rg.rules.length === 1);
-				// istanbul ignore else
+				// v8 ignore else
 				if (processedGroup) {
 					if (!firstRule && precedingCombinator) {
 						processedRules.push(precedingCombinator);
@@ -1147,6 +1329,378 @@ const defaultRuleGroupProcessorSQL = (ruleGroup, options) => {
 	return processRuleGroup(ruleGroup, true);
 };
 //#endregion
+//#region src/utils/formatQuery/defaultRuleGroupProcessorDiagnostics.ts
+const numericInputTypes = new Set([
+	"number",
+	"range",
+	"bigint"
+]);
+const dateRegex = /^\d{4}-\d{2}-\d{2}$/;
+const timeRegex = /^\d{2}:\d{2}(:\d{2}(\.\d+)?)?$/;
+const monthRegex = /^\d{4}-\d{2}$/;
+const weekRegex = /^\d{4}-W\d{2}$/;
+const colorRegex = /^#([0-9a-f]{3}|[0-9a-f]{6})$/i;
+const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+const isValidDateComponents = (y, m, d) => {
+	const date = new Date(Date.UTC(y, m - 1, d));
+	return date.getUTCFullYear() === y && date.getUTCMonth() === m - 1 && date.getUTCDate() === d;
+};
+const isValidTimeComponents = (s) => {
+	const parts = s.split(":");
+	const h = Number(parts[0]);
+	const m = Number(parts[1]);
+	const sec = parts[2] ? Number.parseFloat(parts[2]) : 0;
+	return h >= 0 && h <= 23 && m >= 0 && m <= 59 && sec >= 0 && sec < 60;
+};
+/**
+* Checks whether a value is compatible with the given {@link FullField.inputType}.
+* Returns a diagnostic code string if there is a mismatch, or `undefined` if OK.
+*/
+const checkValueTypeMismatch = (value, inputType) => {
+	if (value === null || value === void 0 || value === "") return void 0;
+	if (numericInputTypes.has(inputType)) {
+		const v = typeof value === "string" ? value.trim() : value;
+		if (typeof v === "number" || typeof v === "bigint") return void 0;
+		if (typeof v === "string" && require_objectUtils.numericRegex.test(v)) return void 0;
+		return "VALUE_TYPE_MISMATCH";
+	}
+	if (inputType === "date") {
+		if (typeof value !== "string") return "VALUE_TYPE_MISMATCH";
+		const v = value.trim();
+		if (!dateRegex.test(v)) return "VALUE_TYPE_MISMATCH";
+		const [y, m, d] = v.split("-").map(Number);
+		return isValidDateComponents(y, m, d) ? void 0 : "VALUE_TYPE_MISMATCH";
+	}
+	if (inputType === "datetime-local") {
+		if (typeof value !== "string") return "VALUE_TYPE_MISMATCH";
+		const base = value.trim().replace(/(Z|[+-]\d{2}:?\d{2}|[+-]\d{2})$/, "");
+		const tIndex = base.indexOf("T");
+		if (tIndex === -1) return "VALUE_TYPE_MISMATCH";
+		const datePart = base.slice(0, tIndex);
+		const timePart = base.slice(tIndex + 1);
+		if (!dateRegex.test(datePart) || !timeRegex.test(timePart)) return "VALUE_TYPE_MISMATCH";
+		const [y, m, d] = datePart.split("-").map(Number);
+		if (!isValidDateComponents(y, m, d)) return "VALUE_TYPE_MISMATCH";
+		return isValidTimeComponents(timePart) ? void 0 : "VALUE_TYPE_MISMATCH";
+	}
+	if (inputType === "time") {
+		if (typeof value !== "string") return "VALUE_TYPE_MISMATCH";
+		const v = value.trim();
+		if (!timeRegex.test(v)) return "VALUE_TYPE_MISMATCH";
+		return isValidTimeComponents(v) ? void 0 : "VALUE_TYPE_MISMATCH";
+	}
+	if (inputType === "month") {
+		if (typeof value !== "string") return "VALUE_TYPE_MISMATCH";
+		const v = value.trim();
+		if (!monthRegex.test(v)) return "VALUE_TYPE_MISMATCH";
+		const m = Number(v.slice(5));
+		return m >= 1 && m <= 12 ? void 0 : "VALUE_TYPE_MISMATCH";
+	}
+	if (inputType === "week") {
+		if (typeof value !== "string") return "VALUE_TYPE_MISMATCH";
+		const v = value.trim();
+		if (!weekRegex.test(v)) return "VALUE_TYPE_MISMATCH";
+		const w = Number(v.slice(6));
+		return w >= 1 && w <= 53 ? void 0 : "VALUE_TYPE_MISMATCH";
+	}
+	if (inputType === "color") {
+		if (typeof value !== "string") return "VALUE_TYPE_MISMATCH";
+		return colorRegex.test(value.trim()) ? void 0 : "VALUE_TYPE_MISMATCH";
+	}
+	if (inputType === "url") {
+		if (typeof value !== "string") return "VALUE_TYPE_MISMATCH";
+		try {
+			new URL(value.trim());
+			return;
+		} catch {
+			return "VALUE_TYPE_MISMATCH";
+		}
+	}
+	if (inputType === "email") {
+		if (typeof value !== "string") return "VALUE_TYPE_MISMATCH";
+		return emailRegex.test(value.trim()) ? void 0 : "VALUE_TYPE_MISMATCH";
+	}
+};
+/**
+* Rule group processor used by {@link formatQuery} for "diagnostics" format.
+*
+* Produces a {@link DiagnosticsResult} containing an annotated copy of the query
+* tree (`query`) with `valid`, `reasons`, `path`, and `level` properties on every
+* rule and group; a flat `diagnostics` array; aggregate `stats`; and a per-field
+* `fieldSummary`.
+*
+* @group Export
+*/
+const defaultRuleGroupProcessorDiagnostics = (ruleGroup, options) => {
+	const { fields: fieldsOption, placeholderFieldName, placeholderOperatorName, placeholderValueName, validateRule, validationMap } = options;
+	const diagnostics = [];
+	const stats = {
+		totalRules: 0,
+		totalGroups: 0,
+		validRules: 0,
+		invalidRules: 0,
+		validGroups: 0,
+		invalidGroups: 0
+	};
+	const fieldSummary = {};
+	const uniqueFields = require_utils.toFlatOptionArray(fieldsOption);
+	const fieldsByName = /* @__PURE__ */ new Map();
+	for (const f of uniqueFields) fieldsByName.set(f.name, f);
+	const hasFieldsConfig = fieldsByName.size > 0;
+	const processRuleGroup = (rg, path) => {
+		stats.totalGroups++;
+		const level = path.length;
+		const groupValidationEntry = validationMap[rg.id ?? ""];
+		const groupSelfValid = isRuleOrGroupValid(rg, groupValidationEntry);
+		const groupReasons = getReasons(groupValidationEntry);
+		if (rg.muted) diagnostics.push({
+			id: rg.id ?? "",
+			path,
+			code: "MUTED",
+			message: "Group is muted",
+			source: "muted"
+		});
+		else if (!groupSelfValid && groupValidationEntry !== void 0) diagnostics.push({
+			id: rg.id ?? "",
+			path,
+			code: "CUSTOM_VALIDATOR",
+			message: groupReasons ? `Invalid: ${groupReasons.join(", ")}` : "Group failed validation",
+			source: "query-validator"
+		});
+		let allChildrenValid = true;
+		let ruleIndex = 0;
+		const annotatedRules = [];
+		for (const rule of rg.rules) {
+			if (typeof rule === "string") {
+				annotatedRules.push(rule);
+				ruleIndex++;
+				continue;
+			}
+			const childPath = [...path, ruleIndex];
+			if (require_objectUtils.isRuleGroup(rule)) {
+				const annotatedGroup = processRuleGroup(rule, childPath);
+				if (!annotatedGroup.valid) allChildrenValid = false;
+				annotatedRules.push(annotatedGroup);
+				ruleIndex++;
+				continue;
+			}
+			stats.totalRules++;
+			const childLevel = childPath.length;
+			const [validationResult, fieldValidator] = validateRule(rule);
+			const ruleValid = isRuleOrGroupValid(rule, validationResult, fieldValidator) && rule.field !== placeholderFieldName && rule.operator !== placeholderOperatorName && !(placeholderValueName !== void 0 && rule.value === placeholderValueName);
+			collectRuleDiagnostics(rule, childPath, validationResult, fieldValidator, ruleValid, diagnostics, placeholderFieldName, placeholderOperatorName, placeholderValueName, hasFieldsConfig, fieldsByName);
+			if (!ruleValid) {
+				allChildrenValid = false;
+				stats.invalidRules++;
+			} else stats.validRules++;
+			const fieldName = rule.field;
+			if (!fieldSummary[fieldName]) fieldSummary[fieldName] = {
+				ruleCount: 0,
+				invalidCount: 0
+			};
+			fieldSummary[fieldName].ruleCount++;
+			if (!ruleValid) fieldSummary[fieldName].invalidCount++;
+			const ruleReasons = getReasons(validationResult) ?? getFieldValidatorReasons(rule, fieldValidator);
+			const annotatedRule = {
+				...rule,
+				valid: ruleValid,
+				...ruleReasons ? { reasons: ruleReasons } : null,
+				path: childPath,
+				level: childLevel
+			};
+			annotatedRules.push(annotatedRule);
+			ruleIndex++;
+		}
+		const groupValid = groupSelfValid && allChildrenValid;
+		if (groupValid) stats.validGroups++;
+		else stats.invalidGroups++;
+		if (require_objectUtils.isRuleGroupType(rg)) return {
+			...rg,
+			valid: groupValid,
+			...groupReasons ? { reasons: groupReasons } : null,
+			path,
+			level,
+			rules: annotatedRules
+		};
+		return {
+			...rg,
+			valid: groupValid,
+			...groupReasons ? { reasons: groupReasons } : null,
+			path,
+			level,
+			rules: annotatedRules
+		};
+	};
+	const query = processRuleGroup(ruleGroup, []);
+	if (hasFieldsConfig) {
+		const referencedFields = new Set(Object.keys(fieldSummary));
+		for (const [fieldName] of fieldsByName) if (!referencedFields.has(fieldName)) diagnostics.push({
+			id: "",
+			path: [],
+			code: "UNREFERENCED_FIELD",
+			message: `Field "${fieldName}" is defined in the fields config but not used in the query`,
+			source: "field-check"
+		});
+	}
+	return {
+		query,
+		diagnostics,
+		stats,
+		fieldSummary
+	};
+};
+/**
+* Collects diagnostic entries for a single rule.
+*/
+const collectRuleDiagnostics = (rule, path, validationResult, fieldValidator, ruleValid, diagnostics, placeholderFieldName, placeholderOperatorName, placeholderValueName, hasFieldsConfig, fieldsByName) => {
+	const id = rule.id ?? "";
+	if (rule.muted) diagnostics.push({
+		id,
+		path,
+		code: "MUTED",
+		message: "Rule is muted",
+		source: "muted"
+	});
+	if (rule.field === placeholderFieldName) diagnostics.push({
+		id,
+		path,
+		code: "PLACEHOLDER_FIELD",
+		message: "Rule has a placeholder field",
+		source: "placeholder"
+	});
+	if (rule.operator === placeholderOperatorName) diagnostics.push({
+		id,
+		path,
+		code: "PLACEHOLDER_OPERATOR",
+		message: "Rule has a placeholder operator",
+		source: "placeholder"
+	});
+	if (placeholderValueName !== void 0 && rule.value === placeholderValueName) diagnostics.push({
+		id,
+		path,
+		code: "PLACEHOLDER_VALUE",
+		message: "Rule has a placeholder value",
+		source: "placeholder"
+	});
+	if (!rule.muted && rule.field !== placeholderFieldName && rule.operator !== placeholderOperatorName && !(placeholderValueName !== void 0 && rule.value === placeholderValueName)) {
+		if (typeof validationResult === "boolean" && !validationResult) diagnostics.push({
+			id,
+			path,
+			code: "CUSTOM_VALIDATOR",
+			message: "Rule failed validation",
+			source: "query-validator"
+		});
+		else if (typeof validationResult !== "boolean" && isValidationResult(validationResult) && !validationResult.valid) {
+			const reasons = validationResult.reasons;
+			diagnostics.push({
+				id,
+				path,
+				code: "CUSTOM_VALIDATOR",
+				message: reasons ? `Invalid: ${reasons.join(", ")}` : "Rule failed validation",
+				source: "query-validator"
+			});
+		} else if (!ruleValid && typeof fieldValidator === "function") {
+			const vr = fieldValidator(rule);
+			const reasons = typeof vr !== "boolean" && isValidationResult(vr) && !vr.valid ? vr.reasons : void 0;
+			diagnostics.push({
+				id,
+				path,
+				code: "CUSTOM_VALIDATOR",
+				message: reasons ? `Invalid: ${reasons.join(", ")}` : "Rule failed field validation",
+				source: "field-validator"
+			});
+		}
+	}
+	if (hasFieldsConfig && !fieldsByName.has(rule.field) && rule.field !== placeholderFieldName) diagnostics.push({
+		id,
+		path,
+		code: "UNDEFINED_FIELD",
+		message: `Field "${rule.field}" is not defined in the fields config`,
+		source: "field-check"
+	});
+	if (hasFieldsConfig) {
+		const fieldDef = fieldsByName.get(rule.field);
+		if (fieldDef?.inputType) {
+			const mismatchCode = checkValueTypeMismatch(rule.value, fieldDef.inputType);
+			if (mismatchCode) diagnostics.push({
+				id,
+				path,
+				code: mismatchCode,
+				message: `Value "${rule.value}" is not compatible with input type "${fieldDef.inputType}"`,
+				source: "type-check"
+			});
+		}
+	}
+};
+/**
+* Extracts `reasons` from a validation result, if present.
+*/
+const getReasons = (validationResult) => {
+	if (typeof validationResult !== "boolean" && isValidationResult(validationResult) && !validationResult.valid && validationResult.reasons) return validationResult.reasons;
+};
+/**
+* Runs a field-level validator and extracts `reasons` if present.
+*/
+const getFieldValidatorReasons = (rule, fieldValidator) => {
+	if (typeof fieldValidator === "function") {
+		const vr = fieldValidator(rule);
+		if (typeof vr !== "boolean" && isValidationResult(vr) && !vr.valid && vr.reasons) return vr.reasons;
+	}
+};
+//#endregion
+//#region src/utils/formatQuery/defaultRuleProcessorCypher.ts
+const escapeSingleQuotes$1 = (v, escapeQuotes) => typeof v !== "string" || !escapeQuotes ? `${v}` : v.replaceAll("'", "\\'");
+/**
+* Default rule processor used by {@link formatQuery} for "cypher" and "gql" formats.
+*
+* @group Export
+*/
+const defaultRuleProcessorCypher = (rule, opts = {}) => {
+	const { escapeQuotes, parseNumbers } = opts;
+	const { field, operator, value, valueSource } = rule;
+	const valueIsField = valueSource === "field";
+	const operatorTL = operator.toLowerCase();
+	const fmtVal = (v) => {
+		if (v === null || v === void 0) return "null";
+		if (typeof v === "boolean" || typeof v === "bigint") return String(v);
+		if (valueIsField) return require_utils.trimIfString(v);
+		if (typeof v === "number" || require_utils.shouldRenderAsNumber(v, parseNumbers)) return require_utils.trimIfString(v);
+		return `'${escapeSingleQuotes$1(v, escapeQuotes)}'`;
+	};
+	switch (operatorTL) {
+		case "=": return `${field} = ${fmtVal(value)}`;
+		case "!=":
+		case "<>": return `${field} <> ${fmtVal(value)}`;
+		case "<":
+		case ">":
+		case "<=":
+		case ">=": return `${field} ${operatorTL} ${fmtVal(value)}`;
+		case "contains": return `${field} CONTAINS ${fmtVal(value)}`;
+		case "doesnotcontain": return `NOT ${field} CONTAINS ${fmtVal(value)}`;
+		case "beginswith": return `${field} STARTS WITH ${fmtVal(value)}`;
+		case "doesnotbeginwith": return `NOT ${field} STARTS WITH ${fmtVal(value)}`;
+		case "endswith": return `${field} ENDS WITH ${fmtVal(value)}`;
+		case "doesnotendwith": return `NOT ${field} ENDS WITH ${fmtVal(value)}`;
+		case "null": return `${field} IS NULL`;
+		case "notnull": return `${field} IS NOT NULL`;
+		case "in":
+		case "notin": {
+			const values = require_utils.toArray(value).map(fmtVal);
+			if (!values.length) return "";
+			return `${operatorTL === "notin" ? "NOT " : ""}${field} IN [${values.join(", ")}]`;
+		}
+		case "between":
+		case "notbetween": {
+			const arr = require_utils.toArray(value);
+			if (arr.length < 2) return "";
+			const [low, high] = [fmtVal(arr[0]), fmtVal(arr[1])];
+			const expr = `${low} <= ${field} AND ${field} <= ${high}`;
+			return operatorTL === "notbetween" ? `NOT (${expr})` : expr;
+		}
+		default: return `${field} ${operator} ${fmtVal(value)}`;
+	}
+};
+//#endregion
 //#region src/utils/formatQuery/defaultRuleProcessorElasticSearch.ts
 const rangeOperatorMap = {
 	"<": "lt",
@@ -1298,6 +1852,68 @@ const defaultRuleProcessorElasticSearch = (rule, options = {}) => {
 	return false;
 };
 //#endregion
+//#region src/utils/formatQuery/defaultRuleProcessorGremlin.ts
+const escapeSingleQuotes = (v, escapeQuotes) => typeof v !== "string" || !escapeQuotes ? `${v}` : v.replaceAll("'", "\\'");
+/**
+* Default rule processor used by {@link formatQuery} for "gremlin" format.
+*
+* Each rule becomes a `.has()` step (or `.hasNot()`/`.has()` for null checks).
+*
+* @group Export
+*/
+const defaultRuleProcessorGremlin = (rule, opts = {}) => {
+	const { escapeQuotes, parseNumbers } = opts;
+	const { field, operator, value, valueSource } = rule;
+	const valueIsField = valueSource === "field";
+	const operatorTL = operator.toLowerCase();
+	const prop = field.includes(".") ? field.split(".").pop() : field;
+	const fmtVal = (v) => {
+		if (v === null || v === void 0) return "null";
+		if (typeof v === "boolean" || typeof v === "bigint") return String(v);
+		if (valueIsField) return require_utils.trimIfString(v);
+		if (typeof v === "number" || require_utils.shouldRenderAsNumber(v, parseNumbers)) return require_utils.trimIfString(v);
+		return `'${escapeSingleQuotes(v, escapeQuotes)}'`;
+	};
+	switch (operatorTL) {
+		case "=": return `.has('${prop}', ${fmtVal(value)})`;
+		case "!=":
+		case "<>": return `.has('${prop}', neq(${fmtVal(value)}))`;
+		case "<": return `.has('${prop}', lt(${fmtVal(value)}))`;
+		case ">": return `.has('${prop}', gt(${fmtVal(value)}))`;
+		case "<=": return `.has('${prop}', lte(${fmtVal(value)}))`;
+		case ">=": return `.has('${prop}', gte(${fmtVal(value)}))`;
+		case "contains": return `.has('${prop}', containing(${fmtVal(value)}))`;
+		case "doesnotcontain": return `.has('${prop}', notContaining(${fmtVal(value)}))`;
+		case "beginswith": return `.has('${prop}', startingWith(${fmtVal(value)}))`;
+		case "doesnotbeginwith": return `.has('${prop}', notStartingWith(${fmtVal(value)}))`;
+		case "endswith": return `.has('${prop}', endingWith(${fmtVal(value)}))`;
+		case "doesnotendwith": return `.has('${prop}', notEndingWith(${fmtVal(value)}))`;
+		case "null": return `.hasNot('${prop}')`;
+		case "notnull": return `.has('${prop}')`;
+		case "in": {
+			const items = require_utils.toArray(value).map(fmtVal);
+			if (!items.length) return "";
+			return `.has('${prop}', within(${items.join(", ")}))`;
+		}
+		case "notin": {
+			const items = require_utils.toArray(value).map(fmtVal);
+			if (!items.length) return "";
+			return `.has('${prop}', without(${items.join(", ")}))`;
+		}
+		case "between": {
+			const arr = require_utils.toArray(value);
+			if (arr.length < 2) return "";
+			return `.has('${prop}', between(${fmtVal(arr[0])}, ${fmtVal(arr[1])}))`;
+		}
+		case "notbetween": {
+			const arr = require_utils.toArray(value);
+			if (arr.length < 2) return "";
+			return `.has('${prop}', outside(${fmtVal(arr[0])}, ${fmtVal(arr[1])}))`;
+		}
+		default: return `.has('${prop}', ${fmtVal(value)})`;
+	}
+};
+//#endregion
 //#region src/utils/formatQuery/defaultRuleProcessorJSONata.ts
 const shouldNegate = (op) => op.startsWith("not") || op.startsWith("doesnot");
 const quote = (v, escapeQuotes) => `"${typeof v !== "string" || !escapeQuotes ? `${v}` : v.replaceAll(`"`, `\\"`)}"`;
@@ -1525,12 +2141,12 @@ const defaultRuleProcessorLDAP = (rule, options = {}) => {
 			return negateIf(`(&(${field}>=${ldapEscape(firstValue)})(${field}<=${ldapEscape(secondValue)}))`, operatorLC === "notbetween");
 		}
 	}
-	// istanbul ignore next
+	// v8 ignore next
 	return "";
 };
 //#endregion
 //#region src/utils/formatQuery/defaultValueProcessorNL.ts
-const escapeStringValueQuotes = (v, quoteChar, escapeQuotes) => escapeQuotes && typeof v === "string" ? v.replaceAll(`${quoteChar}`, `${quoteChar}${quoteChar}`) : v;
+const escapeStringValueQuotes = (v, quoteChar, escapeQuotes) => escapeQuotes && typeof v === "string" ? v.replaceAll(`${quoteChar}`, `${quoteChar}${quoteChar}`) : /* v8 ignore next -- @preserve */ v;
 /**
 * Default value processor used by {@link formatQuery} for "natural_language" format.
 *
@@ -1548,7 +2164,7 @@ const defaultValueProcessorNL = (rule, opts = {}) => {
 		quoteFieldNamesWith,
 		fieldIdentifierSeparator
 	});
-	const t = translations ?? (	/* istanbul ignore next */ {});
+	const t = translations ?? (	/* v8 ignore start -- @preserve */ {});
 	const orTL = t.or ?? "or";
 	const trueTL = t.true ?? "true";
 	const falseTL = t.false ?? "false";
@@ -1604,7 +2220,7 @@ const defaultExportOperatorMap = {
 	between: ["is between", "is between the values in"],
 	notbetween: ["is not between", "is not between the values in"]
 };
-/* istanbul ignore next */
+/* v8 ignore next -- @preserve */
 const defaultGetOperators = () => [];
 /**
 * Default operator processor used by {@link formatQuery} for "natural_language" format.
@@ -1613,7 +2229,7 @@ const defaultGetOperators = () => [];
 */
 const defaultOperatorProcessorNL = (rule, opts = {}) => {
 	const { field, operator, valueSource = "value" } = rule;
-	// istanbul ignore next
+	// v8 ignore next
 	const { getOperators = defaultGetOperators, operatorMap: operatorMapParam = defaultExportOperatorMap } = opts;
 	const mergedOperatorMap = new Map(Object.entries(defaultExportOperatorMap));
 	for (const [key, value] of Object.entries(operatorMapParam)) mergedOperatorMap.set(require_objectUtils.lc(key), value);
@@ -1642,8 +2258,8 @@ const defaultOperatorProcessorNL = (rule, opts = {}) => {
 */
 const defaultRuleProcessorNL = (rule, opts) => {
 	const { field, operator } = rule;
-	// istanbul ignore next
-	const { fieldData, quoteFieldNamesWith = ["", ""], fieldIdentifierSeparator = "", quoteValuesWith = `'`, operatorProcessor = defaultOperatorProcessorNL, valueProcessor = defaultValueProcessorNL, concatOperator = "||", wordOrder = "SVO" } = opts ?? (	/* istanbul ignore next */ {});
+	// v8 ignore next
+	const { fieldData, quoteFieldNamesWith = ["", ""], fieldIdentifierSeparator = "", quoteValuesWith = `'`, operatorProcessor = defaultOperatorProcessorNL, valueProcessor = defaultValueProcessorNL, concatOperator = "||", wordOrder = "SVO" } = opts ?? (	/* v8 ignore start -- @preserve */ {});
 	const processedField = require_utils.getQuotedFieldName(fieldData?.label ?? field, {
 		quoteFieldNamesWith,
 		fieldIdentifierSeparator
@@ -1749,7 +2365,7 @@ const defaultRuleProcessorSQL = (rule, opts = {}) => {
 * @group Export
 */
 const defaultRuleProcessorParameterized = (rule, opts, meta) => {
-	// istanbul ignore next
+	// v8 ignore next
 	const { fieldData, format, getNextNamedParam, parseNumbers, paramPrefix, paramsKeepPrefix, numberedParams, quoteFieldNamesWith = ["", ""], fieldIdentifierSeparator, concatOperator, operatorProcessor = defaultOperatorProcessorSQL, valueProcessor = defaultValueProcessorByRule } = opts ?? {};
 	const { processedParams = [] } = meta ?? {};
 	const parameterized = format === "parameterized";
@@ -1768,6 +2384,7 @@ const defaultRuleProcessorParameterized = (rule, opts, meta) => {
 	});
 	const ruleField = wrapFieldName(rule.field);
 	const matchEval = require_utils.processMatchMode(rule);
+	/* v8 ignore start -- @preserve */
 	if (matchEval === false) return;
 	else if (matchEval) {
 		if (opts?.preset !== "postgresql") return finalize("");
@@ -1780,7 +2397,6 @@ const defaultRuleProcessorParameterized = (rule, opts, meta) => {
 			...opts,
 			fields: []
 		});
-		// istanbul ignore else
 		if (Array.isArray(nestedParams)) params.push(...nestedParams);
 		else Object.assign(paramsNamed, nestedParams);
 		switch (mode) {
@@ -1795,6 +2411,7 @@ const defaultRuleProcessorParameterized = (rule, opts, meta) => {
 			}
 		}
 	}
+	/* v8 ignore stop -- @preserve */
 	const value = valueProcessor(rule, {
 		parseNumbers,
 		quoteFieldNamesWith,
@@ -1835,7 +2452,7 @@ const defaultRuleProcessorParameterized = (rule, opts, meta) => {
 	}
 	let paramValue = rule.value;
 	if (typeof rule.value === "string") if (require_utils.shouldRenderAsNumber(rule.value, parseNumbers)) paramValue = require_utils.parseNumber(rule.value, { parseNumbers });
-	else paramValue = /^'.*'$/g.test(value) ? value.replaceAll(/(^'|'$)/g, "") : value;
+	else paramValue = /^'.*'$/g.test(value) ? value.replaceAll(/(^'|'$)/g, "") : 	/* v8 ignore next -- @preserve */ value;
 	let paramName = "";
 	if (parameterized) params.push(paramValue);
 	else {
@@ -1854,9 +2471,9 @@ const processNumber = (value, fallback, parseNumbers) => require_utils.shouldRen
 */
 const defaultRuleProcessorPrisma = (rule, options = {}) => {
 	const { field, operator, value, valueSource } = rule;
-	// istanbul ignore next
+	// v8 ignore next
 	const { parseNumbers, preserveValueOrder } = options;
-	if (valueSource === "field" || require_utils.processMatchMode(rule)) return;
+	if (valueSource === "field" || require_utils.processMatchMode(rule)) return void 0;
 	const operatorLC = require_objectUtils.lc(operator);
 	switch (operatorLC) {
 		case "=": return { [field]: processNumber(value, value, parseNumbers) };
@@ -1914,13 +2531,16 @@ const defaultRuleProcessorPrisma = (rule, options = {}) => {
 */
 const defaultRuleProcessorSequelize = (rule, { parseNumbers, preserveValueOrder, context = {} } = {}) => {
 	const { sequelizeOperators: Op, sequelizeCol: col, sequelizeFn: fn } = context;
-	if (require_utils.processMatchMode(rule)) return;
+	if (require_utils.processMatchMode(rule)) return void 0;
 	const { field, operator, value, valueSource } = rule;
 	const valueIsField = valueSource === "field";
 	const operatorLC = require_objectUtils.lc(operator);
 	if (!Op || valueIsField && (!col || !fn && [
+		"contains",
 		"doesnotcontain",
+		"beginswith",
 		"doesnotbeginwith",
+		"endswith",
 		"doesnotendwith"
 	].includes(operatorLC))) return;
 	switch (operatorLC) {
@@ -1940,9 +2560,9 @@ const defaultRuleProcessorSequelize = (rule, { parseNumbers, preserveValueOrder,
 			}[operatorLC];
 			return { [field]: valueIsField && operatorLC === "=" ? { [Op.col]: value } : { [sequelizeOperator]: valueIsField ? col(value) : require_utils.shouldRenderAsNumber(value, parseNumbers) ? require_utils.parseNumber(value, { parseNumbers: "strict" }) : value } };
 		}
-		case "contains": return { [field]: { [Op.substring]: valueIsField ? col(value) : `${value}` } };
-		case "beginswith": return { [field]: { [Op.startsWith]: valueIsField ? col(value) : `${value}` } };
-		case "endswith": return { [field]: { [Op.endsWith]: valueIsField ? col(value) : `${value}` } };
+		case "contains": return { [field]: { [valueIsField ? Op.like : Op.substring]: valueIsField ? fn("CONCAT", "%", col(value), "%") : `${value}` } };
+		case "beginswith": return { [field]: { [valueIsField ? Op.like : Op.startsWith]: valueIsField ? fn("CONCAT", col(value), "%") : `${value}` } };
+		case "endswith": return { [field]: { [valueIsField ? Op.like : Op.endsWith]: valueIsField ? fn("CONCAT", "%", col(value)) : `${value}` } };
 		case "doesnotcontain": return { [field]: { [Op.notLike]: valueIsField ? fn("CONCAT", "%", col(value), "%") : `%${value}%` } };
 		case "doesnotbeginwith": return { [field]: { [Op.notLike]: valueIsField ? fn("CONCAT", col(value), "%") : `${value}%` } };
 		case "doesnotendwith": return { [field]: { [Op.notLike]: valueIsField ? fn("CONCAT", "%", col(value)) : `%${value}` } };
@@ -1972,6 +2592,68 @@ const defaultRuleProcessorSequelize = (rule, { parseNumbers, preserveValueOrder,
 	}
 };
 //#endregion
+//#region src/utils/formatQuery/defaultRuleProcessorSPARQL.ts
+const escapeDoubleQuotes = (v, escapeQuotes) => typeof v !== "string" || !escapeQuotes ? `${v}` : v.replaceAll(`"`, `\\"`);
+/**
+* Default rule processor used by {@link formatQuery} for "sparql" format.
+*
+* @group Export
+*/
+const defaultRuleProcessorSPARQL = (rule, opts = {}) => {
+	const { escapeQuotes, parseNumbers } = opts;
+	const { field, operator, value, valueSource } = rule;
+	const valueIsField = valueSource === "field";
+	const operatorTL = operator.toLowerCase();
+	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 require_utils.trimIfString(v);
+		if (typeof v === "number" || require_utils.shouldRenderAsNumber(v, parseNumbers)) return require_utils.trimIfString(v);
+		const s = typeof v === "string" ? v : JSON.stringify(v) ?? "";
+		if (s.startsWith("?") || s.startsWith("<") || s.includes(":")) return s;
+		return `"${escapeDoubleQuotes(s, escapeQuotes)}"`;
+	};
+	switch (operatorTL) {
+		case "=":
+		case "!=":
+		case "<":
+		case ">":
+		case "<=":
+		case ">=": return `${field} ${operatorTL} ${fmtVal(value)}`;
+		case "<>": return `${field} != ${fmtVal(value)}`;
+		case "contains": return `CONTAINS(${field}, ${fmtVal(value)})`;
+		case "doesnotcontain": return `!CONTAINS(${field}, ${fmtVal(value)})`;
+		case "beginswith": return `STRSTARTS(${field}, ${fmtVal(value)})`;
+		case "doesnotbeginwith": return `!STRSTARTS(${field}, ${fmtVal(value)})`;
+		case "endswith": return `STRENDS(${field}, ${fmtVal(value)})`;
+		case "doesnotendwith": return `!STRENDS(${field}, ${fmtVal(value)})`;
+		case "null": return `!BOUND(${field})`;
+		case "notnull": return `BOUND(${field})`;
+		case "in": {
+			const items = require_utils.toArray(value).map(fmtVal);
+			if (!items.length) return "";
+			return items.map((item) => `${field} = ${item}`).join(" || ");
+		}
+		case "notin": {
+			const items = require_utils.toArray(value).map(fmtVal);
+			if (!items.length) return "";
+			return items.map((item) => `${field} != ${item}`).join(" && ");
+		}
+		case "between": {
+			const arr = require_utils.toArray(value);
+			if (arr.length < 2) return "";
+			return `${field} >= ${fmtVal(arr[0])} && ${field} <= ${fmtVal(arr[1])}`;
+		}
+		case "notbetween": {
+			const arr = require_utils.toArray(value);
+			if (arr.length < 2) return "";
+			return `(${field} < ${fmtVal(arr[0])} || ${field} > ${fmtVal(arr[1])})`;
+		}
+		default: return `${field} ${operator} ${fmtVal(value)}`;
+	}
+};
+//#endregion
 //#region src/utils/formatQuery/formatQuery.ts
 /**
 * A collection of option presets for {@link formatQuery}, specifically for SQL-based formats.
@@ -2018,9 +2700,14 @@ const defaultRuleProcessors = {
 	prisma: defaultRuleProcessorPrisma,
 	sequelize: defaultRuleProcessorSequelize,
 	spel: defaultRuleProcessorSpEL,
-	sql: defaultRuleProcessorSQL
+	sql: defaultRuleProcessorSQL,
+	cypher: defaultRuleProcessorCypher,
+	gql: defaultRuleProcessorCypher,
+	sparql: defaultRuleProcessorSPARQL,
+	gremlin: defaultRuleProcessorGremlin,
+	diagnostics: defaultRuleProcessorSQL
 };
-/* istanbul ignore next */
+/* v8 ignore next -- @preserve */
 const defaultOperatorProcessor = (r) => r.operator;
 const defaultOperatorProcessors = {
 	cel: defaultOperatorProcessor,
@@ -2039,13 +2726,20 @@ const defaultOperatorProcessors = {
 	prisma: defaultOperatorProcessor,
 	sequelize: defaultOperatorProcessor,
 	spel: defaultOperatorProcessor,
-	sql: defaultOperatorProcessorSQL
+	sql: defaultOperatorProcessorSQL,
+	cypher: defaultOperatorProcessor,
+	gql: defaultOperatorProcessor,
+	sparql: defaultOperatorProcessor,
+	gremlin: defaultOperatorProcessor,
+	diagnostics: defaultOperatorProcessor
 };
 const defaultFallbackExpressions = {
 	cel: "1 == 1",
 	ldap: "",
 	mongodb: "\"$and\":[{\"$expr\":true}]",
 	natural_language: "1 is 1",
+	sparql: "1 = 1",
+	gremlin: "",
 	spel: "1 == 1",
 	sql: "(1 = 1)"
 };
@@ -2113,24 +2807,26 @@ function formatQuery(ruleGroup, optionParam = {}) {
 	const getOperators = (f, m) => require_utils.toFullOptionList(getOperators_option(f, m) ?? []);
 	const fallbackExpression = fallbackExpression_option ?? defaultFallbackExpressions[format] ?? defaultFallbackExpressions.sql;
 	let validationMap = {};
-	// istanbul ignore else
+	// v8 ignore else
 	if (typeof validator === "function") {
 		const validationResult = validator(ruleGroup);
 		if (typeof validationResult === "boolean") {
-			// istanbul ignore else
-			if (!validationResult) return format === "parameterized" ? {
-				sql: fallbackExpression,
-				params: []
-			} : 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;
+			// v8 ignore else
+			if (!validationResult) {
+				if (format !== "diagnostics") return format === "parameterized" ? {
+					sql: fallbackExpression,
+					params: []
+				} : 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;
+			}
 		} else validationMap = validationResult;
 	}
 	const validatorMap = {};
 	const uniqueFields = require_utils.toFlatOptionArray(fields);
 	for (const f of uniqueFields)
- // istanbul ignore else
+ // v8 ignore else
 	if (typeof f.validator === "function") validatorMap[f.value ?? f.name] = f.validator;
 	const validateRule = (rule) => {
 		let validationResult;
@@ -2140,7 +2836,7 @@ function formatQuery(ruleGroup, optionParam = {}) {
 			const fieldArr = uniqueFields.filter((f) => f.name === rule.field);
 			if (fieldArr.length > 0) {
 				const field = fieldArr[0];
-				// istanbul ignore else
+				// v8 ignore else
 				if (typeof field.validator === "function") fieldValidator = field.validator;
 			}
 		}
@@ -2184,6 +2880,11 @@ function formatQuery(ruleGroup, optionParam = {}) {
 		case "prisma": return defaultRuleGroupProcessorPrisma(ruleGroup, finalOptions);
 		case "drizzle": return defaultRuleGroupProcessorDrizzle(ruleGroup, finalOptions);
 		case "sequelize": return defaultRuleGroupProcessorSequelize(ruleGroup, finalOptions);
+		case "cypher":
+		case "gql": return defaultRuleGroupProcessorCypher(ruleGroup, finalOptions);
+		case "sparql": return defaultRuleGroupProcessorSPARQL(ruleGroup, finalOptions);
+		case "gremlin": return defaultRuleGroupProcessorGremlin(ruleGroup, finalOptions);
+		case "diagnostics": return defaultRuleGroupProcessorDiagnostics(ruleGroup, finalOptions);
 		default: return "";
 	}
 }
@@ -2241,6 +2942,7 @@ const defaultValueProcessorSpELByRule = defaultRuleProcessorSpEL;
 exports.bigIntJsonParseReviver = require_utils.bigIntJsonParseReviver;
 exports.bigIntJsonStringifyReplacer = require_utils.bigIntJsonStringifyReplacer;
 exports.celCombinatorMap = require_utils.celCombinatorMap;
+exports.cypherCombinatorMap = cypherCombinatorMap;
 exports.defaultCELValueProcessor = defaultCELValueProcessor;
 exports.defaultExportOperatorMap = defaultExportOperatorMap;
 exports.defaultMongoDBValueProcessor = defaultMongoDBValueProcessor;
@@ -2248,8 +2950,11 @@ exports.defaultNLTranslations = require_utils.defaultNLTranslations;
 exports.defaultOperatorProcessorNL = defaultOperatorProcessorNL;
 exports.defaultOperatorProcessorSQL = defaultOperatorProcessorSQL;
 exports.defaultRuleGroupProcessorCEL = defaultRuleGroupProcessorCEL;
+exports.defaultRuleGroupProcessorCypher = defaultRuleGroupProcessorCypher;
+exports.defaultRuleGroupProcessorDiagnostics = defaultRuleGroupProcessorDiagnostics;
 exports.defaultRuleGroupProcessorDrizzle = defaultRuleGroupProcessorDrizzle;
 exports.defaultRuleGroupProcessorElasticSearch = defaultRuleGroupProcessorElasticSearch;
+exports.defaultRuleGroupProcessorGremlin = defaultRuleGroupProcessorGremlin;
 exports.defaultRuleGroupProcessorJSONata = defaultRuleGroupProcessorJSONata;
 exports.defaultRuleGroupProcessorJsonLogic = defaultRuleGroupProcessorJsonLogic;
 exports.defaultRuleGroupProcessorLDAP = defaultRuleGroupProcessorLDAP;
@@ -2258,12 +2963,15 @@ exports.defaultRuleGroupProcessorMongoDBQuery = defaultRuleGroupProcessorMongoDB
 exports.defaultRuleGroupProcessorNL = defaultRuleGroupProcessorNL;
 exports.defaultRuleGroupProcessorParameterized = defaultRuleGroupProcessorParameterized;
 exports.defaultRuleGroupProcessorPrisma = defaultRuleGroupProcessorPrisma;
+exports.defaultRuleGroupProcessorSPARQL = defaultRuleGroupProcessorSPARQL;
 exports.defaultRuleGroupProcessorSQL = defaultRuleGroupProcessorSQL;
 exports.defaultRuleGroupProcessorSequelize = defaultRuleGroupProcessorSequelize;
 exports.defaultRuleGroupProcessorSpEL = defaultRuleGroupProcessorSpEL;
 exports.defaultRuleProcessorCEL = defaultRuleProcessorCEL;
+exports.defaultRuleProcessorCypher = defaultRuleProcessorCypher;
 exports.defaultRuleProcessorDrizzle = defaultRuleProcessorDrizzle;
 exports.defaultRuleProcessorElasticSearch = defaultRuleProcessorElasticSearch;
+exports.defaultRuleProcessorGremlin = defaultRuleProcessorGremlin;
 exports.defaultRuleProcessorJSONata = defaultRuleProcessorJSONata;
 exports.defaultRuleProcessorJsonLogic = defaultRuleProcessorJsonLogic;
 exports.defaultRuleProcessorLDAP = defaultRuleProcessorLDAP;
@@ -2272,6 +2980,7 @@ exports.defaultRuleProcessorMongoDBQuery = defaultRuleProcessorMongoDBQuery;
 exports.defaultRuleProcessorNL = defaultRuleProcessorNL;
 exports.defaultRuleProcessorParameterized = defaultRuleProcessorParameterized;
 exports.defaultRuleProcessorPrisma = defaultRuleProcessorPrisma;
+exports.defaultRuleProcessorSPARQL = defaultRuleProcessorSPARQL;
 exports.defaultRuleProcessorSQL = defaultRuleProcessorSQL;
 exports.defaultRuleProcessorSequelize = defaultRuleProcessorSequelize;
 exports.defaultRuleProcessorSpEL = defaultRuleProcessorSpEL;