@react-querybuilder/core 8.22.1 → 8.22.3

package/dist/react-querybuilder_core.d.mts

@@ -5671,6 +5671,14 @@ interface QueryManagerOptions<F extends FullField = FullField, O extends FullOpe
   autoSelectOperator?: boolean;
   /** When `false`, an empty placeholder option is prepended to each value list. */
   autoSelectValue?: boolean;
+  /**
+   * Translations, accepting the same shape as the `translations` prop. Only the placeholder
+   * properties of `fields`, `operators`, and `values` are used, and only when the corresponding
+   * `autoSelect*` option is `false`; the remaining keys describe UI elements that have no
+   * meaning outside the `QueryBuilder` component. Labels are typed as `unknown` so the React
+   * `Translations` type, whose labels are `ReactNode`, can be passed as-is.
+   */
+  translations?: Partial<BaseTranslations<unknown>>;
   /** The default `field` for rules created by {@link QueryManager.createRule}. */
   getDefaultField?: string | ((fieldsData: FullOptionList<F>) => string);
   /** The default `operator` for a given field. */
@@ -5885,6 +5893,50 @@ declare class QueryManager<RG extends RuleGroupTypeAny = RuleGroupType, F extend
    * `targetPathOrID` and `sourcePathOrID`.
    */
   group(sourcePathOrID: Path | string, targetPathOrID: Path | string, options?: GroupOptions & StrictOptions): this;
+  /**
+   * The options currently in effect, as a frozen shallow copy. Reflects everything applied by
+   * the constructor and any subsequent {@link QueryManager.reconfigure} calls, but not the
+   * defaults filled in for options that were never provided.
+   */
+  getOptions(): Readonly<QueryManagerOptions<F, O, C>>;
+  /**
+   * Updates the manager's configuration in place, keeping the current query, the undo/redo
+   * history, and every subscriber. Use this to propagate new `translations`, `fields`,
+   * `operators`, and so on without discarding state:
+   *
+   * ```ts
+   * q.reconfigure({ translations: { fields: { placeholderLabel: 'Choisir un champ' } } });
+   * ```
+   *
+   * The incoming options are shallow-merged over the current ones, so keys left out are
+   * preserved. Passing a key explicitly as `undefined` resets it to its default. Object-valued
+   * options like `translations` are replaced wholesale rather than deep-merged — spread the
+   * current value in yourself to patch one key. Pass `{ replace: true }` to discard the
+   * existing options entirely and start from the incoming set.
+   *
+   * The query is never rewritten, even when the new options no longer describe it: a rule whose
+   * `field` is not in the new `fields` list is left as-is. Call
+   * {@link QueryManager.validate validate} to detect that, or `setQuery(getQuery())` to
+   * re-normalize.
+   *
+   * History options are honored immediately: lowering `maxHistory` trims the undo stack, and
+   * turning history off clears both stacks. Subscribers are notified once, and
+   * {@link QueryManager.getConfigVersion} is incremented, even inside a
+   * {@link QueryManager.batch batch} — configuration is not part of a batch's rollback.
+   */
+  reconfigure(options: Partial<QueryManagerOptions<F, O, C>>, config?: {
+    replace?: boolean;
+  }): this;
+  /**
+   * A counter incremented by every {@link QueryManager.reconfigure} call. Because reconfiguring
+   * leaves the query object untouched, subscribers that compare query identity alone cannot see
+   * it; this provides a snapshot that does change.
+   *
+   * Bound to the instance, so it can be passed directly to `useSyncExternalStore` alongside
+   * {@link QueryManager.subscribe}. The `useQueryManager` hook from `react-querybuilder`
+   * already does this.
+   */
+  getConfigVersion: () => number;
   /**
    * Creates an independent manager with the same configuration and the current query.
    *

package/dist/react-querybuilder_core.legacy-esm.d.ts

@@ -5671,6 +5671,14 @@ interface QueryManagerOptions<F extends FullField = FullField, O extends FullOpe
   autoSelectOperator?: boolean;
   /** When `false`, an empty placeholder option is prepended to each value list. */
   autoSelectValue?: boolean;
+  /**
+   * Translations, accepting the same shape as the `translations` prop. Only the placeholder
+   * properties of `fields`, `operators`, and `values` are used, and only when the corresponding
+   * `autoSelect*` option is `false`; the remaining keys describe UI elements that have no
+   * meaning outside the `QueryBuilder` component. Labels are typed as `unknown` so the React
+   * `Translations` type, whose labels are `ReactNode`, can be passed as-is.
+   */
+  translations?: Partial<BaseTranslations<unknown>>;
   /** The default `field` for rules created by {@link QueryManager.createRule}. */
   getDefaultField?: string | ((fieldsData: FullOptionList<F>) => string);
   /** The default `operator` for a given field. */
@@ -5885,6 +5893,50 @@ declare class QueryManager<RG extends RuleGroupTypeAny = RuleGroupType, F extend
    * `targetPathOrID` and `sourcePathOrID`.
    */
   group(sourcePathOrID: Path | string, targetPathOrID: Path | string, options?: GroupOptions & StrictOptions): this;
+  /**
+   * The options currently in effect, as a frozen shallow copy. Reflects everything applied by
+   * the constructor and any subsequent {@link QueryManager.reconfigure} calls, but not the
+   * defaults filled in for options that were never provided.
+   */
+  getOptions(): Readonly<QueryManagerOptions<F, O, C>>;
+  /**
+   * Updates the manager's configuration in place, keeping the current query, the undo/redo
+   * history, and every subscriber. Use this to propagate new `translations`, `fields`,
+   * `operators`, and so on without discarding state:
+   *
+   * ```ts
+   * q.reconfigure({ translations: { fields: { placeholderLabel: 'Choisir un champ' } } });
+   * ```
+   *
+   * The incoming options are shallow-merged over the current ones, so keys left out are
+   * preserved. Passing a key explicitly as `undefined` resets it to its default. Object-valued
+   * options like `translations` are replaced wholesale rather than deep-merged — spread the
+   * current value in yourself to patch one key. Pass `{ replace: true }` to discard the
+   * existing options entirely and start from the incoming set.
+   *
+   * The query is never rewritten, even when the new options no longer describe it: a rule whose
+   * `field` is not in the new `fields` list is left as-is. Call
+   * {@link QueryManager.validate validate} to detect that, or `setQuery(getQuery())` to
+   * re-normalize.
+   *
+   * History options are honored immediately: lowering `maxHistory` trims the undo stack, and
+   * turning history off clears both stacks. Subscribers are notified once, and
+   * {@link QueryManager.getConfigVersion} is incremented, even inside a
+   * {@link QueryManager.batch batch} — configuration is not part of a batch's rollback.
+   */
+  reconfigure(options: Partial<QueryManagerOptions<F, O, C>>, config?: {
+    replace?: boolean;
+  }): this;
+  /**
+   * A counter incremented by every {@link QueryManager.reconfigure} call. Because reconfiguring
+   * leaves the query object untouched, subscribers that compare query identity alone cannot see
+   * it; this provides a snapshot that does change.
+   *
+   * Bound to the instance, so it can be passed directly to `useSyncExternalStore` alongside
+   * {@link QueryManager.subscribe}. The `useQueryManager` hook from `react-querybuilder`
+   * already does this.
+   */
+  getConfigVersion: () => number;
   /**
    * Creates an independent manager with the same configuration and the current query.
    *

package/dist/react-querybuilder_core.legacy-esm.js

@@ -6891,6 +6891,7 @@ var _historyEnabled = /* @__PURE__ */ new WeakMap();
 var _maxHistory = /* @__PURE__ */ new WeakMap();
 var _coalesceMs = /* @__PURE__ */ new WeakMap();
 var _now = /* @__PURE__ */ new WeakMap();
+var _configVersion = /* @__PURE__ */ new WeakMap();
 var _past = /* @__PURE__ */ new WeakMap();
 var _future = /* @__PURE__ */ new WeakMap();
 var _lastSig = /* @__PURE__ */ new WeakMap();
@@ -6928,7 +6929,6 @@ _Symbol$iterator = Symbol.iterator;
 */
 var QueryManager = class QueryManager {
 	constructor(query, options = {}) {
-		var _options$idGenerator, _options$validator, _options$strict, _options$respectDisab, _options$history, _historyOptions$maxHi, _historyOptions$coale, _options$now, _options$operators, _options$combinators;
 		_classPrivateMethodInitSpec(this, _QueryManager_brand);
 		_classPrivateFieldInitSpec(this, _query, void 0);
 		_classPrivateFieldInitSpec(this, _options, void 0);
@@ -6946,6 +6946,7 @@ var QueryManager = class QueryManager {
 		_classPrivateFieldInitSpec(this, _maxHistory, void 0);
 		_classPrivateFieldInitSpec(this, _coalesceMs, void 0);
 		_classPrivateFieldInitSpec(this, _now, void 0);
+		_classPrivateFieldInitSpec(this, _configVersion, 0);
 		_classPrivateFieldInitSpec(this, _past, []);
 		_classPrivateFieldInitSpec(this, _future, []);
 		_classPrivateFieldInitSpec(this, _lastSig, void 0);
@@ -6968,6 +6969,20 @@ var QueryManager = class QueryManager {
 			"getQuery",
 			() => _classPrivateFieldGet2(_query, this)
 		);
+		_defineProperty(
+			this,
+			/**
+			* A counter incremented by every {@link QueryManager.reconfigure} call. Because reconfiguring
+			* leaves the query object untouched, subscribers that compare query identity alone cannot see
+			* it; this provides a snapshot that does change.
+			*
+			* Bound to the instance, so it can be passed directly to `useSyncExternalStore` alongside
+			* {@link QueryManager.subscribe}. The `useQueryManager` hook from `react-querybuilder`
+			* already does this.
+			*/
+			"getConfigVersion",
+			() => _classPrivateFieldGet2(_configVersion, this)
+		);
 		_defineProperty(
 			this,
 			/**
@@ -6993,35 +7008,7 @@ var QueryManager = class QueryManager {
 				};
 			}
 		);
-		_classPrivateFieldSet2(_options, this, options);
-		_classPrivateFieldSet2(_idGenerator, this, (_options$idGenerator = options.idGenerator) !== null && _options$idGenerator !== void 0 ? _options$idGenerator : generateID);
-		_classPrivateFieldSet2(_validator, this, (_options$validator = options.validator) !== null && _options$validator !== void 0 ? _options$validator : defaultValidator);
-		_classPrivateFieldSet2(_strict, this, (_options$strict = options.strict) !== null && _options$strict !== void 0 ? _options$strict : false);
-		_classPrivateFieldSet2(_respectDisabled, this, (_options$respectDisab = options.respectDisabled) !== null && _options$respectDisab !== void 0 ? _options$respectDisab : true);
-		_classPrivateFieldSet2(_onInvalidTarget, this, options.onInvalidTarget);
-		const history = (_options$history = options.history) !== null && _options$history !== void 0 ? _options$history : false;
-		const historyOptions = typeof history === "object" ? history : {};
-		_classPrivateFieldSet2(_historyEnabled, this, history !== false);
-		_classPrivateFieldSet2(_maxHistory, this, (_historyOptions$maxHi = historyOptions.maxHistory) !== null && _historyOptions$maxHi !== void 0 ? _historyOptions$maxHi : 50);
-		_classPrivateFieldSet2(_coalesceMs, this, (_historyOptions$coale = historyOptions.coalesceMs) !== null && _historyOptions$coale !== void 0 ? _historyOptions$coale : 500);
-		_classPrivateFieldSet2(_now, this, (_options$now = options.now) !== null && _options$now !== void 0 ? _options$now : Date.now);
-		const { optionList: fields, optionsMap: fieldMap } = prepareOptionList({
-			optionList: options.fields,
-			baseOption: options.baseField,
-			autoSelectOption: options.autoSelectField
-		});
-		_classPrivateFieldSet2(_fields, this, freeze(fields, true));
-		_classPrivateFieldSet2(_fieldMap, this, freeze(fieldMap, true));
-		_classPrivateFieldSet2(_operators, this, prepareOptionList({
-			optionList: (_options$operators = options.operators) !== null && _options$operators !== void 0 ? _options$operators : defaultOperators,
-			baseOption: options.baseOperator,
-			labelMap: defaultOperatorLabelMap,
-			autoSelectOption: options.autoSelectOperator
-		}).optionList);
-		_classPrivateFieldSet2(_combinators, this, freeze(prepareOptionList({
-			optionList: (_options$combinators = options.combinators) !== null && _options$combinators !== void 0 ? _options$combinators : defaultCombinators,
-			baseOption: options.baseCombinator
-		}).optionList, true));
+		_assertClassBrand(_QueryManager_brand, this, _applyOptions).call(this, options);
 		_classPrivateFieldSet2(_query, this, freeze(query ? prepareRuleGroup(query, { idGenerator: _classPrivateFieldGet2(_idGenerator, this) }) : this.createRuleGroup(), true));
 	}
 	/** Replaces the current query, ensuring every rule and group has an `id`. */
@@ -7128,6 +7115,48 @@ var QueryManager = class QueryManager {
 		return this;
 	}
 	/**
+	* The options currently in effect, as a frozen shallow copy. Reflects everything applied by
+	* the constructor and any subsequent {@link QueryManager.reconfigure} calls, but not the
+	* defaults filled in for options that were never provided.
+	*/
+	getOptions() {
+		return freeze(_objectSpread2({}, _classPrivateFieldGet2(_options, this)));
+	}
+	/**
+	* Updates the manager's configuration in place, keeping the current query, the undo/redo
+	* history, and every subscriber. Use this to propagate new `translations`, `fields`,
+	* `operators`, and so on without discarding state:
+	*
+	* ```ts
+	* q.reconfigure({ translations: { fields: { placeholderLabel: 'Choisir un champ' } } });
+	* ```
+	*
+	* The incoming options are shallow-merged over the current ones, so keys left out are
+	* preserved. Passing a key explicitly as `undefined` resets it to its default. Object-valued
+	* options like `translations` are replaced wholesale rather than deep-merged — spread the
+	* current value in yourself to patch one key. Pass `{ replace: true }` to discard the
+	* existing options entirely and start from the incoming set.
+	*
+	* The query is never rewritten, even when the new options no longer describe it: a rule whose
+	* `field` is not in the new `fields` list is left as-is. Call
+	* {@link QueryManager.validate validate} to detect that, or `setQuery(getQuery())` to
+	* re-normalize.
+	*
+	* History options are honored immediately: lowering `maxHistory` trims the undo stack, and
+	* turning history off clears both stacks. Subscribers are notified once, and
+	* {@link QueryManager.getConfigVersion} is incremented, even inside a
+	* {@link QueryManager.batch batch} — configuration is not part of a batch's rollback.
+	*/
+	reconfigure(options, config) {
+		var _this$configVersion;
+		_assertClassBrand(_QueryManager_brand, this, _applyOptions).call(this, freeze((config === null || config === void 0 ? void 0 : config.replace) ? _objectSpread2({}, options) : _objectSpread2(_objectSpread2({}, _classPrivateFieldGet2(_options, this)), options)));
+		_classPrivateFieldSet2(_validation, this, void 0);
+		_assertClassBrand(_QueryManager_brand, this, _reconcileHistoryConfig).call(this);
+		_classPrivateFieldSet2(_configVersion, this, (_this$configVersion = _classPrivateFieldGet2(_configVersion, this), ++_this$configVersion));
+		_assertClassBrand(_QueryManager_brand, this, _notify).call(this);
+		return this;
+	}
+	/**
 	* Creates an independent manager with the same configuration and the current query.
 	*
 	* Subscribers and history are _not_ carried over: the clone starts with no listeners and an
@@ -7175,6 +7204,7 @@ var QueryManager = class QueryManager {
 				_classPrivateFieldSet2(_future, this, snapshot.future);
 				_classPrivateFieldSet2(_lastSig, this, snapshot.lastSig);
 				_classPrivateFieldSet2(_lastAt, this, snapshot.lastAt);
+				_assertClassBrand(_QueryManager_brand, this, _reconcileHistoryConfig).call(this);
 			}
 			throw error;
 		} finally {
@@ -7245,9 +7275,9 @@ var QueryManager = class QueryManager {
 	* one that depends on anything other than the query) may run fewer times than expected.
 	*/
 	validate() {
-		var _classPrivateFieldGet4;
+		var _classPrivateFieldGet6;
 		_assertClassBrand(_QueryManager_brand, this, _ensureCache).call(this);
-		(_classPrivateFieldGet4 = _classPrivateFieldGet2(_validation, this)) !== null && _classPrivateFieldGet4 !== void 0 || _classPrivateFieldSet2(_validation, this, _classPrivateFieldGet2(_validator, this).call(this, _classPrivateFieldGet2(_query, this)));
+		(_classPrivateFieldGet6 = _classPrivateFieldGet2(_validation, this)) !== null && _classPrivateFieldGet6 !== void 0 || _classPrivateFieldSet2(_validation, this, _classPrivateFieldGet2(_validator, this).call(this, _classPrivateFieldGet2(_query, this)));
 		return _classPrivateFieldGet2(_validation, this);
 	}
 	format(options) {
@@ -7437,8 +7467,8 @@ var QueryManager = class QueryManager {
 			fields: _classPrivateFieldGet2(_fields, this),
 			fieldMap: _classPrivateFieldGet2(_fieldMap, this),
 			getInputType: (f, o, misc) => {
-				var _this$options$getInpu, _classPrivateFieldGet5, _classPrivateFieldGet6;
-				return (_this$options$getInpu = (_classPrivateFieldGet5 = (_classPrivateFieldGet6 = _classPrivateFieldGet2(_options, this)).getInputType) === null || _classPrivateFieldGet5 === void 0 ? void 0 : _classPrivateFieldGet5.call(_classPrivateFieldGet6, f, o, misc)) !== null && _this$options$getInpu !== void 0 ? _this$options$getInpu : null;
+				var _this$options$getInpu, _classPrivateFieldGet7, _classPrivateFieldGet8;
+				return (_this$options$getInpu = (_classPrivateFieldGet7 = (_classPrivateFieldGet8 = _classPrivateFieldGet2(_options, this)).getInputType) === null || _classPrivateFieldGet7 === void 0 ? void 0 : _classPrivateFieldGet7.call(_classPrivateFieldGet8, f, o, misc)) !== null && _this$options$getInpu !== void 0 ? _this$options$getInpu : null;
 			},
 			getMatchModes: (f) => _assertClassBrand(_QueryManager_brand, this, _matchModesFor).call(this, f),
 			getOperators: (f) => _assertClassBrand(_QueryManager_brand, this, _operatorsFor).call(this, f),
@@ -7447,8 +7477,8 @@ var QueryManager = class QueryManager {
 			getValues: (f, o) => _assertClassBrand(_QueryManager_brand, this, _valuesFor).call(this, f, o),
 			getValueSources: (f, o) => this.getValueSources(f, o),
 			getSubQueryBuilderProps: (f, misc) => {
-				var _this$options$getSubQ, _classPrivateFieldGet7, _classPrivateFieldGet8;
-				return (_this$options$getSubQ = (_classPrivateFieldGet7 = (_classPrivateFieldGet8 = _classPrivateFieldGet2(_options, this)).getSubQueryBuilderProps) === null || _classPrivateFieldGet7 === void 0 ? void 0 : _classPrivateFieldGet7.call(_classPrivateFieldGet8, f, misc)) !== null && _this$options$getSubQ !== void 0 ? _this$options$getSubQ : {};
+				var _this$options$getSubQ, _classPrivateFieldGet9, _classPrivateFieldGet10;
+				return (_this$options$getSubQ = (_classPrivateFieldGet9 = (_classPrivateFieldGet10 = _classPrivateFieldGet2(_options, this)).getSubQueryBuilderProps) === null || _classPrivateFieldGet9 === void 0 ? void 0 : _classPrivateFieldGet9.call(_classPrivateFieldGet10, f, misc)) !== null && _this$options$getSubQ !== void 0 ? _this$options$getSubQ : {};
 			}
 		}, {
 			validationMap: typeof validation === "boolean" ? {} : validation,
@@ -7519,6 +7549,45 @@ var QueryManager = class QueryManager {
 		return transformQuery(_classPrivateFieldGet2(_query, this), options);
 	}
 };
+/**
+* Assigns `#options` and every field derived from it. Shared by the constructor and
+* {@link QueryManager.reconfigure}, so the two can never drift apart. Does not touch the
+* query, the history stacks, the caches, or the subscriber list.
+*/
+function _applyOptions(options) {
+	var _options$idGenerator, _options$validator, _options$strict, _options$respectDisab, _options$history, _historyOptions$maxHi, _historyOptions$coale, _options$now, _options$translations, _options$operators, _options$translations2, _options$combinators;
+	_classPrivateFieldSet2(_options, this, options);
+	_classPrivateFieldSet2(_idGenerator, this, (_options$idGenerator = options.idGenerator) !== null && _options$idGenerator !== void 0 ? _options$idGenerator : generateID);
+	_classPrivateFieldSet2(_validator, this, (_options$validator = options.validator) !== null && _options$validator !== void 0 ? _options$validator : defaultValidator);
+	_classPrivateFieldSet2(_strict, this, (_options$strict = options.strict) !== null && _options$strict !== void 0 ? _options$strict : false);
+	_classPrivateFieldSet2(_respectDisabled, this, (_options$respectDisab = options.respectDisabled) !== null && _options$respectDisab !== void 0 ? _options$respectDisab : true);
+	_classPrivateFieldSet2(_onInvalidTarget, this, options.onInvalidTarget);
+	const history = (_options$history = options.history) !== null && _options$history !== void 0 ? _options$history : false;
+	const historyOptions = typeof history === "object" ? history : {};
+	_classPrivateFieldSet2(_historyEnabled, this, history !== false);
+	_classPrivateFieldSet2(_maxHistory, this, (_historyOptions$maxHi = historyOptions.maxHistory) !== null && _historyOptions$maxHi !== void 0 ? _historyOptions$maxHi : 50);
+	_classPrivateFieldSet2(_coalesceMs, this, (_historyOptions$coale = historyOptions.coalesceMs) !== null && _historyOptions$coale !== void 0 ? _historyOptions$coale : 500);
+	_classPrivateFieldSet2(_now, this, (_options$now = options.now) !== null && _options$now !== void 0 ? _options$now : Date.now);
+	const { optionList: fields, optionsMap: fieldMap } = prepareOptionList({
+		optionList: options.fields,
+		baseOption: options.baseField,
+		autoSelectOption: options.autoSelectField,
+		placeholder: (_options$translations = options.translations) === null || _options$translations === void 0 ? void 0 : _options$translations.fields
+	});
+	_classPrivateFieldSet2(_fields, this, freeze(fields, true));
+	_classPrivateFieldSet2(_fieldMap, this, freeze(fieldMap, true));
+	_classPrivateFieldSet2(_operators, this, prepareOptionList({
+		optionList: (_options$operators = options.operators) !== null && _options$operators !== void 0 ? _options$operators : defaultOperators,
+		baseOption: options.baseOperator,
+		labelMap: defaultOperatorLabelMap,
+		autoSelectOption: options.autoSelectOperator,
+		placeholder: (_options$translations2 = options.translations) === null || _options$translations2 === void 0 ? void 0 : _options$translations2.operators
+	}).optionList);
+	_classPrivateFieldSet2(_combinators, this, freeze(prepareOptionList({
+		optionList: (_options$combinators = options.combinators) !== null && _options$combinators !== void 0 ? _options$combinators : defaultCombinators,
+		baseOption: options.baseCombinator
+	}).optionList, true));
+}
 /** Resolves the field configuration for a field name. */
 function _fieldData(field) {
 	var _this$fieldMap$field;
@@ -7526,13 +7595,15 @@ function _fieldData(field) {
 }
 /** Resolves the operator list for a field, mirroring `QueryBuilder`'s precedence. */
 function _operatorsFor(field) {
+	var _classPrivateFieldGet2$1;
 	return resolveOperatorList({
 		field,
 		fieldData: _assertClassBrand(_QueryManager_brand, this, _fieldData).call(this, field),
 		getOperators: _classPrivateFieldGet2(_options, this).getOperators,
 		operators: _classPrivateFieldGet2(_operators, this),
 		baseOption: _classPrivateFieldGet2(_options, this).baseOperator,
-		autoSelectOption: _classPrivateFieldGet2(_options, this).autoSelectOperator
+		autoSelectOption: _classPrivateFieldGet2(_options, this).autoSelectOperator,
+		placeholder: (_classPrivateFieldGet2$1 = _classPrivateFieldGet2(_options, this).translations) === null || _classPrivateFieldGet2$1 === void 0 ? void 0 : _classPrivateFieldGet2$1.operators
 	});
 }
 /** Resolves the default operator for a field, mirroring `QueryBuilder`'s precedence. */
@@ -7551,12 +7622,14 @@ function _matchModesFor(field) {
 	return getMatchModesUtil(_assertClassBrand(_QueryManager_brand, this, _fieldData).call(this, field), _classPrivateFieldGet2(_options, this).getMatchModes);
 }
 function _valuesFor(field, operator) {
+	var _classPrivateFieldGet3;
 	return resolveValueList({
 		field,
 		operator,
 		fieldData: _assertClassBrand(_QueryManager_brand, this, _fieldData).call(this, field),
 		getValues: _classPrivateFieldGet2(_options, this).getValues,
-		autoSelectOption: _classPrivateFieldGet2(_options, this).autoSelectValue
+		autoSelectOption: _classPrivateFieldGet2(_options, this).autoSelectValue,
+		placeholder: (_classPrivateFieldGet3 = _classPrivateFieldGet2(_options, this).translations) === null || _classPrivateFieldGet3 === void 0 ? void 0 : _classPrivateFieldGet3.values
 	});
 }
 function _valueEditorTypeFor(field, operator) {
@@ -7586,9 +7659,9 @@ function _defaultValue(rule) {
 * {@link QueryManager.getRuleContext} so both see the same shape.
 */
 function _parametersFor(field, operator, misc) {
-	var _this$options$getPara, _classPrivateFieldGet2$1, _classPrivateFieldGet3;
+	var _this$options$getPara, _classPrivateFieldGet4, _classPrivateFieldGet5;
 	return prepareOptionList({
-		optionList: (_this$options$getPara = (_classPrivateFieldGet2$1 = (_classPrivateFieldGet3 = _classPrivateFieldGet2(_options, this)).getParameters) === null || _classPrivateFieldGet2$1 === void 0 ? void 0 : _classPrivateFieldGet2$1.call(_classPrivateFieldGet3, field, operator, misc)) !== null && _this$options$getPara !== void 0 ? _this$options$getPara : [],
+		optionList: (_this$options$getPara = (_classPrivateFieldGet4 = (_classPrivateFieldGet5 = _classPrivateFieldGet2(_options, this)).getParameters) === null || _classPrivateFieldGet4 === void 0 ? void 0 : _classPrivateFieldGet4.call(_classPrivateFieldGet5, field, operator, misc)) !== null && _this$options$getPara !== void 0 ? _this$options$getPara : [],
 		autoSelectOption: _classPrivateFieldGet2(_options, this).autoSelectValue
 	}).optionList;
 }
@@ -7717,6 +7790,25 @@ function _toPath(pathOrID) {
 	var _this$index$get;
 	return typeof pathOrID === "string" ? (_this$index$get = _assertClassBrand(_QueryManager_brand, this, _index).call(this).get(pathOrID)) !== null && _this$index$get !== void 0 ? _this$index$get : null : pathOrID;
 }
+/**
+* Brings the history stacks in line with the current history configuration. Unlike
+* {@link QueryManager.clearHistory}, this does _not_ set `#historyBypassed`: it reflects a
+* configuration change rather than a deliberate history repositioning, so a later mutation in
+* the same batch must still be recorded normally.
+*
+* Called by {@link QueryManager.reconfigure} and again after a failed
+* {@link QueryManager.batch batch} restores its snapshot, since that snapshot predates the
+* configuration change (configuration is not part of a batch's rollback).
+*/
+function _reconcileHistoryConfig() {
+	if (_classPrivateFieldGet2(_historyEnabled, this)) {
+		if (_classPrivateFieldGet2(_past, this).length > _classPrivateFieldGet2(_maxHistory, this)) _classPrivateFieldGet2(_past, this).splice(0, _classPrivateFieldGet2(_past, this).length - _classPrivateFieldGet2(_maxHistory, this));
+	} else {
+		_classPrivateFieldSet2(_past, this, []);
+		_classPrivateFieldSet2(_future, this, []);
+		_classPrivateFieldSet2(_lastSig, this, void 0);
+	}
+}
 //#endregion
 export { LogType, QueryManager, QueryManagerError, TestID, add, addInPlace, betweenOperators, bigIntJsonParseReviver, bigIntJsonStringifyReplacer, celCombinatorMap, clsx, coerceBigIntValue, coerceInputType, convertFromIC, convertQuery, convertToIC, createQueryActions, createRule, createRuleGroup, cypherCombinatorMap, defaultCELValueProcessor, defaultCoalesceMs, defaultCombinatorLabelMap, defaultCombinators, defaultCombinatorsExtended, defaultControlClassnames, defaultExportOperatorMap, defaultJoinChar, defaultMatchModes, defaultMaxHistory, defaultMongoDBValueProcessor, defaultNLTranslations, defaultOperatorLabelMap, defaultOperatorNegationMap, defaultOperatorProcessorNL, defaultOperatorProcessorSQL, defaultOperators, defaultPlaceholderFieldGroupLabel, defaultPlaceholderFieldLabel, defaultPlaceholderFieldName, defaultPlaceholderLabel, defaultPlaceholderName, defaultPlaceholderOperatorGroupLabel, defaultPlaceholderOperatorLabel, defaultPlaceholderOperatorName, defaultPlaceholderValueGroupLabel, defaultPlaceholderValueLabel, defaultPlaceholderValueName, defaultRuleGroupProcessorCEL, defaultRuleGroupProcessorCypher, defaultRuleGroupProcessorDiagnostics, defaultRuleGroupProcessorDrizzle, defaultRuleGroupProcessorElasticSearch, defaultRuleGroupProcessorGremlin, defaultRuleGroupProcessorJSONata, defaultRuleGroupProcessorJsonLogic, defaultRuleGroupProcessorLDAP, defaultRuleGroupProcessorMongoDB, defaultRuleGroupProcessorMongoDBQuery, defaultRuleGroupProcessorNL, defaultRuleGroupProcessorParameterized, defaultRuleGroupProcessorPrisma, defaultRuleGroupProcessorSPARQL, defaultRuleGroupProcessorSQL, defaultRuleGroupProcessorSequelize, defaultRuleGroupProcessorSpEL, defaultRuleGroupProcessorTanStackDB, defaultRuleProcessorCEL, defaultRuleProcessorCypher, defaultRuleProcessorDrizzle, defaultRuleProcessorElasticSearch, defaultRuleProcessorGremlin, defaultRuleProcessorJSONata, defaultRuleProcessorJsonLogic, defaultRuleProcessorLDAP, defaultRuleProcessorMongoDB, defaultRuleProcessorMongoDBQuery, defaultRuleProcessorNL, defaultRuleProcessorParameterized, defaultRuleProcessorPrisma, defaultRuleProcessorSPARQL, defaultRuleProcessorSQL, defaultRuleProcessorSequelize, defaultRuleProcessorSpEL, defaultRuleProcessorTanStackDB, defaultSpELValueProcessor, defaultTranslations, defaultValidator, defaultValueProcessor, defaultValueProcessorByRule, defaultValueProcessorCELByRule, defaultValueProcessorMongoDBByRule, defaultValueProcessorNL, defaultValueProcessorSpELByRule, derivePathInfo, deriveQueryBuilderClassNames, deriveRuleClassName, deriveRuleClassNames, deriveRuleContext, deriveRuleGroupClassNames, deriveRuleGroupContext, deriveRuleGroupOuterClassName, deriveRuleOuterClassName, exceedsMaxLevels, filterFieldsByComparator, findID, findPath, formatQuery, formatQueryOptionPresets, generateAccessibleDescription, generateID, getCommonAncestorPath, getFieldData, getFirstOption, getGuardAbortReason, getLikeWildcards, getMatchModesUtil, getMultiValueUpdate, getNLTranslataion, getOption, getParametersAsList, getParentPath, getParseNumberMethod, getPathOfID, getQuoteFieldNamesWithArray, getQuotedFieldName, getRuleDefaultValue, getRuleGroupCombinator, getRuleInputType, getRuleValidationResult, getRuleValueEditorType, getRuleValueSourceOptions, getRuleValues, getSQLConcat, getSubqueryElementAlias, getValidationClassNames, getValueEditorReset, getValueSelectorUpdate, getValueSourcesUtil, group, groupInPlace, groupInvalidReasons, hideValueControlsForOperator, inOperators, insert, insertInPlace, isAncestor, isBetweenOperator, isFlexibleOptionArray, isFlexibleOptionGroupArray, isFullOptionArray, isFullOptionGroupArray, isOptionGroupArray, isPojo, isRuleGroup, isRuleGroupType, isRuleGroupTypeIC, isRuleOrGroupValid, isRuleType, isUnsafeKey, isValidValue, isValidationResult, isValueProcessorLegacy, joinWith, jsonLogicAdditionalOperators, lc, mapSQLOperator, mergeAnyTranslation, mergeAnyTranslations, mergeClassnames, mongoDbFallback, mongoOperators, move, moveInPlace, normalizeConstituentWordOrder, normalizeValueSelectorValue, nullFreeArray, nullOperators, nullOrUndefinedOrEmpty, numericRegex, numerifyValues, objectEntries, objectKeys, parseNumber, pathIsDisabled, pathIsDisabledByPaths, pathsAreEqual, preferAnyProp, preferFlagProps, preferProp, prepareOptionList, prepareRule, prepareRuleGroup, prepareRuleOrGroup, prismaFallback, prismaOperators, processMatchMode, queryBuilderFlagDefaults, regenerateID, regenerateIDs, relationalOperators, remove, removeInPlace, resolveCandidateQuery, resolveDefaultOperator, resolveOperatorList, resolveValueEditorType, resolveValueList, rootPath, shouldRenderAsNumber, signatureOf, sparqlVar, splitBy, sqlDialectPresets, standardClassnames, strictAbortReasons, stripParamPrefix, structuralSignature, subqueryElementAliasBase, substringOperators, toArray, toFlatOptionArray, toFullOption, toFullOptionList, toFullOptionMap, transformQuery, trimIfString, unchangedSignature, uniqByIdentifier, uniqByName, uniqOptGroups, uniqOptList, update, updateInPlace, uuidV4regex, withParamPrefix, wrapLikeFragment };