@contrail/data-grouping 1.0.53-alpha.0 → 1.1.0

package/CHANGELOG.md

@@ -7,6 +7,16 @@ Versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [1.1.0] - 2026-06-03
+
+### Added
+
+- `DataGroupingProperty.valueFilter` (`{ mode: 'include' | 'exclude'; values: string[] }`): an optional, caller-supplied rule that restricts a multi-select grouping property's frames to the filter-selected values. Applied in `buildChildDataGroups` via the new `applyGroupingValueFilter` after `getDistinctValues` — pruning the fan-out to the included values (or dropping the excluded ones), while preserving the `(empty)` bucket. No-op for separate-frame mode (`groupMultiSelectInSeparateFrame`) and for non-multi-select grouping. Keeps this package decoupled from `@contrail/filters`: the caller translates its filter criteria into the rule. (VIBE-10759)
+
+### Fixed
+
+- `(empty)` group membership now uses the same emptiness test as the distinct-value pass (extracted as `isEmptyGroupingValue`). The two previously diverged: items whose grouping value was an empty array or a whitespace-only string were dropped entirely (they created the `(empty)` frame but no item matched into it), and `false`/`0` values double-counted into `(empty)` on top of their own group. Only observable with `displayItemsWithEmptyGroupingValues = true`. (VIBE-10759)
+
 ## [1.0.50] - (initial changelog entry)
 
 - Initial changelog. Prior releases did not include a changelog.

package/lib/data-group-generator/data-group-generator.d.ts

@@ -1,6 +1,7 @@
 import { DataGroup, DataGroupStructure, DataGroupingProperty } from '../interfaces';
 import { TypePropertySortOrder } from '@contrail/types';
 export declare class DataGroupGenerator {
+    static isEmptyGroupingValue(value: any): boolean;
     static getDistinctValues(data: any, rootIndex: any, slugIndex?: any, rootAltIndex?: any, slugAltIndex?: any, groupMultiSelectInSeparateFrame?: boolean, sortOptions?: {
         sortOrder: TypePropertySortOrder;
         options: any;

package/lib/data-group-generator/data-group-generator.js

@@ -4,6 +4,15 @@ exports.DataGroupGenerator = void 0;
 const util_1 = require("@contrail/util");
 const types_1 = require("@contrail/types");
 class DataGroupGenerator {
+    static isEmptyGroupingValue(value) {
+        return ((value === undefined ||
+            value === null ||
+            value === '' ||
+            (Array.isArray(value) && value.length === 0) ||
+            (typeof value === 'string' && value.trim() === '') ||
+            (typeof value === 'number' && isNaN(value))) &&
+            value !== false);
+    }
     static getDistinctValues(data, rootIndex, slugIndex = null, rootAltIndex = null, slugAltIndex = null, groupMultiSelectInSeparateFrame = false, sortOptions = { sortOrder: types_1.TypePropertySortOrder.ASCENDING, options: null }, propertyTypeOptions = { isDate: false, isNumber: false }, displayItemsWithEmptyGroupingValues = false, displayOptionFrameWithNoData = false) {
         const sortOrder = (sortOptions === null || sortOptions === void 0 ? void 0 : sortOptions.sortOrder) || types_1.TypePropertySortOrder.ASCENDING;
         const options = (sortOptions === null || sortOptions === void 0 ? void 0 : sortOptions.options) || null;
@@ -23,13 +32,7 @@ class DataGroupGenerator {
                 }
             }
             let value = key;
-            const isEmptyValue = (value === undefined ||
-                value === null ||
-                value === '' ||
-                (Array.isArray(value) && value.length === 0) ||
-                (typeof value === 'string' && value.trim() === '') ||
-                (typeof value === 'number' && isNaN(value))) &&
-                value !== false;
+            const isEmptyValue = DataGroupGenerator.isEmptyGroupingValue(value);
             if (isEmptyValue) {
                 if (displayItemsWithEmptyGroupingValues) {
                     hasEmptyValues = true;
@@ -151,7 +154,7 @@ class DataGroupGenerator {
             const groupData = data.filter((obj) => {
                 const objVal = util_1.ObjectUtil.getBySlugs(obj, rootIndex, slugIndex) || util_1.ObjectUtil.getBySlugs(obj, rootAltIndex, slugAltIndex);
                 if (val === '(empty)') {
-                    return !objVal;
+                    return DataGroupGenerator.isEmptyGroupingValue(objVal);
                 }
                 if (propertyTypeOptions.isDate) {
                     const objDate = objVal ? new Date(objVal).toISOString().split('T')[0] : null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contrail/data-grouping",
-  "version": "1.0.53-alpha.0",
+  "version": "1.1.0",
   "description": "Utilities and interfaces for grouping data into hierarchial data structures based on properties.",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",