@react-querybuilder/material - npm Package Versions

[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

[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

[v8.1.1] - 2025-01-20

Fixed

• [#840] The behavior and list of valid values for the formatQuery option parseNumbers now aligns with the corresponding QueryBuilder prop, as long as a fields array is also provided.
• [#836] AntDValueSelector now filters on the label property and defines options with the options prop instead of a children array of <Select.OptGroup>/<Select.Option>.
• [#836] Utilities that determine whether arrays are valid option lists (isFullOptionArray, isFlexibleOptionArray, isFullOptionGroupArray, isFlexibleOptionGroupArray) are now more strict: All leaf elements must conform to the operative type, not just the first element.
• The "mssql" formatQuery preset now sets paramPrefix: '@'.

[v8.1.0] - 2025-01-09

Added

• [#820] New @react-querybuilder/datetime package with enhanced functionality for managing date/time data. Includes rule/value processors for formatQuery tailored to different database platforms and date/time libraries.
• [#820] formatQuery will assume a format of "sql" if no format is provided as long as preset matches one of the supported values.
• [#820] New formatQuery option wrapValueWith, an array of two strings to act as a prefix and suffix for values (outside of any quotes).
• [#820] formatQuery value processors now accept an optional context parameter, which can be used to pass additional information to the processor.
• [#820] New "mongodb_query" export format. This format is exactly the same as "mongodb" except it returns an actual JSON object instead of a JSON.stringifyd version. The "mongodb" format is deprecated, but will not be removed.
• [#820] Default SCSS stylesheet query-builder.scss now uses @use instead of the deprecated @import.
• [#834] React 19 support (verification only, no meaningful code changes were necessary).

[v8.0.0] - 2024-11-08

Changed

• [#805] @react-querybuilder/chakra now supports Chakra UI version 3 and no longer supports version 2. For Chakra UI version 2 support, use @react-querybuilder/chakra2.
• [#805] ChakraDragHandle has been removed. In Chakra UI version 3 environments, the default DragHandle component works without augmentation.

Added

• [#814] Debug build which registers the internal Redux store with Redux DevTools (more "debug" functionality may be added in the future). To use the debug build, update all "react-querybuilder" imports to "react-querybuilder/debug".

Fixed

• [#814] The internal Redux store is no longer registered with Redux DevTools by default.
• bootstrapClassnames no longer includes value: "form-control form-control-sm". The classes are added by BootstrapValueEditor only when necessary.
• [#812] @react-querybuilder/bulma properly indicates compatibility with Bulma v1 in its peerDependencies, and the website demo now uses Bulma v1.