@react-querybuilder/core 8.22.2 → 8.22.4

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

@@ -5893,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.
    *