@react-querybuilder/core 8.14.3 → 8.15.0

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

@@ -413,6 +413,8 @@ const standardClassnames = {
 	dndCopy: "dndCopy",
 	dndGroup: "dndGroup",
 	dndDropNotAllowed: "dndDropNotAllowed",
+	dndPreviewPosition: "dndPreviewPosition",
+	dndHidden: "dndHidden",
 	dragHandle: "queryBuilder-dragHandle",
 	disabled: "queryBuilder-disabled",
 	muted: "queryBuilder-muted",
@@ -469,6 +471,8 @@ const defaultControlClassnames = {
 	dndGroup: "",
 	dndCopy: "",
 	dndDropNotAllowed: "",
+	dndPreviewPosition: "",
+	dndHidden: "",
 	disabled: "",
 	valueListItem: "",
 	branches: "",
@@ -613,7 +617,7 @@ const toArray = (a, { retainEmptyStrings } = {}) => Array.isArray(a) ? a.map((v)
 const nullFreeArray = (arr) => arr.every((el) => el === false || (el ?? false) !== false);
 //#endregion
 //#region src/utils/clsx.ts
-// istanbul ignore next
+/* v8 ignore start -- @preserve */
 function toVal(mix) {
 	let k;
 	let y;
@@ -633,12 +637,13 @@ function toVal(mix) {
 	}
 	return str;
 }
+/* v8 ignore stop -- @preserve */
 /**
 * Vendored/adapted version of the `clsx` package.
 *
 * **NOTE:** Prefer the official package from npm outside the context of React Query Builder.
 */
-// istanbul ignore next
+// v8 ignore next
 function clsx(...args) {
 	let i = 0;
 	let tmp;
@@ -656,7 +661,7 @@ function clsx(...args) {
 /**
 * Converts a value to lowercase if it's a string, otherwise returns the value as is.
 */
-// istanbul ignore next
+// v8 ignore next
 const lc = (v) => typeof v === "string" ? v.toLowerCase() : v;
 /**
 * Regex matching numeric strings. Passes for positive/negative integers, decimals,
@@ -784,8 +789,9 @@ const defaultValidator = (query) => {
 	* Replace this with your custom rule validator.
 	*/
 	const validateRule = (rule) => {
-		// istanbul ignore else
+		/* v8 ignore start -- @preserve */
 		if (rule.id) result[rule.id];
+		/* v8 ignore stop -- @preserve */
 	};
 	const validateGroup = (rg) => {
 		const reasons = [];
@@ -796,7 +802,7 @@ const defaultValidator = (query) => {
 			if (invalidICs) reasons.push(groupInvalidReasons.invalidIndependentCombinators);
 		}
 		if (isRuleGroupType(rg) && !defaultCombinators.map((c) => c.name).includes(rg.combinator) && rg.rules.length > 1) reasons.push(groupInvalidReasons.invalidCombinator);
-		/* istanbul ignore else */
+		/* v8 ignore else -- @preserve */
 		if (rg.id) result[rg.id] = reasons.length > 0 ? {
 			valid: false,
 			reasons
@@ -957,7 +963,7 @@ function getFirstOption(arr) {
 	if (!Array.isArray(arr) || arr.length === 0) return null;
 	else if (isFlexibleOptionGroupArray(arr, { allowEmpty: true })) {
 		for (const og of arr) if (og.options.length > 0) return og.options[0].value ?? og.options[0].name;
-		// istanbul ignore next
+		// v8 ignore next
 		return null;
 	}
 	return arr[0].value ?? arr[0].name;
@@ -1004,7 +1010,7 @@ const uniqOptList = (originalArray) => {
 	return uniqByIdentifier(originalArray.map((o) => toFullOption(o)));
 };
 const prepareOptionList = (props) => {
-	// istanbul ignore next
+	// v8 ignore next
 	const { optionList: optionListPropOriginal, baseOption = {}, labelMap = {}, placeholder: { placeholderName = "~", placeholderLabel = defaultPlaceholderLabel, placeholderGroupLabel = defaultPlaceholderLabel } = {}, autoSelectOption = true } = props;
 	const defaultOption = {
 		id: placeholderName,
@@ -1152,7 +1158,7 @@ const isRuleOrGroupValid = (rg, validationResult, validator) => {
 	if (typeof validator === "function" && !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;
@@ -1271,7 +1277,7 @@ const numerifyValues = (rg, options) => ({
 		};
 		const valAsArray = toArray(r.value, { retainEmptyStrings: true }).map((v) => parseNumber(v, { parseNumbers }));
 		if (valAsArray.every((v) => typeof v === "number")) {
-			// istanbul ignore else
+			// v8 ignore else
 			if (valAsArray.length > 1) return {
 				...r,
 				value: valAsArray
@@ -1567,7 +1573,8 @@ const mongoDbFallback = { $and: [{ $expr: true }] };
 * @group Export
 */
 const defaultRuleGroupProcessorMongoDBQuery = (ruleGroup, options, meta) => {
-	const { fields, getParseNumberBoolean, placeholderFieldName, placeholderOperatorName, placeholderValueName, ruleProcessor, validateRule, validationMap } = options;
+	const { context, fields, getParseNumberBoolean, placeholderFieldName, placeholderOperatorName, placeholderValueName, ruleProcessor, validateRule, validationMap } = options;
+	const { inExpressionContext } = context ?? {};
 	const processRuleGroup = (rg, outermost) => {
 		if (!isRuleOrGroupValid(rg, validationMap[rg.id ?? ""])) return outermost ? mongoDbFallback : false;
 		const combinator = `$${lc(rg.combinator)}`;
@@ -1591,7 +1598,7 @@ const defaultRuleGroupProcessorMongoDBQuery = (ruleGroup, options, meta) => {
 			}, meta);
 		}).filter(Boolean);
 		const result = expressions.length > 0 ? expressions.length === 1 && !hasChildRules ? expressions[0] : { [combinator]: expressions } : mongoDbFallback;
-		return rg.not ? { $not: result } : result;
+		return rg.not ? inExpressionContext ? { $not: result } : { $nor: [result] } : result;
 	};
 	return processRuleGroup(convertFromIC(ruleGroup), true);
 };
@@ -1632,7 +1639,8 @@ const defaultRuleProcessorMongoDBQuery = (rule, options = {}) => {
 			ruleProcessor: defaultRuleProcessorMongoDBQuery,
 			context: {
 				...options.context,
-				avoidFieldsAsKeys: true
+				avoidFieldsAsKeys: true,
+				inExpressionContext: true
 			}
 		});
 		const filteredCount = { $size: { $ifNull: [{ $filter: {
@@ -1935,22 +1943,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 = lc(operator);
 	const valueIsField = valueSource === "field";
 	const asFieldOrValue = (v) => valueIsField ? columns[v] : v;
-	if (!column) return;
+	if (!column) return void 0;
 	const matchEval = 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(transformQuery(rule.value, { ruleProcessor: (r) => ({
@@ -2039,7 +2047,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) => {
@@ -2243,7 +2251,7 @@ const defaultRuleGroupProcessorMongoDB = (ruleGroup, options, meta) => {
 			}, meta);
 		}).filter(Boolean);
 		const result = expressions.length > 0 ? expressions.length === 1 && !hasChildRules ? expressions[0] : `${combinator}:[${expressions.join(",")}]` : fallbackExpression;
-		return rg.not ? `"$not":${isBracketed(result) ? result : `{${result}}`}` : result;
+		return rg.not ? `"$nor":[${isBracketed(result) ? result : `{${result}}`}]` : result;
 	};
 	const processedQuery = processRuleGroup(convertFromIC(ruleGroup), true);
 	return isBracketed(processedQuery) ? processedQuery : `{${processedQuery}}`;
@@ -2258,7 +2266,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 = isRuleGroupTypeIC(rg) && rg.rules.some((r) => typeof r === "string" && lc(r) === "xor") ? convertFromIC(rg) : rg;
 		const processedRules = [];
 		let precedingCombinator = "";
@@ -2270,7 +2278,7 @@ const defaultRuleGroupProcessorNL = (ruleGroup, options) => {
 			}
 			if (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);
@@ -2346,7 +2354,7 @@ const defaultRuleGroupProcessorParameterized = (ruleGroup, options) => {
 		if (!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" && isPojo(customParams)) {
 			Object.assign(paramsNamed, customParams);
@@ -2355,7 +2363,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;
@@ -2366,7 +2374,7 @@ const defaultRuleGroupProcessorParameterized = (ruleGroup, options) => {
 			}
 			if (isRuleGroup(rule)) {
 				const processedGroup = processRuleGroup(rule, rg.rules.length === 1);
-				// istanbul ignore else
+				// v8 ignore else
 				if (processedGroup) {
 					if (!firstRule && precedingCombinator) {
 						processedRules.push(precedingCombinator);
@@ -2449,10 +2457,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();
@@ -2475,7 +2483,7 @@ 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] : { [lc(combinator) === "or" ? Op.or : Op.and]: expressions };
 		return rg.not ? { [Op.not]: result } : result;
 	};
@@ -2491,7 +2499,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;
@@ -2502,7 +2510,7 @@ const defaultRuleGroupProcessorSQL = (ruleGroup, options) => {
 			}
 			if (isRuleGroup(rule)) {
 				const processedGroup = processRuleGroup(rule, rg.rules.length === 1);
-				// istanbul ignore else
+				// v8 ignore else
 				if (processedGroup) {
 					if (!firstRule && precedingCombinator) {
 						processedRules.push(precedingCombinator);
@@ -2538,6 +2546,325 @@ 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" && 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 = 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 (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 (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/defaultRuleProcessorElasticSearch.ts
 const rangeOperatorMap = {
 	"<": "lt",
@@ -2916,12 +3243,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.
 *
@@ -2939,7 +3266,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";
@@ -2995,7 +3322,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.
@@ -3004,7 +3331,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(lc(key), value);
@@ -3033,8 +3360,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 = getQuotedFieldName(fieldData?.label ?? field, {
 		quoteFieldNamesWith,
 		fieldIdentifierSeparator
@@ -3140,7 +3467,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";
@@ -3159,6 +3486,7 @@ const defaultRuleProcessorParameterized = (rule, opts, meta) => {
 	});
 	const ruleField = wrapFieldName(rule.field);
 	const matchEval = processMatchMode(rule);
+	/* v8 ignore start -- @preserve */
 	if (matchEval === false) return;
 	else if (matchEval) {
 		if (opts?.preset !== "postgresql") return finalize("");
@@ -3171,7 +3499,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) {
@@ -3186,6 +3513,7 @@ const defaultRuleProcessorParameterized = (rule, opts, meta) => {
 			}
 		}
 	}
+	/* v8 ignore stop -- @preserve */
 	const value = valueProcessor(rule, {
 		parseNumbers,
 		quoteFieldNamesWith,
@@ -3226,7 +3554,7 @@ const defaultRuleProcessorParameterized = (rule, opts, meta) => {
 	}
 	let paramValue = rule.value;
 	if (typeof rule.value === "string") if (shouldRenderAsNumber(rule.value, parseNumbers)) paramValue = 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 {
@@ -3245,9 +3573,9 @@ const processNumber = (value, fallback, parseNumbers) => shouldRenderAsNumber(va
 */
 const defaultRuleProcessorPrisma = (rule, options = {}) => {
 	const { field, operator, value, valueSource } = rule;
-	// istanbul ignore next
+	// v8 ignore next
 	const { parseNumbers, preserveValueOrder } = options;
-	if (valueSource === "field" || processMatchMode(rule)) return;
+	if (valueSource === "field" || processMatchMode(rule)) return void 0;
 	const operatorLC = lc(operator);
 	switch (operatorLC) {
 		case "=": return { [field]: processNumber(value, value, parseNumbers) };
@@ -3305,7 +3633,7 @@ const defaultRuleProcessorPrisma = (rule, options = {}) => {
 */
 const defaultRuleProcessorSequelize = (rule, { parseNumbers, preserveValueOrder, context = {} } = {}) => {
 	const { sequelizeOperators: Op, sequelizeCol: col, sequelizeFn: fn } = context;
-	if (processMatchMode(rule)) return;
+	if (processMatchMode(rule)) return void 0;
 	const { field, operator, value, valueSource } = rule;
 	const valueIsField = valueSource === "field";
 	const operatorLC = lc(operator);
@@ -3409,9 +3737,10 @@ const defaultRuleProcessors = {
 	prisma: defaultRuleProcessorPrisma,
 	sequelize: defaultRuleProcessorSequelize,
 	spel: defaultRuleProcessorSpEL,
-	sql: defaultRuleProcessorSQL
+	sql: defaultRuleProcessorSQL,
+	diagnostics: defaultRuleProcessorSQL
 };
-/* istanbul ignore next */
+/* v8 ignore next -- @preserve */
 const defaultOperatorProcessor = (r) => r.operator;
 const defaultOperatorProcessors = {
 	cel: defaultOperatorProcessor,
@@ -3430,7 +3759,8 @@ const defaultOperatorProcessors = {
 	prisma: defaultOperatorProcessor,
 	sequelize: defaultOperatorProcessor,
 	spel: defaultOperatorProcessor,
-	sql: defaultOperatorProcessorSQL
+	sql: defaultOperatorProcessorSQL,
+	diagnostics: defaultOperatorProcessor
 };
 const defaultFallbackExpressions = {
 	cel: "1 == 1",
@@ -3504,24 +3834,26 @@ function formatQuery(ruleGroup, optionParam = {}) {
 	const getOperators = (f, m) => 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 = 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;
@@ -3531,7 +3863,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;
 			}
 		}
@@ -3575,6 +3907,7 @@ function formatQuery(ruleGroup, optionParam = {}) {
 		case "prisma": return defaultRuleGroupProcessorPrisma(ruleGroup, finalOptions);
 		case "drizzle": return defaultRuleGroupProcessorDrizzle(ruleGroup, finalOptions);
 		case "sequelize": return defaultRuleGroupProcessorSequelize(ruleGroup, finalOptions);
+		case "diagnostics": return defaultRuleGroupProcessorDiagnostics(ruleGroup, finalOptions);
 		default: return "";
 	}
 }
@@ -3725,6 +4058,7 @@ const generateAccessibleDescription = (params) => pathsAreEqual([], params.path)
 //#endregion
 //#region src/utils/generateID.ts
 const cryptoModule = globalThis.crypto;
+const uuidV4regex = /^[\da-f]{8}-[\da-f]{4}-4[\da-f]{3}-[89ab][\da-f]{3}-[\da-f]{12}$/i;
 /**
 * Default `id` generator. Generates a valid v4 UUID. Uses `crypto.randomUUID()`
 * when available, otherwise uses an alternate method based on `getRandomValues`.
@@ -3734,11 +4068,11 @@ const cryptoModule = globalThis.crypto;
 * ```
 * @returns Valid v4 UUID
 */
-// istanbul ignore next
+// v8 ignore next
 let generateID = () => "00-0-4-2-000".replaceAll(/[^-]/g, (s) => ((Math.random() + Math.trunc(s)) * 65536 >> Number.parseInt(s)).toString(16).padStart(4, "0"));
-// istanbul ignore else
+// v8 ignore else
 if (cryptoModule) {
-	// istanbul ignore else
+	// v8 ignore else
 	if (typeof cryptoModule.randomUUID === "function") generateID = () => cryptoModule.randomUUID();
 	else if (typeof cryptoModule.getRandomValues === "function") {
 		const position19vals = "89ab";
@@ -3771,7 +4105,7 @@ const dummyFD$1 = {
 * `FullOption<MatchMode>[]` of all match modes by default.
 */
 const getMatchModesUtil = (fieldData, getMatchModes) => {
-	const fd = fieldData ? toFullOption(fieldData) : dummyFD$1;
+	const fd = fieldData ? toFullOption(fieldData) : 	/* v8 ignore next -- @preserve */ dummyFD$1;
 	let matchModes = fd.matchModes ?? false;
 	if (!matchModes && getMatchModes) matchModes = getMatchModes(fd.value, { fieldData: fd });
 	if (matchModes === true) return defaultMatchModes;
@@ -3833,7 +4167,7 @@ const getValueSourcesUtil = (fieldData, operator, getValueSources) => {
 const mergeAnyTranslations = (base, ...otherTranslations) => {
 	const result = { ...base };
 	for (const translations of otherTranslations)
- // istanbul ignore else
+ // v8 ignore else
 	if (translations) for (const key of objectKeys(translations)) {
 		if (isUnsafeKey(key)) continue;
 		if (result[key]) result[key] = {
@@ -3894,6 +4228,8 @@ const mergeClassnames = (...args) => ({
 	dndCopy: joinClassnamesByName("dndCopy", args),
 	dndGroup: joinClassnamesByName("dndGroup", args),
 	dndDropNotAllowed: joinClassnamesByName("dndDropNotAllowed", args),
+	dndPreviewPosition: joinClassnamesByName("dndPreviewPosition", args),
+	dndHidden: joinClassnamesByName("dndHidden", args),
 	disabled: joinClassnamesByName("disabled", args),
 	valueListItem: joinClassnamesByName("valueListItem", args),
 	matchMode: joinClassnamesByName("matchMode", args),
@@ -3989,7 +4325,7 @@ const regenerateIDs = (subject, { idGenerator = generateID } = {}) => {
 		...subject,
 		id: idGenerator()
 	};
-	// istanbul ignore else
+	// v8 ignore else
 	if (Array.isArray(newGroup.rules)) newGroup.rules = subject.rules.map((r) => typeof r === "string" ? r : isRuleGroup(r) ? regenerateIDs(r, { idGenerator }) : regenerateID(r, { idGenerator }));
 	return newGroup;
 };
@@ -4321,6 +4657,7 @@ exports.defaultPlaceholderValueGroupLabel = defaultPlaceholderValueGroupLabel;
 exports.defaultPlaceholderValueLabel = defaultPlaceholderValueLabel;
 exports.defaultPlaceholderValueName = defaultPlaceholderValueName;
 exports.defaultRuleGroupProcessorCEL = defaultRuleGroupProcessorCEL;
+exports.defaultRuleGroupProcessorDiagnostics = defaultRuleGroupProcessorDiagnostics;
 exports.defaultRuleGroupProcessorDrizzle = defaultRuleGroupProcessorDrizzle;
 exports.defaultRuleGroupProcessorElasticSearch = defaultRuleGroupProcessorElasticSearch;
 exports.defaultRuleGroupProcessorJSONata = defaultRuleGroupProcessorJSONata;
@@ -4456,5 +4793,6 @@ exports.uniqOptGroups = uniqOptGroups;
 exports.uniqOptList = uniqOptList;
 exports.update = update;
 exports.updateInPlace = updateInPlace;
+exports.uuidV4regex = uuidV4regex;
 
 //# sourceMappingURL=react-querybuilder_core.cjs.development.js.map