@react-querybuilder/dnd - npm Package Versions

[v8.7.0] - 2025-05-13

Added

• [#891] Support for several ORM query formats:
  • New "prisma" format for Prisma ORM.
  • New "sequelize" format for Sequelize.
  • New "drizzle" format for Drizzle ORM relational queries API.
    • Can also be used for the Drizzle query builder API, which eliminates the need for the @react-querybuilder/drizzle package.

[v8.6.2] - 2025-05-12

Fixed

• [#893] ESM import errors with certain build tools when using @react-querybuilder/material.

[v8.6.1] - 2025-05-06

Fixed

• [#890] Escape forward slash in JSONata export format.
• [#890] Correct information in Drizzle package README.

[v8.6.0] - 2025-05-05

Added

• [#885] New package @react-querybuilder/drizzle with Drizzle ORM integration.
• [#885] LDAP export format.
• [#885] New formatQuery option ruleGroupProcessor enabling development of custom output formats without completely reimplementing formatQuery.
  • The rule group processors for each of the existing formats have been extracted from formatQuery and can be used independently or as fallbacks from custom processors.
• [#883] Query tools add, update, remove, move, and group can now accept a string or Path where they previously accepted only Path-type arguments. A string would represent the id property of the subject rule/group, but otherwise the functionality of each tool is the same.
• [#883] New utility methods: findID returns the rule or group with the given id property within a query hierarchy (similar to findPath), and getPathOfID returns the path of the rule or group with the given id.
• [#885] Confirmed Mantine v8 support (no changes).

Fixed

• [#885] parseSQL was translating NOT LIKE '[...]' (no leading or trailing wildcards) to operator: "=" instead of operator: "!=".
• [#885] Importing from react-querybuilder/formatQuery no longer has a dependency on react.

[v8.5.0] - 2025-04-07

Added

• [#873] New prop autoSelectValue (documentation) behaves like autoSelectField/autoSelectOperator but for the value editor when it renders a select list.
  • The translations prop object has a new property values that accepts placeholderName, placeholderLabel, and placeholderGroupLabel properties (documentation). These translatable strings set the default values and labels when autoSelectValue is set to false.
  • A corresponding placeholderValueName option was added to formatQuery, which will now ignore rules where the value matches the placeholder value as long as placeholderValueName is defined (this behavior differs from placeholderFieldName and placeholderOperatorName, which do not need to be defined).
• [#876] Miscellaneous i18n enhancements for the "natural_language" export format:
  • translations option: Map of the words "and", "or", "true", and "false" to their translated equivalents. Also covers prefix and suffix options for rule groups.
  • wordOrder option: Based on the linguistic concept of constituent word order, this option accepts all permutations of "SVO" ("SOV", "VSO", etc.) and outputs the field, operator, and value in the corresponding order (S = field, V = operator, O = value).
  • operatorMap option: Map of operators to their natural language equivalents. If the result can differ based on the valueSource, the key should map to an array where the second element represents the string to be used when valueSource is "field". The first element will be used in all other cases.
  • Date/time formatting support: The @react-querybuilder/datetime package now supports the "natural_language" format for date-type rules. Formatting can be customized by passing locales, dateFormat, or dateTimeFormat as properties of the context parameter. These options are passed to a Intl.DateTimeFormat constructor.

Fixed

• [#877] Dynamic imports of react-dnd and related packages are now obfuscated to discourage bundlers like webpack from pre-processing those imports.

[v8.4.1] - 2025-03-24

Fixed

• [#868] Using QueryBuilderDndWithoutProvider on its own now correctly implies enableDragAndDrop={true} for each descendant QueryBuilder.

[v8.4.0] - 2025-03-18

Fixed

• [#860] The idGenerator prop is respected for all operations that create new rules or groups.

Added

• [#860] @react-querybuilder/dnd now supports react-dnd-touch-backend as a drop-in replacement for react-dnd-html5-backend. If both are provided, the touch backend will be preferred when a touch device is detected.
• [#860] "Group" feature of @react-querybuilder/dnd. Pressing the <kbd>Ctrl</kbd> key while dragging a rule/group will form a new group at the target path with the target rule/group and the dragged rule/group in its rules array. Pressing the <kbd>Alt</kbd>/<kbd>⌥ Option</kbd> key at the same time will leave the rule/group in its original location and clone it for the new group.
• [#860] Modifier keys used during drag-and-drop to indicate cloning and grouping (by default <kbd>Alt</kbd>/<kbd>⌥ Option</kbd> and <kbd>Ctrl</kbd>, respectively) are now configurable on the QueryBuilderDnD component with the copyModeModifierKey and groupModeModifierKey props.
• [#860] New group query tool which creates a new group at a target path with its rules array containing the objects from a source path and the target path.

[v8.3.1] - 2025-02-27

Fixed

• [#858] The type-fest library has been (partially) vendored into react-querybuilder to avoid requiring it as a dependency.
• [#858] UseMergedContextProps renamed to UseMergedContextParams (technically a breaking change, but probably won't affect anyone).
• [#858] All Parse*Options types have been removed from the main export. They are now only available on their respective react-querybuilder/parse* exports (another technically breaking change that probably won't affect anyone).

[v8.3.0] - 2025-02-21

Added

• [#855] CSS variables, enabling customization of the default stylesheet without using SCSS.
• [#855] New option generateIDs for all parse* methods. When true, the output query object will be processed through prepareRuleGroup to add ids.

[v8.2.0] - 2025-01-28

Added

• [#845] New formatQuery option operatorProcessor. Currently only applies to "sql", "parameterized", "parameterized_named", and "natural_language" formats.
• [#846] New formatQuery option preserveValueOrder. Preserves the order of values when exporting rules with "between"/"notBetween" operators, even if the larger value comes first.

Fixed

• [#844] The formatQuery "elasticsearch" export format now includes the .value property when outputting Painless scripts.
• [#845] formatQuery handles combinator and operator values case-insensitively.
• [#846] convertQuery, convertToIC, and convertFromIC now support the "xor" combinator, as does the "natural_language" export format.