@react-querybuilder/core 8.9.0

package/dist/styles/_functions.scss

@@ -0,0 +1,14 @@
+@use 'sass:map';
+
+// This function lets the user use an old variable name as long as the new
+// variable's default hasn't been overridden.
+@function prefer-new-var($old-var, $new-var, $map, $prop) {
+  // If the new variable is still the default, and the old variable
+  // does not equal the default (i.e., it's been overridden), return the
+  // old variable. Otherwise return the new variable.
+  @if $new-var == map.get($map, $prop) and $old-var != map.get($map, $prop) {
+    @return $old-var;
+  }
+
+  @return $new-var;
+}

package/dist/styles/_layout.scss

@@ -0,0 +1,201 @@
+/**
+ * Layout/structural styles
+ */
+
+// DO NOT ALTER OR REMOVE REGION NAMES. Some of them are used
+// to generate code snippets in the documentation.
+
+@use './variables' as *;
+
+/* Basic */
+.ruleGroup {
+  display: flex;
+  flex-direction: column;
+  gap: var(--#{$rqb-var-prefix}spacing);
+  padding: var(--#{$rqb-var-prefix}spacing);
+  border-width: var(--#{$rqb-var-prefix}border-width);
+
+  .ruleGroup-body {
+    display: flex;
+    flex-direction: column;
+    gap: var(--#{$rqb-var-prefix}spacing);
+
+    &:empty {
+      display: none;
+    }
+  }
+
+  .ruleGroup-header,
+  .rule {
+    display: flex;
+    gap: var(--#{$rqb-var-prefix}spacing);
+    align-items: center;
+  }
+
+  .rule {
+    .rule-value:has(.rule-value-list-item) {
+      display: flex;
+      gap: var(--#{$rqb-var-prefix}spacing);
+      align-items: baseline;
+    }
+
+    &.rule-hasSubQuery {
+      flex-wrap: wrap;
+      padding: var(--#{$rqb-var-prefix}spacing);
+      border-width: var(--#{$rqb-var-prefix}border-width);
+
+      .ruleGroup-body {
+        flex-basis: 100%;
+      }
+    }
+  }
+
+  .betweenRules {
+    display: flex;
+  }
+
+  .shiftActions {
+    display: flex;
+    flex-direction: column;
+
+    & > * {
+      padding: 0;
+    }
+  }
+}
+
+/* #region Drag-and-drop */
+/* Hover styles */
+.dndOver {
+  &.rule,
+  &.ruleGroup-header {
+    padding-bottom: var(--#{$rqb-var-prefix}spacing);
+  }
+  &.betweenRules {
+    padding-top: var(--#{$rqb-var-prefix}spacing);
+  }
+}
+.dndGroup {
+  &.rule.dndOver,
+  &.ruleGroup:has(.ruleGroup-header.dndOver) {
+    padding: var(--#{$rqb-var-prefix}spacing);
+  }
+}
+/* #endregion */
+
+/* #region Branches */
+.queryBuilder-branches {
+  .ruleGroup-body {
+    margin-left: calc(2 * var(--#{$rqb-var-prefix}branch-indent));
+  }
+
+  .rule,
+  .ruleGroup .ruleGroup {
+    position: relative;
+
+    &::before,
+    &::after {
+      content: '';
+      width: var(--#{$rqb-var-prefix}branch-indent);
+      left: calc(
+        -1 * (var(--#{$rqb-var-prefix}branch-indent) + var(--#{$rqb-var-prefix}branch-width))
+      );
+      border-radius: 0;
+      position: absolute;
+    }
+
+    &::before {
+      top: calc(-1 * var(--#{$rqb-var-prefix}spacing));
+      height: calc(50% + var(--#{$rqb-var-prefix}spacing));
+      border-width: 0 0 var(--#{$rqb-var-prefix}branch-width) var(--#{$rqb-var-prefix}branch-width);
+    }
+
+    &::after {
+      top: 50%;
+      height: 50%;
+      border-width: 0 0 0 var(--#{$rqb-var-prefix}branch-width);
+    }
+
+    &:last-child::after {
+      display: none;
+    }
+  }
+
+  .rule-hasSubQuery,
+  .ruleGroup .ruleGroup {
+    &::before,
+    &::after {
+      left: calc(
+        -1 *
+          (
+            var(--#{$rqb-var-prefix}branch-indent) + var(--#{$rqb-var-prefix}branch-width) +
+              var(--#{$rqb-var-prefix}border-width)
+          )
+      );
+    }
+
+    &::before {
+      top: calc(-1 * (var(--#{$rqb-var-prefix}spacing) + var(--#{$rqb-var-prefix}border-width)));
+      height: calc(50% + var(--#{$rqb-var-prefix}spacing) + var(--#{$rqb-var-prefix}border-width));
+    }
+
+    &::after {
+      height: calc(50% + var(--#{$rqb-var-prefix}border-width));
+    }
+  }
+
+  .betweenRules {
+    position: relative;
+
+    &::before {
+      content: '';
+      width: var(--#{$rqb-var-prefix}branch-indent);
+      left: calc(
+        -1 * (var(--#{$rqb-var-prefix}branch-indent) + var(--#{$rqb-var-prefix}branch-width))
+      );
+      border-radius: 0;
+      position: absolute;
+      top: calc(-1 * var(--#{$rqb-var-prefix}spacing));
+      height: calc(100% + var(--#{$rqb-var-prefix}spacing));
+      border-width: 0 0 0 var(--#{$rqb-var-prefix}branch-width);
+    }
+  }
+}
+/* #endregion */
+
+/* #region Justified */
+.queryBuilder-justified {
+  .ruleGroup-combinators,
+  .ruleGroup-notToggle,
+  .shiftActions,
+  .queryBuilder-dragHandle,
+  .ruleGroup-notToggle,
+  .ruleGroup-header,
+  .rule-operators,
+  .rule-value,
+  // Some Bulma controls are wrapped in an element with "control" class
+  .control,
+  // Chakra UI v2 adds classNames to a nested element
+  .chakra-select__wrapper,
+  // Mantine renders a hidden input beside value selectors
+  input[type='hidden'] {
+    & + .ruleGroup-addRule,
+    & + .ruleGroup-addGroup,
+    & + .ruleGroup-cloneGroup,
+    & + .ruleGroup-lock,
+    & + .ruleGroup-remove,
+    & + .rule-cloneRule,
+    & + .rule-lock,
+    & + .rule-remove {
+      margin-left: auto !important;
+    }
+  }
+
+  .ruleGroup-addRule,
+  .ruleGroup-addGroup {
+    &:first-child {
+      margin-left: auto !important;
+    }
+  }
+}
+/* #endregion */

package/dist/styles/_main.scss

@@ -0,0 +1,114 @@
+/**
+ * Decorative/aesthetic styles
+ */
+
+// DO NOT ALTER OR REMOVE REGION NAMES. Some of them are used
+// to generate code snippets in the documentation.
+
+@use './variables' as *;
+
+/* Default styles */
+.ruleGroup,
+.rule-hasSubQuery {
+  border-color: var(--#{$rqb-var-prefix}border-color);
+  border-style: var(--#{$rqb-var-prefix}border-style);
+  border-radius: var(--#{$rqb-var-prefix}border-radius);
+  background: var(--#{$rqb-var-prefix}background-color);
+
+  .shiftActions {
+    & > * {
+      background-color: transparent;
+      border: none;
+      cursor: pointer;
+    }
+  }
+}
+
+/* #region Drag-and-drop styles */
+/* Hover styles (drop allowed) */
+.dndOver {
+  &.rule,
+  &.ruleGroup-header:not(.dndGroup .ruleGroup-header) {
+    border-bottom-width: var(--#{$rqb-var-prefix}dnd-drop-indicator-width);
+    border-bottom-style: var(--#{$rqb-var-prefix}dnd-drop-indicator-style);
+    border-bottom-color: var(--#{$rqb-var-prefix}dnd-drop-indicator-color);
+
+    &.dndCopy {
+      border-bottom-width: var(--#{$rqb-var-prefix}dnd-drop-indicator-copy-width);
+      border-bottom-style: var(--#{$rqb-var-prefix}dnd-drop-indicator-copy-style);
+      border-bottom-color: var(--#{$rqb-var-prefix}dnd-drop-indicator-copy-color);
+    }
+  }
+
+  &.betweenRules {
+    border-top-width: var(--#{$rqb-var-prefix}dnd-drop-indicator-width);
+    border-top-style: var(--#{$rqb-var-prefix}dnd-drop-indicator-style);
+    border-top-color: var(--#{$rqb-var-prefix}dnd-drop-indicator-color);
+
+    &.dndCopy {
+      border-top-width: var(--#{$rqb-var-prefix}dnd-drop-indicator-copy-width);
+      border-top-style: var(--#{$rqb-var-prefix}dnd-drop-indicator-copy-style);
+      border-top-color: var(--#{$rqb-var-prefix}dnd-drop-indicator-copy-color);
+    }
+  }
+}
+
+/* Hover styles (drop not allowed) */
+.dndDropNotAllowed {
+  cursor: var(--#{$rqb-var-prefix}dnd-drop-not-allowed-cursor);
+}
+
+.dndGroup {
+  &.rule.dndOver,
+  &.ruleGroup:has(> .ruleGroup-header.dndOver) {
+    border-width: var(--#{$rqb-var-prefix}dnd-drop-indicator-group-width);
+    border-style: var(--#{$rqb-var-prefix}dnd-drop-indicator-group-style);
+    border-color: var(--#{$rqb-var-prefix}dnd-drop-indicator-group-color);
+    border-radius: var(--#{$rqb-var-prefix}border-radius);
+
+    &.dndCopy {
+      border-color: var(--#{$rqb-var-prefix}dnd-drop-indicator-copy-color);
+      border-width: var(--#{$rqb-var-prefix}dnd-drop-indicator-copy-width);
+      border-style: var(--#{$rqb-var-prefix}dnd-drop-indicator-copy-style);
+    }
+  }
+}
+
+/* Drag styles */
+.ruleGroup,
+.rule {
+  &.dndDragging {
+    opacity: 0.5;
+  }
+
+  .queryBuilder-dragHandle {
+    cursor: move;
+  }
+}
+/* #endregion */
+
+/* #region Branch styles */
+.queryBuilder-branches {
+  .rule,
+  .ruleGroup .ruleGroup {
+    &::before,
+    &::after {
+      border-color: var(--#{$rqb-var-prefix}branch-color);
+      border-style: var(--#{$rqb-var-prefix}branch-style);
+    }
+
+    &:last-child::before {
+      border-bottom-left-radius: var(--#{$rqb-var-prefix}branch-radius);
+    }
+  }
+
+  .betweenRules {
+    position: relative;
+
+    &::before {
+      border-color: var(--#{$rqb-var-prefix}branch-color);
+      border-style: var(--#{$rqb-var-prefix}branch-style);
+    }
+  }
+}
+/* #endregion */

package/dist/styles/_root.scss

@@ -0,0 +1,66 @@
+@use './functions' as *;
+@use './variables' as *;
+
+$rqb-internal_dnd-drop-indicator-color: prefer-new-var(
+  $rqb-dnd-hover-border-bottom-color,
+  $rqb-dnd-drop-indicator-color,
+  $rqb-dnd-drop-indicator-defaults,
+  'color'
+);
+$rqb-internal_dnd-drop-indicator-copy-color: prefer-new-var(
+  $rqb-dnd-hover-copy-border-bottom-color,
+  $rqb-dnd-drop-indicator-copy-color,
+  $rqb-dnd-drop-indicator-defaults,
+  'copy-color'
+);
+$rqb-internal_dnd-drop-indicator-style: prefer-new-var(
+  $rqb-dnd-hover-border-bottom-style,
+  $rqb-dnd-drop-indicator-style,
+  $rqb-dnd-drop-indicator-defaults,
+  'style'
+);
+$rqb-internal_dnd-drop-indicator-width: prefer-new-var(
+  $rqb-dnd-hover-border-bottom-width,
+  $rqb-dnd-drop-indicator-width,
+  $rqb-dnd-drop-indicator-defaults,
+  'width'
+);
+
+:root {
+  /* #region Basic layout */
+  --#{$rqb-var-prefix}spacing: #{$rqb-spacing};
+  --#{$rqb-var-prefix}border-width: #{$rqb-border-width};
+  /* #endregion */
+
+  /* #region Branches layout */
+  --#{$rqb-var-prefix}branch-indent: var(--#{$rqb-var-prefix}spacing);
+  --#{$rqb-var-prefix}branch-width: var(--#{$rqb-var-prefix}border-width);
+  /* #endregion */
+
+  /* #region Basic aesthetic */
+  --#{$rqb-var-prefix}base-color: #{$rqb-base-color};
+  --#{$rqb-var-prefix}background-color: #{$rqb-background-color};
+  --#{$rqb-var-prefix}border-color: #{$rqb-border-color};
+  --#{$rqb-var-prefix}border-style: #{$rqb-border-style};
+  --#{$rqb-var-prefix}border-radius: #{$rqb-border-radius};
+  /* #endregion */
+
+  /* #region Drag-and-drop aesthetic */
+  --#{$rqb-var-prefix}dnd-drop-indicator-color: #{$rqb-internal_dnd-drop-indicator-color};
+  --#{$rqb-var-prefix}dnd-drop-indicator-style: #{$rqb-internal_dnd-drop-indicator-style};
+  --#{$rqb-var-prefix}dnd-drop-indicator-width: #{$rqb-internal_dnd-drop-indicator-width};
+  --#{$rqb-var-prefix}dnd-drop-indicator-copy-color: #{$rqb-internal_dnd-drop-indicator-copy-color};
+  --#{$rqb-var-prefix}dnd-drop-indicator-copy-style: #{$rqb-internal_dnd-drop-indicator-style};
+  --#{$rqb-var-prefix}dnd-drop-indicator-copy-width: #{$rqb-internal_dnd-drop-indicator-width};
+  --#{$rqb-var-prefix}dnd-drop-indicator-group-color: #{$rqb-dnd-drop-indicator-group-color};
+  --#{$rqb-var-prefix}dnd-drop-indicator-group-style: #{$rqb-dnd-drop-indicator-group-style};
+  --#{$rqb-var-prefix}dnd-drop-indicator-group-width: #{$rqb-dnd-drop-indicator-group-width};
+  --#{$rqb-var-prefix}dnd-drop-not-allowed-cursor: #{$rqb-dnd-drop-not-allowed-cursor};
+  /* #endregion */
+
+  /* #region Branches aesthetic */
+  --#{$rqb-var-prefix}branch-color: var(--#{$rqb-var-prefix}border-color);
+  --#{$rqb-var-prefix}branch-radius: var(--#{$rqb-var-prefix}border-radius);
+  --#{$rqb-var-prefix}branch-style: var(--#{$rqb-var-prefix}border-style);
+  /* #endregion */
+}

package/dist/styles/_variables.scss

@@ -0,0 +1,66 @@
+@use 'sass:map';
+
+$rqb-var-prefix: rqb- !default;
+
+// #region Basic layout
+$rqb-spacing: 0.5rem !default;
+$rqb-border-width: 1px !default;
+// #endregion
+
+// #region Branches layout
+$rqb-branch-indent: $rqb-spacing !default;
+$rqb-branch-width: $rqb-border-width !default;
+// #endregion
+
+$rqb-dnd-drop-indicator-defaults: (
+  'color': rebeccapurple,
+  'copy-color': #693,
+  'group-color': #369,
+  'style': dashed,
+  'width': 2px,
+);
+
+// #region Basic aesthetic
+$rqb-base-color: #004bb8 !default;
+$rqb-background-color: color-mix(in srgb, transparent, $rqb-base-color 20%) !default;
+$rqb-border-color: #8081a2 !default;
+$rqb-border-style: solid !default;
+$rqb-border-radius: 0.25rem !default;
+// #endregion
+
+// #region New drag-and-drop variables
+$rqb-dnd-drop-indicator-color: map.get($rqb-dnd-drop-indicator-defaults, 'color') !default;
+$rqb-dnd-drop-indicator-style: map.get($rqb-dnd-drop-indicator-defaults, 'style') !default;
+$rqb-dnd-drop-indicator-width: map.get($rqb-dnd-drop-indicator-defaults, 'width') !default;
+$rqb-dnd-drop-not-allowed-cursor: not-allowed !default;
+
+$rqb-dnd-drop-indicator-copy-color: map.get(
+  $rqb-dnd-drop-indicator-defaults,
+  'copy-color'
+) !default;
+$rqb-dnd-drop-indicator-copy-style: map.get($rqb-dnd-drop-indicator-defaults, 'style') !default;
+$rqb-dnd-drop-indicator-copy-width: map.get($rqb-dnd-drop-indicator-defaults, 'width') !default;
+
+$rqb-dnd-drop-indicator-group-color: map.get(
+  $rqb-dnd-drop-indicator-defaults,
+  'group-color'
+) !default;
+$rqb-dnd-drop-indicator-group-style: map.get($rqb-dnd-drop-indicator-defaults, 'style') !default;
+$rqb-dnd-drop-indicator-group-width: map.get($rqb-dnd-drop-indicator-defaults, 'width') !default;
+// #endregion
+
+// #region Deprecated drag-and-drop variables
+$rqb-dnd-hover-border-bottom-color: map.get($rqb-dnd-drop-indicator-defaults, 'color') !default;
+$rqb-dnd-hover-copy-border-bottom-color: map.get(
+  $rqb-dnd-drop-indicator-defaults,
+  'copy-color'
+) !default;
+$rqb-dnd-hover-border-bottom-style: map.get($rqb-dnd-drop-indicator-defaults, 'style') !default;
+$rqb-dnd-hover-border-bottom-width: map.get($rqb-dnd-drop-indicator-defaults, 'width') !default;
+// #endregion
+
+// #region Branches aesthetic
+$rqb-branch-color: $rqb-border-color !default;
+$rqb-branch-radius: $rqb-border-radius !default;
+$rqb-branch-style: $rqb-border-style !default;
+// #endregion

package/dist/transformQuery-FL_nlpp5.js

@@ -0,0 +1,47 @@
+const require_isRuleGroup = require('./isRuleGroup-DqAs2x4E.js');
+let immer = require("immer");
+immer = require_isRuleGroup.__toESM(immer);
+
+//#region src/utils/transformQuery.ts
+const remapProperties = (obj, propertyMap, deleteRemappedProperties) => (0, immer.produce)(obj, (draft) => {
+	for (const [k, v] of Object.entries(propertyMap)) if (v === false) delete draft[k];
+	else if (!!v && k !== v && k in draft) {
+		draft[v] = draft[k];
+		if (deleteRemappedProperties) delete draft[k];
+	}
+});
+function transformQuery(query, options = {}) {
+	const { ruleProcessor = (r) => r, ruleGroupProcessor = (rg) => rg, propertyMap = {}, combinatorMap = {}, operatorMap = {}, omitPath = false, deleteRemappedProperties = true } = options;
+	const processGroup = (rg) => ({
+		...ruleGroupProcessor(remapProperties({
+			...rg,
+			...require_isRuleGroup.isRuleGroupType(rg) ? { combinator: combinatorMap[rg.combinator] ?? rg.combinator } : {}
+		}, propertyMap, deleteRemappedProperties)),
+		...propertyMap["rules"] === false ? null : { [propertyMap["rules"] ?? "rules"]: rg.rules.map((r, idx) => {
+			const pathObject = omitPath ? null : { path: [...rg.path, idx] };
+			if (typeof r === "string") return combinatorMap[r] ?? r;
+			else if (require_isRuleGroup.isRuleGroup(r)) return processGroup({
+				...r,
+				...pathObject
+			});
+			return ruleProcessor(remapProperties({
+				...r,
+				...pathObject,
+				..."operator" in r ? { operator: operatorMap[r.operator] ?? r.operator } : {}
+			}, propertyMap, deleteRemappedProperties));
+		}) }
+	});
+	return processGroup({
+		...query,
+		...omitPath ? null : { path: [] }
+	});
+}
+
+//#endregion
+Object.defineProperty(exports, 'transformQuery', {
+  enumerable: true,
+  get: function () {
+    return transformQuery;
+  }
+});
+//# sourceMappingURL=transformQuery-FL_nlpp5.js.map

package/dist/transformQuery-FL_nlpp5.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformQuery-FL_nlpp5.js","names":["isRuleGroupType","isRuleGroup"],"sources":["../src/utils/transformQuery.ts"],"sourcesContent":["/**\n * Recursively steps through a query object ({@link index!RuleGroupType RuleGroupType} or {@link index!RuleGroupTypeIC RuleGroupTypeIC}),\n * passing each {@link index!RuleType RuleType} object to a provided `ruleProcessor` function and returning a\n * new query object if there were any referential changes.\n *\n * @module transformQuery\n */\n\nimport { produce } from 'immer';\nimport type { RuleGroupType, RuleGroupTypeAny, RuleGroupTypeIC, RuleType } from '../types';\nimport { isRuleGroup, isRuleGroupType } from './isRuleGroup';\n\nconst remapProperties = (\n  // oxlint-disable-next-line typescript/no-explicit-any\n  obj: Record<string, any>,\n  propertyMap: Record<string, string | false>,\n  deleteRemappedProperties: boolean\n) =>\n  produce(obj, draft => {\n    for (const [k, v] of Object.entries(propertyMap)) {\n      if (v === false) {\n        delete draft[k];\n      } else if (!!v && k !== v && k in draft) {\n        draft[v] = draft[k];\n        if (deleteRemappedProperties) {\n          delete draft[k];\n        }\n      }\n    }\n  });\n\n/**\n * Options object for {@link index!transformQuery transformQuery}.\n */\nexport interface TransformQueryOptions<RG extends RuleGroupTypeAny = RuleGroupType> {\n  /**\n   * When a rule is encountered in the hierarchy, it will be replaced\n   * with the result of this function.\n   *\n   * @defaultValue `r => r`\n   */\n  // oxlint-disable-next-line typescript/no-explicit-any\n  ruleProcessor?: (rule: RuleType) => any;\n  /**\n   * When a group is encountered in the hierarchy (including the root group, the\n   * query itself), it will be replaced with the result of this function.\n   *\n   * @defaultValue `rg => rg`\n   */\n  // oxlint-disable-next-line typescript/no-explicit-any\n  ruleGroupProcessor?: (ruleGroup: RG) => Record<string, any>;\n  /**\n   * For each rule and group in the query, any properties matching a key\n   * in this object will be renamed to the corresponding value. To retain both\n   * the new _and_ the original properties, set `deleteRemappedProperties`\n   * to `false`.\n   *\n   * If a key has a value of `false`, the corresponding property will be removed\n   * without being copied to a new property name. (Warning: `{ rules: false }`\n   * will prevent recursion and only return the processed root group.)\n   *\n   * @defaultValue `{}`\n   *\n   * @example\n   * ```\n   *   transformQuery(\n   *     { combinator: 'and', not: true, rules: [] },\n   *     { propertyMap: { combinator: 'AndOr', not: false } }\n   *   )\n   *   // Returns: { AndOr: 'and', rules: [] }\n   * ```\n   */\n  propertyMap?: Record<string, string | false>;\n  /**\n   * Any combinator values (including independent combinators) will be translated\n   * from the key in this object to the value.\n   *\n   * @defaultValue `{}`\n   *\n   * @example\n   * ```\n   *   transformQuery(\n   *     { combinator: 'and', rules: [] },\n   *     { combinatorMap: { and: '&&', or: '||' } }\n   *   )\n   *   // Returns: { combinator: '&&', rules: [] }\n   * ```\n   */\n  combinatorMap?: Record<string, string>;\n  /**\n   * Any operator values will be translated from the key in this object to the value.\n   *\n   * @defaultValue `{}`\n   *\n   * @example\n   * ```\n   *   transformQuery(\n   *     { combinator: 'and', rules: [{ field: 'name', operator: '=', value: 'Steve Vai' }] },\n   *     { operatorMap: { '=': 'is' } }\n   *   )\n   *   // Returns:\n   *   // {\n   *   //   combinator: 'and',\n   *   //   rules: [{ field: 'name', operator: 'is', value: 'Steve Vai' }]\n   *   // }\n   * ```\n   */\n  operatorMap?: Record<string, string>;\n  /**\n   * Prevents the `path` property (see {@link index!Path Path}) from being added to each\n   * rule and group in the hierarchy.\n   *\n   * @defaultValue `false`\n   */\n  omitPath?: boolean;\n  /**\n   * Original properties remapped according to the `propertyMap` option will be removed.\n   *\n   * @defaultValue `true`\n   *\n   * @example\n   * ```\n   *   transformQuery(\n   *     { combinator: 'and', rules: [] },\n   *     { propertyMap: { combinator: 'AndOr' }, deleteRemappedProperties: false }\n   *   )\n   *   // Returns: { combinator: 'and', AndOr: 'and', rules: [] }\n   * ```\n   */\n  deleteRemappedProperties?: boolean;\n}\n\n/**\n * Recursively process a query heirarchy using this versatile utility function.\n *\n * [Documentation](https://react-querybuilder.js.org/docs/utils/misc#transformquery)\n */\nexport function transformQuery(\n  query: RuleGroupType,\n  options?: TransformQueryOptions\n  // oxlint-disable-next-line typescript/no-explicit-any\n): any;\n/**\n * Recursively process a query heirarchy with independent combinators using this\n * versatile utility function.\n *\n * [Documentation](https://react-querybuilder.js.org/docs/utils/misc#transformquery)\n */\nexport function transformQuery(\n  query: RuleGroupTypeIC,\n  options?: TransformQueryOptions<RuleGroupTypeIC>\n  // oxlint-disable-next-line typescript/no-explicit-any\n): any;\nexport function transformQuery<RG extends RuleGroupTypeAny>(\n  query: RG,\n  options: TransformQueryOptions<RG> = {}\n) {\n  const {\n    ruleProcessor = r => r,\n    ruleGroupProcessor = rg => rg,\n    propertyMap = {},\n    combinatorMap = {},\n    operatorMap = {},\n    omitPath = false,\n    deleteRemappedProperties = true,\n  } = options;\n\n  // oxlint-disable-next-line typescript/no-explicit-any\n  const processGroup = (rg: RuleGroupTypeAny): any => ({\n    ...ruleGroupProcessor(\n      remapProperties(\n        {\n          ...rg,\n          ...(isRuleGroupType(rg)\n            ? { combinator: combinatorMap[rg.combinator] ?? rg.combinator }\n            : {}),\n        },\n        propertyMap,\n        deleteRemappedProperties\n      ) as RG\n    ),\n    ...(propertyMap['rules'] === false\n      ? null\n      : {\n          // oxlint-disable-next-line typescript/no-explicit-any\n          [propertyMap['rules'] ?? 'rules']: rg.rules.map((r: any, idx) => {\n            const pathObject = omitPath ? null : { path: [...rg.path!, idx] };\n            if (typeof r === 'string') {\n              // independent combinators\n              return combinatorMap[r] ?? r;\n            } else if (isRuleGroup(r)) {\n              // sub-groups\n              return processGroup({ ...r, ...pathObject });\n            }\n            // rules\n            return ruleProcessor(\n              remapProperties(\n                {\n                  ...r,\n                  ...pathObject,\n                  ...('operator' in r ? { operator: operatorMap[r.operator] ?? r.operator } : {}),\n                },\n                propertyMap,\n                deleteRemappedProperties\n              ) as RuleType\n            );\n          }),\n        }),\n  });\n\n  return processGroup({ ...query, ...(omitPath ? null : { path: [] }) });\n}\n"],"mappings":";;;;;AAYA,MAAM,mBAEJ,KACA,aACA,gDAEQ,MAAK,UAAS;AACpB,MAAK,MAAM,CAAC,GAAG,MAAM,OAAO,QAAQ,YAAY,CAC9C,KAAI,MAAM,MACR,QAAO,MAAM;UACJ,CAAC,CAAC,KAAK,MAAM,KAAK,KAAK,OAAO;AACvC,QAAM,KAAK,MAAM;AACjB,MAAI,yBACF,QAAO,MAAM;;EAInB;AA4HJ,SAAgB,eACd,OACA,UAAqC,EAAE,EACvC;CACA,MAAM,EACJ,iBAAgB,MAAK,GACrB,sBAAqB,OAAM,IAC3B,cAAc,EAAE,EAChB,gBAAgB,EAAE,EAClB,cAAc,EAAE,EAChB,WAAW,OACX,2BAA2B,SACzB;CAGJ,MAAM,gBAAgB,QAA+B;EACnD,GAAG,mBACD,gBACE;GACE,GAAG;GACH,GAAIA,oCAAgB,GAAG,GACnB,EAAE,YAAY,cAAc,GAAG,eAAe,GAAG,YAAY,GAC7D,EAAE;GACP,EACD,aACA,yBACD,CACF;EACD,GAAI,YAAY,aAAa,QACzB,OACA,GAEG,YAAY,YAAY,UAAU,GAAG,MAAM,KAAK,GAAQ,QAAQ;GAC/D,MAAM,aAAa,WAAW,OAAO,EAAE,MAAM,CAAC,GAAG,GAAG,MAAO,IAAI,EAAE;AACjE,OAAI,OAAO,MAAM,SAEf,QAAO,cAAc,MAAM;YAClBC,gCAAY,EAAE,CAEvB,QAAO,aAAa;IAAE,GAAG;IAAG,GAAG;IAAY,CAAC;AAG9C,UAAO,cACL,gBACE;IACE,GAAG;IACH,GAAG;IACH,GAAI,cAAc,IAAI,EAAE,UAAU,YAAY,EAAE,aAAa,EAAE,UAAU,GAAG,EAAE;IAC/E,EACD,aACA,yBACD,CACF;IACD,EACH;EACN;AAED,QAAO,aAAa;EAAE,GAAG;EAAO,GAAI,WAAW,OAAO,EAAE,MAAM,EAAE,EAAE;EAAG,CAAC"}

package/dist/transformQuery.d.ts

@@ -0,0 +1,118 @@
+import { RuleGroupType, RuleGroupTypeAny, RuleGroupTypeIC, RuleType } from "./basic-C8xXKHIA.js";
+
+//#region src/utils/transformQuery.d.ts
+
+/**
+* Options object for {@link index!transformQuery transformQuery}.
+*/
+interface TransformQueryOptions<RG extends RuleGroupTypeAny = RuleGroupType> {
+  /**
+  * When a rule is encountered in the hierarchy, it will be replaced
+  * with the result of this function.
+  *
+  * @defaultValue `r => r`
+  */
+  ruleProcessor?: (rule: RuleType) => any;
+  /**
+  * When a group is encountered in the hierarchy (including the root group, the
+  * query itself), it will be replaced with the result of this function.
+  *
+  * @defaultValue `rg => rg`
+  */
+  ruleGroupProcessor?: (ruleGroup: RG) => Record<string, any>;
+  /**
+  * For each rule and group in the query, any properties matching a key
+  * in this object will be renamed to the corresponding value. To retain both
+  * the new _and_ the original properties, set `deleteRemappedProperties`
+  * to `false`.
+  *
+  * If a key has a value of `false`, the corresponding property will be removed
+  * without being copied to a new property name. (Warning: `{ rules: false }`
+  * will prevent recursion and only return the processed root group.)
+  *
+  * @defaultValue `{}`
+  *
+  * @example
+  * ```
+  *   transformQuery(
+  *     { combinator: 'and', not: true, rules: [] },
+  *     { propertyMap: { combinator: 'AndOr', not: false } }
+  *   )
+  *   // Returns: { AndOr: 'and', rules: [] }
+  * ```
+  */
+  propertyMap?: Record<string, string | false>;
+  /**
+  * Any combinator values (including independent combinators) will be translated
+  * from the key in this object to the value.
+  *
+  * @defaultValue `{}`
+  *
+  * @example
+  * ```
+  *   transformQuery(
+  *     { combinator: 'and', rules: [] },
+  *     { combinatorMap: { and: '&&', or: '||' } }
+  *   )
+  *   // Returns: { combinator: '&&', rules: [] }
+  * ```
+  */
+  combinatorMap?: Record<string, string>;
+  /**
+  * Any operator values will be translated from the key in this object to the value.
+  *
+  * @defaultValue `{}`
+  *
+  * @example
+  * ```
+  *   transformQuery(
+  *     { combinator: 'and', rules: [{ field: 'name', operator: '=', value: 'Steve Vai' }] },
+  *     { operatorMap: { '=': 'is' } }
+  *   )
+  *   // Returns:
+  *   // {
+  *   //   combinator: 'and',
+  *   //   rules: [{ field: 'name', operator: 'is', value: 'Steve Vai' }]
+  *   // }
+  * ```
+  */
+  operatorMap?: Record<string, string>;
+  /**
+  * Prevents the `path` property (see {@link index!Path Path}) from being added to each
+  * rule and group in the hierarchy.
+  *
+  * @defaultValue `false`
+  */
+  omitPath?: boolean;
+  /**
+  * Original properties remapped according to the `propertyMap` option will be removed.
+  *
+  * @defaultValue `true`
+  *
+  * @example
+  * ```
+  *   transformQuery(
+  *     { combinator: 'and', rules: [] },
+  *     { propertyMap: { combinator: 'AndOr' }, deleteRemappedProperties: false }
+  *   )
+  *   // Returns: { combinator: 'and', AndOr: 'and', rules: [] }
+  * ```
+  */
+  deleteRemappedProperties?: boolean;
+}
+/**
+* Recursively process a query heirarchy using this versatile utility function.
+*
+* [Documentation](https://react-querybuilder.js.org/docs/utils/misc#transformquery)
+*/
+declare function transformQuery(query: RuleGroupType, options?: TransformQueryOptions): any;
+/**
+* Recursively process a query heirarchy with independent combinators using this
+* versatile utility function.
+*
+* [Documentation](https://react-querybuilder.js.org/docs/utils/misc#transformquery)
+*/
+declare function transformQuery(query: RuleGroupTypeIC, options?: TransformQueryOptions<RuleGroupTypeIC>): any;
+//#endregion
+export { TransformQueryOptions, transformQuery };
+//# sourceMappingURL=transformQuery.d.ts.map

package/dist/transformQuery.js

@@ -0,0 +1,4 @@
+require('./isRuleGroup-DqAs2x4E.js');
+const require_transformQuery = require('./transformQuery-FL_nlpp5.js');
+
+exports.transformQuery = require_transformQuery.transformQuery;

package/formatQuery/package.json

@@ -0,0 +1,4 @@
+{
+  "main": "../dist/formatQuery.js",
+  "types": "../dist/formatQuery.d.ts"
+}